compilazione di sphinx separata e directory di origine per il controllo della versione

Question

Ho una directory di lavoro che contiene il mio progetto e si trova in un sistema di controllo della versione. Mi piacerebbe creare una directory doc all'interno del mio progetto che contenga solo file di testo ristrutturato per sphinx.

Cioè, non voglio sphinx creare file html all'interno del mio progetto, ma metterli all'esterno in modo che non vengano messi nel controllo di versione.

Answer 1

Quindi, se si domanda è: 'Come posso costruire la documentazione al di fuori della struttura di origine', il documentation aiuta:

sphinx-build -b html sourcedir builddir 

Proprio punto builddir in una posizione al di fuori del vostro albero dei sorgenti.

Oppure, a seconda del sistema di controllo di versione, aggiungere la directory si genera la documentazione in un 'file di ignorare' (ad esempio .gitignore, .hgignore, ...)