Essai de l’extension Sphinx Sphinx-Tabs

Avertissement

Javascript est requis !

Cette page embarque des scripts écrits en javascript. À priori, cela devrait fonctionner sur n’importe quel navigateur assez récent, pour peu qu’il supporte javascript (et que javascript ne soit pas désactivé).

Cette page montre un exemple de l’utilisation de l”extension Sphinx, sphinx-tabs, conçue pour inclure facilement des mini onglets dans une page web générée avec Sphinx.

Détails

Des mini onglets ? C’est quoi ? Regardez les exemples ci-dessous, ainsi que ceux du projet Semantic UI et sa documentation.

Comme l’installer? Avec pip c’est facile :

$ pip install sphinx-tabs

Comment s’en servir et et le configurer ? Pour le configurer, il suffit d’ajouter une ligne à votre fichier de configuration de Sphinx, conf.py (voir ici un exemple pour mon fichier conf.py, changé par :bbchangeset:`0740414aa24c`) :

extensions.append('sphinx_tabs.tabs')

Ensuite, dans un fichier reStructuredText, ajoutez quelque chose comme ça :

.. tabs::

   .. tab:: Pommes

      Les pommes sont vertes, des fois rouges.

   .. tab:: Poires

      Les poires sont vertes.

   .. tab:: Oranges

      Les oranges sont oranges.

Fruits

Les pommes sont vertes, des fois rouges.

Lumières

Le soleil est une étoile.

Onglets de code

Function "Main" C
int main(const int argc, const char **argv) {
  return 0;
}

Onglets groupés

Linux, Ligne 1

Linux, Ligne 2