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.
Les poires sont vertes.
Les oranges sont oranges.
Lumières¶
Le soleil est une étoile.
La Lune n’est pas une étoile.
Onglets de code¶
Function "Main" C
Function "Main" C++
Function "Main" Python
Function "Main" Java
Function "Main" Julia
Function "Main" OCaml
Function "Main" Fortran
int main(const int argc, const char **argv) {
return 0;
}
int main(const int argc, const char **argv) {
return 0;
}
def main():
return
class Main {
public static void main(String[] args) {
}
}
function main()
end
let main () =
()
;;
PROGRAM main
END PROGRAM main
Onglets groupés¶
Linux, Ligne 1
Mac OSX, Ligne 1
Windows, Ligne 1
Linux, Ligne 2
Mac OSX, Ligne 2
Windows, Ligne 2