Échec de la construction Sphinx Error contents.rst introuvable

Question

J'ai suivi les instructions sur la lecture des docs mais j'obtiens cette erreur :

bash Erreur Sphinx : fichier maître /home/docs/checkouts/readthedocs.org/user_builds/mybinders/checkouts/latest/docs/source/contents.rst non trouvé

Avez-vous lu le fichier yaml des docs ?

Answer 1

Si vous avez votre propre conf.py il remplace le fichier Read the Doc par défaut. conf.py . Par défaut, Sphinx s'attend à ce que le document principal soit contents . Read the Docs va mettre le document principal à index à la place (ou ce que vous avez spécifié dans vos paramètres). Essayez d'ajouter ceci à votre conf.py :

master_doc = 'index'

Pour plus d'informations, consultez ce numéro : https://github.com/rtfd/readthedocs.org/issues/2569

Answer 2

J'ai eu besoin d'avoir mon conf.py à cause des extensions que j'utilise, il suffit donc d'ajouter

master_doc = 'contents'

à votre conf.py et que

renommez votre index.rst a contents.rst .

Puis, après que la construction ait été acceptée, vous ne verrez toujours rien sur ReadTheDocs, à part "This page still doesn't exists" :

https://your-project.readthedocs.io/en/latest/contents.html

Et vous y verrez vos docteurs.