README

Repo user.github.io

Pubication pages html sur branche master seulement :

... à developper ...

Note

Le contenu de ce repo test est copié du guide “Biologist guide to computing” accessible sur cette page Github

Repo différent de user.github.io –> publication pages html sur branches master ou gh-pages :

création du repo test sur la page github, visible
- ici : branche master = fichiers sources
- ou là : branche gh-pages = fichiers compilés html
clonage en local : git clone https://github.com/olitur/test.git
initialisation projet sphinx-doc :
- cd .\test\
- sphinx-quickstart.exe
Edition des fichiers sources (rest/docutils)
- édition ...
- compilation en html : .\make.bat html

Ajout de l’ensemble des fichiers à git (selon directives du fichier .gitignore):
- git status
- git add -A
Versionning : git commit -m "première compilation et synchro"
Uploading : git push origin master
Création et déplacement sur une branche pour publication des pages html uniquement :
- git checkout --orphan gh-pages
- git rm -rf *
récupération des pages html de la branche master : git checkout master build/html
déplacement de tout le contenu du dossier à la racine de cette branche : mv ./build/html/* ./
nettoyage : git rm -rf build
ajout pages html à git (sur cette branche uniquement) :
- git add -A
- git commit -m "première publication pages html"
Upload : git push origin gh-pages