sphinx pour plusieurs documents séparés

Question

Je suis un nouveau venu chez Sphinx, documentant mon projet sur un serveur. Maintenant, une collègue voit ce que j'ai fait et elle veut faire la même chose - documenter son projet sur le même serveur.

Les projets ne sont pas liés (ils n'appartiennent pas à un seul TOCtree) et je ne sais pas comment l'aider. Puis-je configurer sphinx pour construire des arbres de documents séparés? Est-ce aussi simple que de faire deux copies du Makefile et d'avoir des répertoires source/build différents?

grâce, --Tim

Answer 1

Oui, je pense que vous voulez les traiter comme des projets distincts. Pour cela, vous devez juste copier l'arbre de construction actuel comme indiqué et éditer le fichier config.py. Les autres options sont simplement de commencer à partir de zéro en exécutant sphinx-quickstart.

De plus, gardez à l'esprit que vous pouvez référencer des sujets entre les deux documents en utilisant le Intersphinx plugin.