konlpy readthedocs update - hexists/konlpy GitHub Wiki
konlpy readthedocs update
- ์ฌํด ์งํํ konlpy ๊ด๋ จ ์ด์ ์ค ๊ฐ์ฅ ํฐ ์ด์์์ต๋๋ค.
- ์ด๋ป๊ฒ ํด๋น ์ด์๋ฅผ ํด๊ฒฐํ๋์ง๋ฅผ ์ ๋ฆฌํด๋ด ๋๋ค.
๋ฌธ์
- #393 pr merge ํ ๋ฌธ์ ๊ฐ ์๊ฒผ์ต๋๋ค.
- mecab์ ์ค์น ๊ฒฝ๋ก์ ๊ด๋ จ๋ ๋ณ๊ฒฝ์ด์๋๋ฐ, ์ด๋ก ์ธํด ๋ฆด๋ฆฌ์ฆ๋ version์ด ์๋ master์ mecab์ ํญ์ ๋ค์ด๋ฐ๊ณ ์๋ ๋ฌธ์ ๋ฅผ ๋ฐ๊ฒฌํ์ต๋๋ค.
- mecab ์ค์น ๊ฒฝ๋ก๋ version์ ๋ฐ๋ผ ๊ตฌ๋ถํ ์ ์๋๋ก ์ด์๋ฅผ ๋จ๊ธฐ๊ณ ํด๊ฒฐ ๋ฐฉ๋ฒ์ ๋ ผ์ํ์ต๋๋ค.
ํด๊ฒฐ ๋ฐฉ๋ฒ
-
konlpy๋ sphinx๋ฅผ ์ด์ฉํด์ ๋ฌธ์๋ฅผ ์์ฑํฉ๋๋ค.
-
sphinx๊ฐ ์คํ๋ ๋, mecab ์ค์น ์คํฌ๋ฆฝํธ ๊ฒฝ๋ก๋ฅผ version์ ๋ฐ๋ผ ์ ๋์ ์ผ๋ก ์ค์นํ ์ ์๋๋ก ์์ ํ์ต๋๋ค.
-
์ฃผ์ ์์ ์ฌํญ์ ๋๋ค.
-
Sphinx-Substitution-Extensions==2022.2.16์ ์ฌ์ฉํ์ต๋๋ค.
- ํด๋น extension์ sphinx์ conf.py์ ์ค์ ํด์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
- conf.py์ rst_prolog์ substitution์ด ํ์ํ ๋ด์ฉ์ ์ ์ํฉ๋๋ค.
- ๋ณธ๋ฌธ์์๋ block์ 'code-block:: bash'์ผ๋ก ์ง์ ํ๊ณ |variable|์ ํตํด ๋ณ์๋ฅผ ์ฌ์ฉํฉ๋๋ค.
-
์ฝ๋
extensions = [..., 'sphinx_substitution_extensions'] rst_prolog = f""" .. |release| replace:: v{release} """
.. code-block:: bash :substitutions: $ bash <(curl -s https://raw.githubusercontent.com/konlpy/konlpy/|release|/scripts/mecab.sh)
-
์๋ํด ๋ณธ ๋ฐฉ๋ฒ
-
#1, mecab ์ค์น์ ์ต์ ๋ฆด๋ฆฌ์ฆ ๋ฒ์ ์ ์ฐธ์กฐํ๋๋ก ๋ณ๊ฒฝ, #395
- master์ ํ์ผ ๋์ ์ต์ ๋ฆด๋ฆฌ์ฆ์ ํ์ผ์ ์ฌ์ฉํ๋๋ก ๋ณ๊ฒฝ
- release branch ์์ฑํด์ ๋ชจ๋ mecab์ ๋งํฌ๋ฅผ release branch๋ฅผ ์ฐธ๊ณ ํ๋๋ก ๋ณ๊ฒฝ
- ๋ฌธ์ ์ : ์๋ก ๋ค๋ฅธ version ์ ๋ํ ๋ฌธ์์์ MeCab ์ค์น ์คํฌ๋ฆฝํธ๋ฅผ ์ฌ์ ํ ๋์ผํ ๊ฒฝ๋ก๋ฅผ ์ฐธ์กฐํจ
- ๊ฒฐ๋ก : ๋ค๋ฅธ ํด๊ฒฐ ๋ฐฉ๋ฒ ์ฐพ์๋ณด๊ธฐ๋ก ํจ
-
#2, parsed-literal์ ์ฌ์ฉํ ๋ฐฉ๋ฒ
- ๋ณ๋์ extension ์์ด ๊ฐ๋ฅ
- ๋ฌธ์ ์ : indentation์ด ์ ์ง๋์ง ์์(๋ฌธ์ ํ์ด ๊นจ์ง)
- ๊ฒฐ๋ก : ๋ค๋ฅธ ํด๊ฒฐ ๋ฐฉ๋ฒ ์ฐพ์๋ณด๊ธฐ๋ก ํจ
๊ธฐํ
- ์์ ๋ด์ฉ์ด ๋ฐ๋ก ๋ฐ์๋์ง ์์ต๋๋ค.
- readthedocs ๊ถํ์ด ํ์ํ๊ณ , ํด๋น ๊ถํ์ ๋ฐ์์ง ์ผ๋ง ๋์ง ์์ ํ ์คํธ ํ ๋ฐ์ํ ์์ ์ ๋๋ค.