-
Notifications
You must be signed in to change notification settings - Fork 4
Home
This wiki offers a convenient way to quickly edit the GEMOC documentation.
If you are looking for the online version of GEMOC documentation please go on this page: http://gemoc.github.io/gemoc-studio/
There are two ways to contribute to the GEMOC documentation.
This is the easiest way to edit and and have a rough idea of the documentation content. However it is not possible to upload images.
We hope the online editor from github will soon provide the image upload function like in the markdown editor.
Editing wiki pages will trigger a job in the CI that will build the documentation and publish it as github pages here and the result is visible there.
Important : currently the github wiki rendering may not create the correct navigation links (for example the includes) , the wiki must be considered as a preview. Please remember that the real documentation is there : http://gemoc.github.io/gemoc-studio/
This is also the way to manually build the documentation if the CI is down.
That is the best way today to add images to the repository and upload them to the wiki.
In this mode, you retreive the file locally and can work offline.
-
clone the master branch from https://github.com/gemoc/gemoc-studio.wiki.git in let’s say folder wiki.
-
open Eclipse and import the project located in the wiki folder.
-
edit the asciidoc (for better productivity use http://asciidoctor.org/docs/editing-asciidoc-with-live-preview/)
-
run the pom.xml with maven.
mvn install
-
clone the gh-pages branch from repository https://github.com/gemoc/gemoc-studio.git in let’s folder documentation.
-
copy folder wiki/target/docbook/publish/en-US into folder documentation.
-
in the repository documentation execute:
git commit -am "Updated site" git push