Signed-off-by: Benoit Mortier <benoit.mortier@opensides.be>

gitlab-base/gitlab-sphinx.md

+## Migration du wiki gitlab à sphinx
+
+### Installer les paquets nécessaire
+
+Il faut installer les paquets suivants :
+
+*    python-sphynx
+*    python-sphinx-rtd-theme
+*    texlive
+*    texlive-latex-extra
+*    texlive-latex-recommanded
+
+### Préparation des dossiers
+
+*    On clone repo du projet
+*    On créer le dossier docs/sphinx et on s'y déplace
+*    On clone le repo wiki dans vers ./wiki
+
+### Préparation de sphinx
+
+```bash
+# Répondre au différente question et laissé par défaut en général
+# Sauf pour la demande d'un dossier source séparé et d'ajouter le epub builder
+sphynx-quickstart
+```
+
+### Conversion
+
+On lance le script gitlabWikiToSphynx.sh
+
+### Finalisation
+
+Ensuite on peut convertir en html ou en pdf. Les fichiers seront dans ./build/
+
+```bash
+# Clean
+make clean
+# HTML
+make html
+# PDF
+make latexpdf
+```
+
+Pour finir on commit le contenu de docs/sphinx dans le répo du projet.
+
+### Formatage du wiki
+
+Pour que le script fonctionne le formatage doit être le suivant
+
+Pour la 1ère page on a par exemple ceci
+
+```
+# Documentation
+
+[OpenLDAP](openldap)
+```
+
+Ensuite sur la page openldap on aura ceci
+
+```
+## OpenLDAP
+
+[Installation des serveurs](openldap/server)
+```
+
+Et ensuite pour la page server on a ceci. Il ne vaut mieux ne pas dépassé 3 niveaux
+
+```
+### Installation du serveur
+
+XXX
+
+#### Installation des paquets
+
+XXX
+
+#### Insertion des LDIFs
+
+XXX
+```
+
+On remarque que sur la page qu'on edit, il faut toujours avoir une dièse avec le titre.
+
+A chaque nouvelle page on incrémente le niveau.
+
+Si on veut avoir différent points sur une même page on incrémente les dièses mais sur la même page (par exemple la page server)
\ No newline at end of file