Pysimplegui: Сборки документов не работают !! НУЖНА ПОМОЩЬ!!

Созданный на 18 февр. 2019  ·  6Комментарии  ·  Источник: PySimpleGUI/PySimpleGUI

В течение нескольких дней сборки ReadTheDocs терпят неудачу, и я не знаю почему.

Для меня ошибки не имеют смысла. Они не говорят мне, какой из документов плохой и почему.

Вещи, которые изменились за последние недели, заключаются в том, что я использую свой редактор разметки таким образом, что он напрямую интегрирован в GitHub. И я добавляю фреймы для рецептов repl.it в Cookbook. Я не думаю, что в ридми их еще есть.

Я не думаю, что это фреймы, потому что они работают в текущей рабочей книге рецептов, расположенной здесь.
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

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

Продолжаю получать ошибки. Все еще не могу заставить мой файл readme правильно построить с помощью readthedocs. Моя поваренная книга в порядке.

Как я могу решить эту проблему? Я не использую mkdocs. Я думаю, что это делает читательский документ.

Я вижу в примечаниях к сборке из 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 !!!!

Я сейчас возвращаюсь назад.

Кажется, что readthedocs теперь полностью распадается, если вы используете документацию по уценке. При использовании сфинкса, видимо, никаких проблем.

Я ДЕЙСТВИТЕЛЬНО разочарован в людях readthedocs, которые обновились до Python 3.7, что привело к появлению ошибок, которые оставили мою документацию в беспорядке.

Это нечестно!

Черт, я трачу достаточно времени на работу над этими документами, и вот прошло 2 месяца с тех пор, как я смог загрузить новые созданные мной документы.

Мне придется нанять кого-нибудь, чтобы это исправить.

Кто-нибудь здесь хочет заработать денег на починке этого дерьма?

Если нет, то я, наверное, отправлюсь к fiverr за помощью.

@MikeTheWatchGuy Я бы действительно помог тебе в этом, но, к сожалению, я очень занят работой и семьей. Однако у меня есть идея. Можно ли собрать документы локально и загрузить их прямо в репозиторий проекта? я имею в виду удаление readthedocs.

О, я понимаю твою ситуацию, Давиде ... не беспокойся о помощи мне. Вы сделали достаточно.

Я сообщил об ошибке читателям, но ответ мне не очень помог.

Вы можете обновить mkdocs до новой версии с файлом требований или понизив версию python. Вы можете сделать и то, и другое, используя файл конфигурации https://docs.readthedocs.io/en/stable/config-file/v2.html.

Закрытие как дубликат № 5332

Я потратил час, пытаясь создать и изменить этот файл yml.

Я вернулся и попросил предоставить файл, который исправляет ИХ ОШИБКУ.

Что ужасно на данный момент, так это то, что класс детей ТОЛЬКО СЕГОДНЯ начал использовать PySimpleGUI в своем классе, и теперь ВСЕ документы PySimpleGUI мертвы и ушли. http://www.PySimpleGUI.org больше нет. Все из-за ошибки в коде readthedocs. Честно говоря, это меня бесит.

Я создал и загрузил версию документов, используя другой инструмент, который преобразовал мои документы уценки во что-то похожее на readthedocs. Инструкции для этого инструмента заключались в том, что я мог «разместить» html где угодно, в том числе на GitHub.

Итак, я создал и загрузил сюда свои документы:
https://github.com/PySimpleGUI/PySimpleGUI/tree/master/docs_html

Я не знаю, как каким-то образом «разместить» эти файлы, чтобы пользователи могли посещать их и видеть файлы как веб-сайт.

Как только я подключился к @stsewd, проблема была решена!

Он действительно старался изо всех сил помочь мне пройти через этот процесс. Вы можете прочитать о моем испытании здесь

Теперь я немного лучше знаю, что чувствуют пользователи PySimpleGUI, когда я наконец решаю одну из их проблем. Приношу свои извинения всем, кто ждал исправлений. Я был на 100% сосредоточен на том, чтобы вернуть эти документы!

Была ли эта страница полезной?
0 / 5 - 0 рейтинги