Restart repo
This commit is contained in:
21
sphinx/documentation.rst
Normal file
21
sphinx/documentation.rst
Normal file
@@ -0,0 +1,21 @@
|
||||
..
|
||||
Copyright (C) 2023 Jeremie Salvi.
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.3
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
|
||||
A copy of the license is included in the section entitled "GNU
|
||||
Free Documentation License".
|
||||
|
||||
Création et organisation de la documentation
|
||||
============================================
|
||||
|
||||
L'arborescence de notre documentation se fera directement dans les fichiers index.rst via
|
||||
l'attribut ``.. toctree::``
|
||||
|
||||
Les différents attributs pour ce bloc sont documentés ici : `Directives toctree <https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html>`_
|
||||
Je vous conseille de faire un tour sur ce lien qui vous montre toutes les spécificités de ce que peut inclure sphinx dans votre documentation grace
|
||||
à la syntaxe rst.
|
||||
|
||||
J'utilise notament la directive :hidden dans mon indec pour ne pas que le bloc toctree s'affiche sur la page mais soit bien pris en compte par le menu
|
||||
|
||||
Reference in New Issue
Block a user