tl;dr
Wie in der offiziellen Dokumentation (http://docs.readthedocs.io/en/latest/builds.html) angegeben, veröffentlicht RTD seine Anweisungen zum Erstellen der Dokumentation vollständig. Darüber hinaus wird auch das Docker-Image der zum Erstellen verwendeten Umgebung freigegeben, sodass es einfach ist, eine entsprechende Umgebung zu erstellen und zu debuggen. ..
Ziehen Sie zunächst das Docker-Image und starten Sie es in einer interaktiven Shell.
docker run -it readthedocs/build:latest /bin/bash
Übrigens war zum Zeitpunkt des Schreibens dieses Artikels der Tag "2.0" "aktuell".
Führen Sie als Nächstes den Befehl basierend auf dem Erstellungsprotokoll des Verwaltungsbildschirms aus. Normalerweise können Sie die offizielle Erstellungsmethode aus Python lesen. Da dies jedoch problematisch ist, führen Sie sie aus, während Sie den Zeilenabstand entsprechend dem Verzeichnisnamen usw. ausfüllen.
export READTHEDOCS=1 #Ergänzungen
mkdir -p /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs #Ergänzungen
git checkout https://github.com/koreyou/word_embedding_loader.git /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest
cd /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest #Ergänzungen
python2.7 -mvirtualenv --no-site-packages --no-download /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest
source /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest/bin/activate #Ergänzungen
python /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest/bin/pip install --use-wheel -U --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/.cache/pip sphinx==1.5.3 Pygments==2.2.0 setuptools==28.8.0 docutils==0.13.1 mkdocs==0.15.0 mock==1.0.1 pillow==2.6.1 readthedocs-sphinx-ext\<0.6 sphinx-rtd-theme\<0.3 alabaster\>=0.7,\<0.8,!=0.7.5 commonmark==0.5.4 recommonmark==0.4.0
# requirements.Da der Pfad von txt nicht selbst angegeben ist, gelten Anforderungen als Vorverarbeitung.Es scheint, dass sie nach dem Ort von txt suchen
python /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest/bin/pip install --exists-action=w --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/.cache/pip -r/home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/checkouts/latest/requirements.txt
python setup.py install --force
#ursprünglich-b Es war readthedocs, aber es funktioniert nicht, also habe ich es in das Standard-HTML geändert
python /home/docs/checkouts/readthedocs.org/user_builds/word-embedding-loader/envs/latest/bin/sphinx-build -T -b html -d _build/doctrees-readthedocs -D language=en . _build/html
Danach debuggen Sie in der Prozedur, in der das Problem aufgetreten ist, mit python -m pdb
.
Die Ursache war übrigens weil ich meinem PFAD ein zusätzliches Element hinzugefügt habe. (RTD führt python setup.py install
durch, sodass Sie das Paketverzeichnis Ihres Projekts nicht zu Ihrem PATH hinzufügen müssen.)