๋ฉฐ์น ๋์ ReadTheDocs ๋น๋๊ฐ ์คํจํ๊ณ ์๋๋ฐ ๊ทธ ์ด์ ๋ฅผ ๋ชจ๋ฅด๊ฒ ์ต๋๋ค.
์ค๋ฅ๋ ๋์๊ฒ ์๋ฏธ๊ฐ ์์ต๋๋ค. ๊ทธ๋ค์ ๋ฌธ์ ์ค ์ด๋ ๊ฒ์ด ๋์๊ณ ์ ๊ทธ๋ฐ์ง ๋งํ์ง ์์ต๋๋ค.
์ง๋ ๋ช ์ฃผ ๋์ ๋ณ๊ฒฝ๋ ์ฌํญ์ GitHub์ ์ง์ ํตํฉ๋๋ ๋ฐฉ์์ผ๋ก ๋งํฌ๋ค์ด ํธ์ง๊ธฐ๋ฅผ ์ฌ์ฉํ๊ณ ์๋ค๋ ๊ฒ์ ๋๋ค. ๊ทธ๋ฆฌ๊ณ repl.it ๋ ์ํผ iframe์ ์๋ฆฌ์ฑ ์ ์ถ๊ฐํ์ต๋๋ค. ์์ง readme๊ฐ ์๋ ๊ฒ ๊ฐ์์.
iframe์ด ์ฌ๊ธฐ์ ์๋ ํ์ฌ ์๋ ์ค์ธ Cookbook์์ ์คํ๋๊ณ ์๊ธฐ ๋๋ฌธ์ iframe์ด ์๋๋ผ๊ณ ์๊ฐํฉ๋๋ค.
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์์ ๋ด readme๋ฅผ ์ฌ๋ฐ๋ฅด๊ฒ ๋น๋ํ ์ ์์ต๋๋ค. ๋ด ์๋ฆฌ์ฑ ์ ๊ด์ฐฎ์ต๋๋ค.
์ด ๋ฌธ์ ๋ฅผ ์ด๋ป๊ฒ ํด๊ฒฐํ ์ ์์ต๋๊น? ๋๋ 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๊ฐ์์ด ๋์์ต๋๋ค.
์ด ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ ์ฌ๋์ ๊ณ ์ฉํด์ผ ํฉ๋๋ค.
์ฌ๊ธฐ ์ฌ๋์ด ์ด ๋ฅ์ ๊ณ ์น๊ณ ๋์ ๋ฒ๊ณ ์ถ์ด?
๊ทธ๋ ์ง ์๋ค๋ฉด ๋์์ ์ฒญํ๋ฌ ๊ฐ์ผ ํ ๊ฒ ๊ฐ์ต๋๋ค.
@MikeTheWatchGuy ์ด ์ผ์ ์ ๋ง ๋์์ด ๋์ง๋ง ๋ถํํ๋ ์ ๋ ์ง์ฅ๊ณผ ๊ฐ์กฑ์ผ๋ก ์ธํด ์ ๋ง ๋ฐ์ฉ๋๋ค. ๊ทธ๋ฌ๋ ๋๋ ์์ด๋์ด๊ฐ ์์ต๋๋ค. ๋ฌธ์๋ฅผ ๋ก์ปฌ๋ก ๋น๋ํ๊ณ ํ๋ก์ ํธ ์ ์ฅ์์ ์ง์ ์ ๋ก๋ํ ์ ์์ต๋๊น? ๋ด ๋ง์ readthedocs๋ฅผ ์ ๊ฑฐํ๋ ๊ฒ์ ๋๋ค.
์ค, ๋น์ ์ ์ํฉ์ ์ดํดํฉ๋๋ค ๋ฐ์ด๋น..... ๋ ๋๋ ๊ฒ์ ๋ํด ๊ฑฑ์ ํ์ง ๋ง์ญ์์ค. ์ถฉ๋ถํ ํ์ จ์ต๋๋ค.
readthedocs ์ฌ๋๋ค์๊ฒ ๋ฒ๊ทธ๋ฅผ ์ ๊ณ ํ์ง๋ง ์๋ต์ ๋ณ๋ก ๋์์ด ๋์ง ์์์ต๋๋ค.
์๊ตฌ ์ฌํญ ํ์ผ์ ์ฌ์ฉํ๊ฑฐ๋ python ๋ฒ์ ์ ๋ค์ด๊ทธ๋ ์ด๋ํ์ฌ mkdocs์ ์ ๋ฒ์ ์ผ๋ก ์ ๋ฐ์ดํธํ ์ ์์ต๋๋ค. ๊ตฌ์ฑ ํ์ผ https://docs.readthedocs.io/en/stable/config-file/v2.html์ ์ฌ์ฉํ์ฌ ๋ ๊ฐ์ง ์์ ์ ๋ชจ๋ ์ํํ ์ ์์ต๋๋ค.
#5332์ ๋ณต์ ๋ก ๋ซ๊ธฐ
์ด yml ํ์ผ์ ๋ง๋ค๊ณ ์์ ํ๋ ๋ฐ ํ ์๊ฐ์ ๋ณด๋์ต๋๋ค.
๋ด๊ฐ ๋์๊ฐ์ ์์ฒญํ ๊ฒ์ ๋ฒ๊ทธ๋ฅผ ์์ ํ๋ ํ์ผ์ ์ ๊ณตํ๋ ๊ฒ์ ๋๋ค.
ํ์ฌ ๋์ฐํ ์ ์ ์์ด๋ค์ ๊ต์ค์ด ์ค๋ ์์ ์์ PySimpleGUI๋ฅผ ์ฌ์ฉํ๊ธฐ ์์ํ๊ณ ์ด์ ๋ชจ๋ PySimpleGUI ๋ฌธ์๊ฐ ์ฃฝ๊ณ ์ฌ๋ผ์ก๋ค๋ ๊ฒ์ ๋๋ค. http://www.PySimpleGUI.org ๋ ๋ ์ด์ ์์ต๋๋ค. ๋ชจ๋ readthedocs ์ฝ๋์ ๋ฒ๊ทธ ๋๋ฌธ์ ๋๋ค. ์์งํ ์ข ์ง์ฆ๋ฉ๋๋ค.
๋ด ๋งํฌ๋ค์ด ๋ฌธ์๋ฅผ readthedocs์ฒ๋ผ ๋ณด์ด๋ ๊ฒ์ผ๋ก ๋ณํํ๋ ๋ค๋ฅธ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์ ๋ฒ์ ์ ๋น๋ํ๊ณ ์ ๋ก๋ํ์ต๋๋ค. ํด๋น ๋๊ตฌ์ ๋ํ ์ง์นจ์ GitHub๋ฅผ ํฌํจํ์ฌ ์ด๋์์๋ html์ "ํธ์คํธ"ํ ์ ์๋ค๋ ๊ฒ์ ๋๋ค.
๊ทธ๋์ ์ฌ๊ธฐ์์ ๋ด ๋ฌธ์๋ฅผ ๋ง๋ค๊ณ ์
๋ก๋ํ์ต๋๋ค.
https://github.com/PySimpleGUI/PySimpleGUI/tree/master/docs_html
์ฌ์ฉ์๊ฐ ๋ฐฉ๋ฌธํ์ฌ ํ์ผ์ ์น์ฌ์ดํธ๋ก ๋ณผ ์ ์๋๋ก ํด๋น ํ์ผ์ ์ด๋ป๊ฒ ๋ "ํธ์คํ "ํ๋ ๋ฐฉ๋ฒ์ ๋ชจ๋ฅด๊ฒ ์ต๋๋ค.
@stsew ์ ์ฐ๊ฒฐํ๋ฉด ๋ฌธ์ ๊ฐ ํด๊ฒฐ๋์์ต๋๋ค!
๊ทธ๋ ์ด ๊ณผ์ ์ ์งํํ๋ ๋ฐ ๋์์ ์ฃผ๊ธฐ ์ํด ์ ๋ง ๋ง์ ๋ ธ๋ ฅ์ ๊ธฐ์ธ์์ต๋๋ค. ์ฌ๊ธฐ์์ ๋ด ์๋ จ์ ๋ํด ์ฝ์ ์ ์์ต๋๋ค.
์ด์ PySimpleGUI ์ฌ์ฉ์๊ฐ ๋ง์นจ๋ด ๋ฌธ์ ์ค ํ๋๋ฅผ ํด๊ฒฐํ ๋ ์ด๋ป๊ฒ ๋๋ผ๋์ง์ ๋ํด ์กฐ๊ธ ๋ ์ ์๋๋ค. ์์ ์ ๊ธฐ๋ค๋ฆฌ์ จ๋ ๋ชจ๋ ๋ถ๋ค๊ป ์ฌ๊ณผ๋๋ฆฝ๋๋ค. ์ ๋ ์ด ๋ฌธ์๋ฅผ ๋์ฐพ๋ ๋ฐ 100% ์ง์คํ์ต๋๋ค!
๊ฐ์ฅ ์ ์ฉํ ๋๊ธ
@stsew ์ ์ฐ๊ฒฐํ๋ฉด ๋ฌธ์ ๊ฐ ํด๊ฒฐ๋์์ต๋๋ค!
๊ทธ๋ ์ด ๊ณผ์ ์ ์งํํ๋ ๋ฐ ๋์์ ์ฃผ๊ธฐ ์ํด ์ ๋ง ๋ง์ ๋ ธ๋ ฅ์ ๊ธฐ์ธ์์ต๋๋ค. ์ฌ๊ธฐ์์ ๋ด ์๋ จ์ ๋ํด ์ฝ์ ์ ์์ต๋๋ค.
์ด์ PySimpleGUI ์ฌ์ฉ์๊ฐ ๋ง์นจ๋ด ๋ฌธ์ ์ค ํ๋๋ฅผ ํด๊ฒฐํ ๋ ์ด๋ป๊ฒ ๋๋ผ๋์ง์ ๋ํด ์กฐ๊ธ ๋ ์ ์๋๋ค. ์์ ์ ๊ธฐ๋ค๋ฆฌ์ จ๋ ๋ชจ๋ ๋ถ๋ค๊ป ์ฌ๊ณผ๋๋ฆฝ๋๋ค. ์ ๋ ์ด ๋ฌธ์๋ฅผ ๋์ฐพ๋ ๋ฐ 100% ์ง์คํ์ต๋๋ค!