Pysimplegui: 文档构建失败!! 需要帮忙!!

创建于 2019-02-18  ·  6评论  ·  资料来源: PySimpleGUI/PySimpleGUI

几天来,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

Done - Download from GitHub URGENT community input desired help wanted

最有用的评论

一旦我与@stsewd建立

他真的竭尽全力帮助我完成这个过程。 你可以在这里阅读我的磨难

现在我对 PySimpleGUI 用户在我最终解决他们的一个问题时的感受有了更好的了解。 我向一直在等待修复的所有人道歉。 我一直在 100% 专注于恢复这些文档!

所有6条评论

你好@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)
现在看起来我可能需要找到一种方法来更改该版本号

HHHHEEELLLLPPP!!!

我现在要倒退了。

如果您使用 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% 专注于恢复这些文档!

此页面是否有帮助?
0 / 5 - 0 等级

相关问题

lucasea777 picture lucasea777  ·  3评论

MikeTheWatchGuy picture MikeTheWatchGuy  ·  6评论

xuguojun168 picture xuguojun168  ·  3评论

scmanjarrez picture scmanjarrez  ·  5评论

OndoyManing picture OndoyManing  ·  4评论