Sphinx

Ce site a été généré grâce l’outil Sphinx.

Note

Pour voir la magie, cliquez le lien “Show Source” (dans la colonne de gauche), vous verrez ainsi ce qui a été tapé par l’auteur de la page. Puis, revenez sur la page web et faites un clic droit dans une zone vide et choississez dans le menu contextuel “…code-source…”, vous verrez ainsi ce que l’outil a généré à la place de l’auteur.

Bref, vous vous concentrez sur le texte et l’outil s’occupe du reste (et notamment de la partie gauche ainsi que le haut et le bas de page).

Ce que vous tapez se trouvera donc dans la partie centrale de la page.

Si vous regardez attentivement la “Source”, vous verrez :

  • que ce qui est souligné par une série de (=) devient un titre

  • que ce qui est souligné par une série de (-) devient un sous-titre

  • que ce qui entre deux astérisques est mis en gras

  • qu’une ligne qui débute par un astérique est un élément d’une liste

  • qu’une ligne qui débute par deux points suivis d’un espace suivi d’un mot clé suivi de deux doubles points est une zone spéciale (telle qu’une note, un ensemble de liens vers d’autres pages)

Remarquez aussi qu’il est particulièrement simple de créer un lien vers une autre page du site. Il suffit de taper son nom (dans le bloc de la directive toctree)