几天来,ReadTheDocs 构建失败,我不知道为什么。
这些错误对我来说毫无意义。 他们没有告诉我哪个文档不好,也不告诉我为什么。
过去几周发生的变化是,我正在以直接集成到 GitHub 中的方式使用我的 Markdown 编辑器。 我一直在将 repl.it recipe iframe 添加到 Cookbook 中。 我认为自述文件还没有。
我不认为这是 iframe,因为它们已在当前工作的 Cookbook 中启动并运行,位于此处
http://cookbook.PySimpleGUI.org
自述文件在这里:
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 版
我继续收到错误。 仍然无法通过 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)
现在看起来我可能需要找到一种方法来更改该版本号
我现在要倒退了。
如果您使用 Markdown 文档,现在 readthedocs 似乎完全崩溃了。 如果使用sphinx,显然没有问题。
我对 readthedocs 人员升级到 Python 3.7 感到非常失望,结果引入了错误,使我的文档变得一团糟。
这不公平!
该死,我花了足够多的时间处理这些文档,现在已经有 2 个月了,我已经能够上传我制作的新文档了。
我将不得不雇人来解决这个问题。
这里有人想赚钱修理这个狗屎吗?
如果没有,我想我要去 Fiverr 寻求帮助。
@MikeTheWatchGuy我真的会在这方面帮助你,但不幸的是我真的很忙于工作和家庭。 不过我有一个想法。 是否可以在本地构建文档并将它们直接上传到项目存储库中? 删除 readthedocs 我的意思是。
哦,我了解你的情况 Davide..... 别担心帮我。 你已经做得够多了。
我向 readthedocs 人员提交了一个错误,但回复对我没有多大帮助。
您可以使用需求文件或降级 python 版本更新到新版本的 mkdocs。 您可以使用配置文件https://docs.readthedocs.io/en/stable/config-file/v2.html完成这两件事
关闭重复 #5332
我花了一个小时试图创建和修改这个 yml 文件。
我回去并要求提供一个文件来修复他们的错误。
目前可怕的是,一群孩子就在今天开始在他们的班级中使用 PySimpleGUI,现在所有的 PySimpleGUI 文档都消失了。 http://www.PySimpleGUI.org已不复存在。 都是因为 readthedocs 代码中的一个错误。 老实说这有点让我生气。
我确实使用另一个工具构建并上传了一个版本的文档,该工具将我的 Markdown 文档转换为类似于 readthedocs 的内容。 该工具的说明是我可以在任何地方“托管”html,包括在 GitHub 上。
所以,我在这里创建并上传了我的文档:
https://github.com/PySimpleGUI/PySimpleGUI/tree/master/docs_html
我不知道如何以某种方式“托管”这些文件,以便用户可以访问那里并将文件视为网站。
一旦我与@stsewd建立
他真的竭尽全力帮助我完成这个过程。 你可以在这里阅读我的磨难
现在我对 PySimpleGUI 用户在我最终解决他们的一个问题时的感受有了更好的了解。 我向一直在等待修复的所有人道歉。 我一直在 100% 专注于恢复这些文档!
最有用的评论
一旦我与@stsewd建立
他真的竭尽全力帮助我完成这个过程。 你可以在这里阅读我的磨难
现在我对 PySimpleGUI 用户在我最终解决他们的一个问题时的感受有了更好的了解。 我向一直在等待修复的所有人道歉。 我一直在 100% 专注于恢复这些文档!