Je suis nouveau utilisant sphinx pour documenter mon travail, je veux ajouter la version numérique et publier dans ma documentation en pdfPourquoi la substitution | version | ne fonctionne pas sur sphinx
Dans le fichier conf.py, une variable de version est définie que nous peut utiliser dans les fichiers .rst comme tels:
| version |
Mais ce ne fonctionne pas pour moi, je ne sais pas si je fais quelque chose de mal Des suggestions?
Pour utiliser une substitution, vous devez avoir défini dans le fichier au format:
.. |Version| replace:: 1.0
utiliser ensuite dans le texte:
"Latest version is |Version|"
I comprennent généralement toutes les substitutions d'un seul fichier qui est ensuite inclus dans chaque fichier dans le projet avec la directive:
.. include:: substitutions-file-name
La substitution '| version |' (v minuscule) est définie par défaut. Il n'a pas besoin d'être défini par l'utilisateur. Voir http://www.sphinx-doc.org/fr/stable/markup/inline.html#substitutions. – mzjn
@mzjn J'ai lu cette partie et c'est comme ça que je l'utilise mais ça ne marche pas, je vérifie le fichier conf.py et je ne trouve aucune erreur –
@mzjn J'ai cette erreur: (ERROR/3) Substitution non définie référencé: "version". –
Comment fonctionne rst2pdf? Pour que rst2pdf reconnaisse la substitution '| version |' définie par Sphinx (ou quelque chose dans conf.py), vous devez configurer les choses comme décrit ici: http://rst2pdf.ralsina.me/handbook.html#sphinx. – mzjn
Pour lancer rst2pdf, utilisez rst2pdf index2.rst -o index.pdf -s styles/ictc.style --custom-cover = couverture/ictc.tmpl -e /home/jmandujano/public_html/test2/extensions/blank_toc.py -b 1 –
L'extension rst2pdf.pdfbuilder où puis-je le trouver? –