Outils pour utilisateurs

Outils du site


issue130:tutoriel1

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
issue130:tutoriel1 [2018/02/27 14:27] auntieeissue130: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'utiliser il y a quelques années pour écrire un court livre sur le bois tourné (Wood Turning). La raison pour laquelle j'ai choisi Sphinx est sa capacité à créer différents styles en ne créant qu'un fichier config et en écrivant le texte dans reStructuredText. Voici la documentation : http://docutils.sourceforge.net/rst.html 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'utiliser il y a quelques années pour écrire un court livre sur le bois tourné (Wood Turning). La raison pour laquelle j'ai choisi Sphinx est sa capacité à créer différents styles en ne créant qu'un fichier config et en écrivant le texte dans reStructuredText. Voici la documentation : http://docutils.sourceforge.net/rst.html
  
-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'utilisez-pas de traitement de texte. Voici la disposition de base pour markup et comment installer Sphinx (d'ailleurs, Sphinx a été écrit pour réaliser la documentation de Python).+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'utilisez pas de traitement de texte. Voici la disposition de base pour markup et comment installer Sphinx (d'ailleurs, Sphinx a été écrit pour réaliser la documentation de Python).
  
 **This was copied  from the Sphinx documentation page: http://www.sphinx-doc.org/en/stable/ **This was copied  from the Sphinx documentation page: http://www.sphinx-doc.org/en/stable/
Ligne 18: Ligne 18:
 Ceci a été traduit à partir de la page de documentation de Sphinx : http://www.sphinx-doc.org/en/stable/ Ceci a été traduit à partir de la page de documentation de Sphinx : http://www.sphinx-doc.org/en/stable/
 • 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'information similaires +• Références croisées étendues : markup sémantique et liens automatiques pour les fonctions, classes, citations, termes du glossaire et éléments d'information similaires. 
-• Structure hiérarchique : définition facile de l'arborescence du document, avec des liens automatiques vers les frères, parents et enfants +• Structure hiérarchique : définition facile de l'arborescence du document, avec des liens automatiques vers les frères, parents et enfants. 
-• 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'entre elles installables depuis PyPI. • Extensions de la communauté : plus de 50 extensions dues à la contribution des utilisateurs dans un second dépôt, la plupart d'entre elles installables depuis PyPI.
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  html  latex  tex  xml doctrees  html  latex  tex  xml
  
-J'espère que tout ceci sera utile aux individus qui aiment essayer de nouvelles façons d'utiliser Ubuntu/Linux.+J'espère que tout ceci sera utile aux personnes qui aiment essayer de nouvelles façons d'utiliser Ubuntu/Linux.
  
issue130/tutoriel1.1519738038.txt.gz · Dernière modification : 2018/02/27 14:27 de auntiee