issue130:tutoriel1
Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédente | |||
issue130:tutoriel1 [2018/02/27 14:27] – auntiee | issue130:tutoriel1 [2018/03/01 16:20] (Version actuelle) – andre_domenech | ||
---|---|---|---|
Ligne 5: | Ligne 5: | ||
Sphinx est une excellente application de mise en page de document : il peut créer du html, du latex, des pdf et plus encore. J'ai commencé à l' | Sphinx est une excellente application de mise en page de document : il peut créer du html, du latex, des pdf et plus encore. J'ai commencé à l' | ||
- | Si vous n'avez pas utilisé markup, vous manquez quelque chose. Essayez-le. Tout ce dont vous avez besoin est un éditeur tel que vim/gvim ou ??? - à votre choix - n' | + | Si vous n'avez pas utilisé markup, vous manquez quelque chose. Essayez-le. Tout ce dont vous avez besoin est un éditeur tel que vim/gvim ou ??? - à votre choix - n' |
**This was copied | **This was copied | ||
Ligne 18: | Ligne 18: | ||
Ceci a été traduit à partir de la page de documentation de Sphinx : http:// | Ceci a été traduit à partir de la page de documentation de Sphinx : http:// | ||
• Formats de sortie : HTML ( y compris l'aide HTML de Windows), LaTeX (pour les versions imprimables en PDF), ePub, Texinfo, pages de manuel, texte brut. | • Formats de sortie : HTML ( y compris l'aide HTML de Windows), LaTeX (pour les versions imprimables en PDF), ePub, Texinfo, pages de manuel, texte brut. | ||
- | • Références croisées étendues : markup sémantique et liens automatiques pour les fonctions, classes, citations, termes du glossaire et éléments d' | + | • Références croisées étendues : markup sémantique et liens automatiques pour les fonctions, classes, citations, termes du glossaire et éléments d' |
- | • Structure hiérarchique : définition facile de l' | + | • Structure hiérarchique : définition facile de l' |
- | • Indices automatiques : un index général tout comme des index pour les modules spécifiques à un langage | + | • Indices automatiques : un index général tout comme des index pour les modules spécifiques à un langage. |
- | • Gestion du code : surlignage automatique utilisant le surligneur Pygments | + | • Gestion du code : surlignage automatique utilisant le surligneur Pygments. |
• Extensions : test automatique de segments du code, inclusion de docstrings à partir de modules en Python (API docs) et | • Extensions : test automatique de segments du code, inclusion de docstrings à partir de modules en Python (API docs) et | ||
• Extensions de la communauté : plus de 50 extensions dues à la contribution des utilisateurs dans un second dépôt, la plupart d' | • Extensions de la communauté : plus de 50 extensions dues à la contribution des utilisateurs dans un second dépôt, la plupart d' | ||
Ligne 50: | Ligne 50: | ||
sudo apt install python-pip | sudo apt install python-pip | ||
- | Installez Sphinx, soit depuis le paquet de la distribution soit par PyPi | + | Installez Sphinx, soit depuis le paquet de la distribution soit par PyPi : |
$ pip install Sphinx | $ pip install Sphinx | ||
Ligne 64: | Ligne 64: | ||
$ sphinx-quickstart | $ sphinx-quickstart | ||
- | Après avoir fini ceci, vous aurez un fichier index.rst qui ressemblera à ceci et vous aurez un fichier conf.py créé à partir des réponses aux questions de quickstart. | + | Après avoir fini ceci, vous aurez un fichier index.rst qui ressemblera à ceci et vous aurez un fichier conf.py créé à partir des réponses aux questions de quickstart |
** | ** | ||
Ligne 99: | Ligne 99: | ||
doctrees | doctrees | ||
- | J' | + | J' |
issue130/tutoriel1.1519738038.txt.gz · Dernière modification : 2018/02/27 14:27 de auntiee