[PYTHON] Die Geschichte des Debuggens in der lokalen Umgebung, weil die Kompilierung mit Read the Docs nicht funktioniert hat

tl;dr

Problem

Was ich getan habe

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.)

Recommended Posts

Die Geschichte des Debuggens in der lokalen Umgebung, weil die Kompilierung mit Read the Docs nicht funktioniert hat
Die Geschichte, dass yapf nicht mit vscode funktioniert hat
Die Geschichte, dass sendmail, die im Terminal ausgeführt werden kann, mit cron nicht funktioniert hat
Die Geschichte, dass das Ersetzen der zweidimensionalen Liste in Python nicht funktioniert hat
Ich war in Schwierigkeiten, weil sich das Verhalten des Docker-Containers nicht geändert hat
Die Geschichte des Aufbaus der schnellsten Linux-Umgebung der Welt
Die Geschichte des Teilens der Pyenv-Umgebung mit mehreren Benutzern
Das Bild wird in der lokalen Entwicklungsumgebung angezeigt, aber das Bild wird nicht auf dem Remote-Server von VPS angezeigt.
[Python] Tensorflow 2.0 unterstützte Python 3.8 nicht, daher die Geschichte des Downgrades von Python
Nach dem Erstellen und Anwenden einer virtuellen Umgebung von python3.8.0 funktionierte die Code-Vervollständigung mit vscode nicht
Die Geschichte, dass man mit Pycharm kein Pygame spielen kann
Die Geschichte der Release-Arbeit der Anwendung, die Google nicht erzählt
Die Geschichte der Ausgabe des Planetarium-Meisters im PDF-Format mit Pycairo
Die Geschichte der Teilnahme an AtCoder
Die Geschichte des "Lochs" in der Akte
Ergebnisse, die bei der Suche mit diesem Wort nicht erfasst wurden
Die Geschichte eines Parksensors in 10 Minuten mit dem GrovePi + Starter Kit
Die Geschichte der Verwendung von mysqlclient, da PyMySQL nicht mit Django 2.2 verwendet werden kann
Die Geschichte eines Fehlers in PyOCR
Ich habe Pygame mit Python 3.5.1 in der Umgebung von pyenv unter OS X installiert
Patch, wenn die Volltextsuche in der lokalen GAE / Python-Umgebung nicht funktioniert
Die Geschichte des tiefen Lernens mit TPU
Hinweis: Bereiten Sie die Umgebung von CmdStanPy mit Docker vor
Bereiten Sie die Ausführungsumgebung von Python3 mit Docker vor
Lesen Sie die Ausgabe von subprocess.Popen in Echtzeit
Die Geschichte, das optimale n in N Faust zu finden
Die Geschichte des Lesens von HSPICE-Daten in Python
Arbeiten Sie in einer virtuellen Umgebung mit Python virtualenv.
Die Geschichte der Anzeige von Mediendateien in Django
Die Geschichte, die zur Installation von Pip passt
Ich kann Chrome nicht mit Selen öffnen, da die Chrome-Treiberversion nicht übereinstimmt