何日もの間、ReadTheDocsビルドが失敗していて、その理由がわかりません。
エラーは私には意味がありません。 どのドキュメントが悪いのか、その理由も教えてくれません。
過去数週間で変わったことは、GitHubに直接統合された方法でマークダウンエディターを使用していることです。 そして、私はrepl.itレシピiframeをクックブックに追加しています。 readmeにはまだ何もないと思います。
ここにある現在機能しているクックブックで稼働しているため、iframeではないと思います。
http://cookbook.PySimpleGUI.org
Readmeはここにあります:
http://www.PySimpleGUI.org
どんな助けでも大歓迎です!!!
ビルドの例を次に示します。
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
こんにちは@MikeTheWatchGuy 、私はあなたが得ているエラーがmkdocsの問題に関連していると確信していますhttps://github.com/mkdocs/mkdocs/pull/1518
mkdocsのアップデートで問題が解決したようですバージョン0.17.5
エラーが発生し続けます。 それでも、readmeをreadthedocsで正しくビルドすることができません。 私の料理本はうまくいきます。
どうすればこの問題を解決できますか? 私はmkdocsを実行していません。 それを行うのはreadthedocsだと思います。
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)
今、私はそのバージョン番号を変更する方法を見つける必要があるかもしれないように見えます
私は今、後退しています。
マークダウンドキュメントを使用している場合、readthedocsは完全に溶けてしまったようです。 スフィンクスを使用している場合、明らかに問題はありません。
私は、Python 3.7にアップグレードしたreadthedocsの人々に本当に失望しており、その結果、私のドキュメントが混乱したままになっているエラーが発生しています。
それは公平ではありません!
くそー、私はこれらのドキュメントの作業に十分な時間を費やしており、作成した新しいドキュメントをアップロードできるようになってから2か月が経ちました。
これを修正するには誰かを雇う必要があります。
ここの誰かがこのたわごとを修正するためにいくらかのお金を稼ぎたいですか?
そうでなければ、私は助けを求めてfiverrに行くと思います。
@MikeTheWatchGuy私はこれで本当にあなたを助けますが、残念ながら私は仕事と家族のために本当に忙しいです。 しかし、私には考えがあります。 ドキュメントをローカルでビルドして、プロジェクトリポジトリに直接アップロードすることは可能でしょうか? つまり、readthedocsを削除します。
ああ、私はあなたの状況を理解していますダビデ.....私を助けることについて心配しないでください。 あなたは十分にやりました。
readthedocsの人々にバグを報告しましたが、応答はあまり役に立ちませんでした。
要件ファイルを使用してmkdocsの新しいバージョンに更新するか、Pythonバージョンをダウングレードできます。 構成ファイルhttps://docs.readthedocs.io/en/stable/config-file/v2.htmlを使用して両方のことを行うことができ
#5332の複製として閉じる
このymlファイルを作成して変更するのに1時間費やしました。
私が戻って求めたのは、彼らのバグを修正する提供されるファイルです。
現時点でひどいのは、ちょうど今日、子供たちの教室がクラスでPySimpleGUIを使い始め、今ではすべてのPySimpleGUIドキュメントがなくなってしまったことです。 http://www.PySimpleGUI.orgはもうありません。 これはすべて、readthedocsコードのバグが原因です。 正直言ってちょっと腹が立つ。
マークダウンドキュメントをreadthedocsのようなものに変換する別のツールを使用して、ドキュメントのバージョンをビルドしてアップロードしました。 そのツールの説明は、GitHubを含め、どこでもhtmlを「ホスト」できるというものでした。
そこで、ここでドキュメントを作成してアップロードしました。
https://github.com/PySimpleGUI/PySimpleGUI/tree/master/docs_html
ユーザーがそこにアクセスしてファイルをWebサイトとして表示できるように、これらのファイルを何らかの方法で「ホスト」する方法がわかりません。
@stsewdに接続すると、問題は解決しました。
彼は本当に私がこのプロセスを進めるのを手伝ってくれました。 ここで私の試練について読むことができ
これで、最終的に問題の1つに対処したときに、PySimpleGUIユーザーがどのように感じるかについて少しよくわかりました。 修正を待っていたすべての人に謝罪します。 私はこれらのドキュメントを取り戻すことに100%集中してきました!
最も参考になるコメント
@stsewdに接続すると、問題は解決しました。
彼は本当に私がこのプロセスを進めるのを手伝ってくれました。 ここで私の試練について読むことができ
これで、最終的に問題の1つに対処したときに、PySimpleGUIユーザーがどのように感じるかについて少しよくわかりました。 修正を待っていたすべての人に謝罪します。 私はこれらのドキュメントを取り戻すことに100%集中してきました!