Auto-generation of online documentation for my open libraries

Basile B. b2.temp at gmx.com
Sun Feb 23 18:07:05 UTC 2020


On Sunday, 23 February 2020 at 17:14:33 UTC, Per Nordlöw wrote:
> I would like to setup auto-generation of online documentation 
> for my public D libraries residing on Github and Gitlab.
>
> What alternatives do I have?

for gitlab they have a system of pages that's quite easy to setup:

something like

.gitlab-ci.yml
---
#to get dmd and dub
image: dlang2/dmd-ubuntu

#special section to generate gitlab "pages"
pages:
   before_script:
   - apt-get install -y <some software...>
   - <more commands to download a doc generator for ex...>
   script:
   - <command to generate the doc in "public" subfolder>
   artifacts:
     paths:
     - public
   only:
   - master
   - <other branch...>
---

and then your doc is online and updated for each push.
It can be downloaded from the artifacts too, maybe in an 
automated way I think, but havent used this for now so cant say.


More information about the Digitalmars-d-learn mailing list