From e9e18e9c6312c8b9449de7e3fb1280036661575a Mon Sep 17 00:00:00 2001 From: Fredrik Bagge Carlson <cont-frb@ulund.org> Date: Fri, 19 Jan 2018 09:39:44 +0100 Subject: [PATCH] Update README.md --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/README.md b/README.md index 167743f..2aca568 100644 --- a/README.md +++ b/README.md @@ -3,3 +3,38 @@ # LabProcesses Documentation available at [Documentation](http://processes.gitlab.control.lth.se/documentation/labprocesses/) + + +# Automatiskt genererad dokumentation +Det finns i skrivande stund två stycken mer eller mindre automatgenererade hemsidor med dokumentation, en sida till repot BallAndBeam.jl + http://processes.gitlab.control.lth.se/documentation/ballandbeam/ + +och en sida till (detta) repot LabProcesses.jl + http://processes.gitlab.control.lth.se/documentation/labprocesses + +Mitt förslag är att alla som känner sig ansvariga för ett repo som är skapat med syfte att till slut överlämnas till framtida kollegor sätter upp liknande +dokumentation för detta repo. + +## Generera dokumentation +Jag har byggt dokumentationen med [Documenter.jl](https://github.com/JuliaDocs/Documenter.jl). Detta verktyg accepterar en markdown-fil (docs/src/index.md) +med lite text man skrivit samt macron som indikerar att man vill infoga docstrings från funktioner och typer i sitt juliapaket. +Outputen är en html-sida med tillbehör som man ska se till att hosta på gitlab pages. + +Exempel på hur detta går till finns i repona LabProcesses.jl och BallAndBeam.jl. Man kan helt sonika kopiera docs/-mappen från ett av dessa repon och +modifiera innehållet i alla filer så att det stämmer med ens nya repo. + +## Hosting +För hosting finns repot +https://gitlab.control.lth.se/processes/documentation/ +Det man behöver göra är att editera filen +https://gitlab.control.lth.se/processes/documentation/blob/master/.gitlab-ci.yml +och lägga till tre rader som + +- Bygger dokumentationen i repot man vill dokumentera +- skapar en ny mapp med ett väl valt namn (myfoldername i exemplet nedan) +- flyttar den byggda dokumentationen till den mappen +- Det blir lätt att förstå hur man gör punkterna ovan när man kollar i filen .gitlab-ci.yml, bara kör mönstermatchning mot de repona som detta redan är gjort för. + +När .gitlab-ci.yml uppdateras i master triggas en pipline. Om denna lyckas kommer dokumentationen finnas under + +http://processes.gitlab.control.lth.se/documentation/myfoldername/ \ No newline at end of file -- GitLab