Pysimplegui: Doc-Builds schlagen fehl!! BRAUCHEN SIE HILFE!!

Erstellt am 18. Feb. 2019  ·  6Kommentare  ·  Quelle: PySimpleGUI/PySimpleGUI

Seit einigen Tagen schlagen die ReadTheDocs-Builds fehl und ich weiß nicht warum.

Die Fehler machen für mich keinen Sinn. Sie sagen mir nicht, welches der Dokumente schlecht ist und warum.

Die Dinge, die sich in den letzten Wochen geändert haben, waren, dass ich meinen Markdown-Editor so verwende, dass er direkt in GitHub integriert ist. Und ich habe dem Kochbuch repl.it-Rezept-Iframes hinzugefügt. Ich glaube, die Readme hat noch keine.

Ich glaube nicht, dass es an den iframes liegt, weil sie im aktuellen Arbeitskochbuch hier installiert sind
http://cookbook.PySimpleGUI.org

Readme ist hier:
http://www.PySimpleGUI.org

Jede Hilfe wäre sehr dankbar!!!

Hier ist ein Beispiel-Build:
https://readthedocs.org/projects/pysimplegui/builds/8589243/

Build #8589243
latest (1eb3c26878e321867fb1dc28d94353d2087fed3f)
Build failed
git clone --no-single-branch --depth 50 https://github.com/PySimpleGUI/PySimpleGUI .
git checkout --force origin/master
git clean -d -f -f
python3.7 -mvirtualenv --no-site-packages --no-download /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest
/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/bin/python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/.cache/pip pip
/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/bin/python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/.cache/pip Pygments==2.2.0 setuptools<40 docutils==0.13.1 mock==1.0.1 pillow==2.6.1 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.5.4 recommonmark==0.4.0 mkdocs==0.17.3
cat mkdocs.yml
python /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/bin/mkdocs build --clean --site-dir _build/html --config-file /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/checkouts/latest/mkdocs.yml
INFO    -  Cleaning site directory 
INFO    -  Building documentation to directory: /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/checkouts/latest/_build/html 
Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/nav.py", line 337, in _follow
    raise StopIteration
StopIteration

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/bin/mkdocs", line 10, in <module>
    sys.exit(cli())
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/click/core.py", line 764, in __call__
    return self.main(*args, **kwargs)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/click/core.py", line 717, in main
    rv = self.invoke(ctx)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/click/core.py", line 1137, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/click/core.py", line 956, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/click/core.py", line 555, in invoke
    return callback(*args, **kwargs)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/__main__.py", line 156, in build_command
    ), dirty=not clean)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/commands/build.py", line 282, in build
    build_pages(config, dirty=dirty)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/commands/build.py", line 213, in build_pages
    site_navigation = nav.SiteNavigation(config)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/nav.py", line 44, in __init__
    config, self.url_context)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages/mkdocs/nav.py", line 392, in _generate_site_navigation
    config_line, url_context, config):
RuntimeError: generator raised StopIteration

Done - Download from GitHub URGENT community input desired help wanted

Hilfreichster Kommentar

Nachdem ich mich mit @stsewd verbunden hatte, wurde das Problem gelöst!

Er hat wirklich alles getan, um mir bei diesem Prozess zu helfen. Sie können über meine Qual lesen hier

Jetzt weiß ich etwas besser, wie sich die PySimpleGUI-Benutzer fühlen, wenn ich endlich eines ihrer Probleme anspreche. Ich entschuldige mich bei allen, die auf Fixes gewartet haben. Ich habe mich zu 100% darauf konzentriert, diese Dokumente zurückzubekommen!

Alle 6 Kommentare

Hallo @MikeTheWatchGuy , ich bin mir ziemlich sicher, dass der Fehler, den Sie erhalten, mit einem mkdocs-Problem zusammenhängt https://github.com/mkdocs/mkdocs/pull/1518
Es scheint, dass ein mkdocs-Update das Problem löst Version 0.17.5

Ich bekomme weiterhin Fehler. Ich kann meine Readme-Datei immer noch nicht richtig von readthedocs erstellen. Mein Kochbuch funktioniert gut.

Wie kann ich dieses Problem lösen? Ich führe keine mkdocs aus. Ich denke, das macht Readthedocs.

Ich sehe in den Build-Notizen von readthedocs:
Requirement already up-to-date: mkdocs==0.17.3 in /home/docs/checkouts/readthedocs.org/user_builds/pysimplegui/envs/latest/lib/python3.7/site-packages (0.17.3)
Jetzt sieht es so aus, als müsste ich einen Weg finden, diese Versionsnummer zu ändern

HHHHEEELLLLPPPP!!!!

Ich gehe jetzt rückwärts.

Es scheint, dass readthedocs jetzt vollständig zusammenbricht, wenn Sie die Markdown-Dokumentation verwenden. Bei Verwendung von Sphinx offensichtlich keine Probleme.

Ich bin WIRKLICH enttäuscht von den readthedocs-Leuten, die auf Python 3.7 aktualisiert haben und als Ergebnis Fehler eingeführt haben, die meine Dokumentation in Trümmern hinterlassen haben.

Das ist nicht fair!

Verdammt, ich verbringe genug Zeit damit, an diesen Dokumenten zu arbeiten, und jetzt ist es 2 Monate her, dass ich neue Dokumente hochladen konnte, die ich erstellt habe.

Ich muss jemanden einstellen, der das repariert.

Will hier irgendjemand etwas Geld damit verdienen, diesen Scheiß zu reparieren?

Wenn nicht, gehe ich wohl zu Fiverr, um Hilfe zu holen.

@MikeTheWatchGuy Ich würde dir wirklich dabei helfen, aber leider bin ich sehr beschäftigt mit Beruf und Familie. Allerdings habe ich eine Idee. Wäre es möglich, die Dokumente lokal zu erstellen und direkt in das Projekt-Repository hochzuladen? Readthedocs entfernen, meine ich.

Oh, ich verstehe Ihre Situation, Davide..... machen Sie sich keine Sorgen, mir zu helfen. Du hast genug getan.

Ich habe einen Fehler bei den Readthedocs-Leuten eingereicht, aber die Antwort hat mir nicht viel geholfen.

Sie können mit einer Anforderungsdatei auf eine neue Version von mkdocs aktualisieren oder die Python-Version herunterstufen. Sie können beides mit einer Konfigurationsdatei tun https://docs.readthedocs.io/en/stable/config-file/v2.html

Schließen als Duplikat von #5332

Ich habe eine Stunde damit verbracht, diese Yml-Datei zu erstellen und zu ändern.

Was ich zurückgegangen bin und um eine Datei gebeten habe, die IHREN BUG behebt.

Was im Moment schrecklich ist, ist, dass ein Klassenzimmer mit Kindern NUR HEUTE angefangen hat, PySimpleGUI in ihrer Klasse zu verwenden, und jetzt sind ALLE PySimpleGUI-Dokumente tot und weg. http://www.PySimpleGUI.org gibt es nicht mehr. Alles wegen eines Fehlers im readthedocs-Code. Es nervt mich ein bisschen, um ehrlich zu sein.

Ich habe eine Version der Dokumente mit einem anderen Tool erstellt und hochgeladen, das meine Markdown-Dokumente in etwas umgewandelt hat, das wie readthedocs aussieht. Die Anweisungen für dieses Tool lauteten, dass ich den HTML-Code überall "hosten" konnte, einschließlich auf GitHub.

Also habe ich meine Dokumente hier erstellt und hochgeladen:
https://github.com/PySimpleGUI/PySimpleGUI/tree/master/docs_html

Ich weiß nicht, wie ich diese Dateien irgendwie "hosten" kann, damit Benutzer sie dort besuchen können und sie die Dateien als Website sehen.

Nachdem ich mich mit @stsewd verbunden hatte, wurde das Problem gelöst!

Er hat wirklich alles getan, um mir bei diesem Prozess zu helfen. Sie können über meine Qual lesen hier

Jetzt weiß ich etwas besser, wie sich die PySimpleGUI-Benutzer fühlen, wenn ich endlich eines ihrer Probleme anspreche. Ich entschuldige mich bei allen, die auf Fixes gewartet haben. Ich habe mich zu 100% darauf konzentriert, diese Dokumente zurückzubekommen!

War diese Seite hilfreich?
0 / 5 - 0 Bewertungen