๋ถ๋ฅ ์ ์ฒด๋ณด๊ธฐ (126) ์ธ๋ค์ผํ ๋ฆฌ์คํธํ [๋์ /์๊ตฌ] ํ์งฌ๋ฝ, ์คํ๋น๋น๋ฐฅ ๋จน์ด๋ดค์ด์. ์๋ ํ์ธ์. ์ค๋์ ๋์ ์๊ตฌ์ ์์นํ ์ค๊ตญ์ง ์๊ฐํด๋๋ฆด๊ฒ์. ํ์งฌ๋ฝ์ ์งฌ๋ฝ์ง์ด์์ ใ ใ ใ ๊ทผ๋ฐ ์ ๋ ์๋ ์งฌ๋ฝ์ด๋ ๋ฉด์๋ฆฌ๋ฅผ ์ ํธํ์ง๋ ์์์, ์ ๋ ๋ค๋ฅธ ๋ํ ๋ฉ๋ด์ธ ์คํ๋น๋น๋ฐฅ์ ๋จน์ด๋ดค์ต๋๋ค. ์ ์ฌ์๊ฐ์ ๊ฐ๋๋ ๋ง์์ด๋ผ์ ๋๊ธฐ ๋ช ๋จ์ ์ ํ๋ฒํธ, ๋ฉ๋ด๋ฅผ ๋ฏธ๋ฆฌ ์ ์ด๋๊ณ 5๋ถ ์ ๋ ๋๊ธฐํ์ด์. ์ ํฌ ์ผํ์ ์คํ๋น๋น๋ฐฅ์ ๊ฐ์ ์ํค๊ณ ์ถ๊ฐ๋ก ํ์์ก์ ์์ผฐ์ต๋๋ค. ์ธํธ ๋ฉ๋ด์ ์คํ๋น๋น๋ฐฅ+์คํ๋น๋น๋ฐฅ+์ธํธํ์์ก์ด ์์ด์ ์์ฌ์ ์ด์. ์คํ๋น๋น๋ฐฅ์๋ ๊ณ๋ ๊ตญ์ ๊ฐ์ด ์ฃผ์๋๋ผ๊ณ ์. ์ ๋ ๋งค์ด ๊ฑฐ๋ฅผ ์ ๋ชป ๋จน์ด์, ์คํ๋น๋น๋ฐฅ์ด ์กฐ๊ธ ๋งค์ ๋์ง๋ผ, ๋งค์ด ์งฌ๋ฝ๊ตญ๋ฌผ๋ณด๋ค๋ ๊ณ๋ ๊ตญ์ด์ด์ ์คํ๋ ค ์ข์๋ ๊ฒ ๊ฐ์์. ๊ธฐํธ์ ๋ฐ๋ผ ๋น๋ฒผ๋จน๊ธฐ๋ ํ์๋๋ฐ, ์ ๋ ๋ฎ๋ฐฅ๋ฅ๋ ๋ฌด์กฐ๊ฑด ์ ์์ด๋จน๋ ์ฃผ์๋ผ์ ์กฐ๊ธ์ฉ ๋ ์ ๋จน์์ต๋๋ค. ๊ณ๋ ํ๋ผ์ด๊ฐ ๋ฑ.. [๋ถ์ฐ] ๋ฐฑ์๋ช ๊ฐ "์ฒญ์์ "ใ ก ๋ฐฑ์ ๋ช ์ธ์ด ํ๋์ง?! ์๋ ํ์ธ์. ์ค๋์ ๋ถ์ฐ ๋น๊ฐ๋์ ์์นํ ์ค๋ฆฌ ์๋ฆฌ ์ง "์ฒญ์์ "์ ์๊ฐํด๋๋ฆฌ๋ ค๊ณ ํฉ๋๋ค. ์ค๋ ์ด๋ฆฐ์ด๋ ํด์ผ์ ๋ง์, ์ด๋ฒ์ด๋ ํ์ฌ ๊ฒธ ๋ถ๋ชจ๋ ๋ชจ์๊ณ ๋ค๋ ์์ด์. '์ด๋ฆฐ์ด๋ ์ด๋ผ ์ฌ๋์ด ์๊ฒ ์ง?' ํ๋๋ฐ ์ฌ๋๋ค์ด ๋ง๋๋ผ๊ณ ์. 30๋ถ ์ ๋ ๋๊ธฐํด์ ๋จน๊ณ ์์ต๋๋ค. ์ค๋ SNS์์ '์ด๋ฆฐ์ด๋ ์ธ์ top 5'๋ผ๋ ๊ธ์ ๋ดค๋๋ฐ. ๊ทธ์ค์์ ์ค๋ฆฌ๊ณ ๊ธฐ๊ฐ ์ค๋ธ์ค๋ธ์ ํจ๊ป top 1/2์๋ฅผ ๋คํฌ๋๋ผ๊ณ ์.... ๋น์ทํ ์ด์ ์์ ์ค๋ ์ฒญ์์ ์ ์ฌ๋์ด ๋ง์๋ ๋ด ๋๋ค ๐ ์ฒญ์์ ์ 3๋์งธ ์ด์ด์จ ๋ฐฑ์ ๋ช ๊ฐ๋์. ์ฌํด์๋ ๋ํ๋ช ์ธ ์นญํธ๊น์ง ์์ฌ๋ฐ์ผ์ จ๋์. ์ฒญ์์ ์ ๊ท๋ชจ๊ฐ ๊ฝค ํฐ ํธ์ ๋๋ค. ํ์ง๋ง, ์ํ๊น๊ฒ๋ ๊ท๋ชจ์๋นํด ์ฃผ์ฐจ์ฅ์ด ๋์ง ์์์ ๊ทผ์ฒ์ ์ด์ค์ฃผ์ฐจ๋ฅผ ์๋ดํ์๋๋ผ๊ณ ์. ์ฃผ์ฐจ ์๋ดํด ์ฃผ์๋ ๋ถ์ด ์กฐ๊ธ ๋ฏธ์ํ์ ๋๋์ด๋ผ, '์ฌ.. [์ด์๋/์ํธํ๋ผ๋ฉ] ๋ง์ฏ๋ฏธ๋ผ๋ฉ ์๋ ํ์ธ์. ์ค๋์ ์ด์๋์ ์์นํ ์ผ๋ณธ ๋ผ๋ฉ์ง ์๊ฐํด๋๋ฆด๊ฒ์. ๋ง์ฏ๋ฏธ๋ ์นด์ด์คํธ ๊ทผ์ฒ ์ด์๋์ ์์นํ ๋ผ๋ฉ๊ฐ๊ฒ์์. ์ผ๋ณธ ๋ผ๋ฉ์ง์ธ๋ฐ, ์ผ๋ฐ์ ์ผ๋ก ์๊ฐํ์๋ ๋์ฝ์ธ ๋ผ๋ฉ๊ฐ์ ๋๋์ด๋ผ๊ธฐ๋ณด๋ค๋ ์ํธํ ๋๋์ ๋ผ๋ฉ์ง์ด์์. ๋ฉด๋ ์ ๊ธฐ๋ 100%๋ผ๊ณ ํ์๋ ๋ญ๊ฐ ๋ ๊ฑด๊ฐํ๋ง์ ์ถ๊ตฌํ๋ ๋๋์ด๋๊น์? ๊ทธ๋์ ์๊ทน์ ์ธ ๋ง์ ๋ผ๋ฉ์ ์๊ฐํ์ ๋ค๋ฉด ์กฐ๊ธ ๋ค๋ฅธ ๋๋์ผ ์ ์์ต๋๋ค. ๋ง์ฏ๋ฏธ๋ ๊ณต๊ธฐ๋ฐฅ์ด ๊ณต์ง์์. ๋ฉด๋ง ๋จน๊ธฐ ์๊น๋ค๋ฉด ๊ณต๊ธฐ๋ฐฅ์ ์์ฒญํ์ ์ ๊ตญ๋ฌผ์ ๋ง์์ฆ์ค ์ ์์ด์. ๋ผ๋ฉด์ ์ก๋ผ๋ฉ, ์์ค๋ผ๋ฉ, ํํ๋ฉ ๋ฑ๋ฑ์ด์๊ณ ๋ ์ข ๋ฅ๋ ์ค์ผ๊ผฌ๋์ด๋ ์ฐจ์๋์ด์์ด์. ์ ๋ ์ด ๋ ์์ค๋ผ๋ฉ ์ ํธ๋ฅผ ์์ผฐ์ต๋๋ค. ์ธํธ๋ฉ๋ด๋ 1500์ ์ถ๊ฐํ๋ฉด ๊ต์ 2ํผ์ค๊ฐ ๊ฐ์ด ๋์์. ์์ค๋ผ๋ฉ ์ธํธ ๋น์ฅฌ์ผ :) ์ธํธ๋ผ์ ์ผ์ธ๋น ๊ต์ 2๊ฐ์ฉ์ธ๋ฐ ์ธ๋ช ์ด์.. sphinx-js ๋ก javascript ์ฝ๋ ๋ฌธ์ํํ๊ธฐ ๋ธ๋ก๊ทธ ๊ธ ์๋จ/ํ๋จ์ ๊ฐํ์ ์ผ๋ก ๋จ๋ ๊ด๊ณ ๋ ๋ธ๋ก๊ทธ ๊ฐ์ธ ์์ต๊ณผ ๊ด๋ จ ์๋ ํฐ์คํ ๋ฆฌ ์ธก ๊ด๊ณ ์ ๋๋ค ์๊ฐ ์๋ ํ์ธ์. ์ค๋์ javascript๋ก ์ฝ๋ฉ๋ ํ๋ก์ ํธ์ ๋ฌธ์ํ๋ฅผ ์ํ sphinx-js๋ฅผ ์ค๋ช ํด๋๋ฆฌ๋ ค๊ณ ํฉ๋๋ค. sphinx๋ python ํ๋ก์ ํธ์ ๋ฌธ์ ์๋ํ๋ฅผ ์ํ ํด์ ๋๋ค. python ํ๋ก์ ํธ์ ํจ์, ๋ชจ๋๋ค์ ํน์ ๋ฌธ๋ฒ์ ๋ฐ๋ผ ์ฃผ์์ ์์ฑํด ๋๋ฉด ์๋์ผ๋ก latex ๋ฌธ์, html๋ก ๋น๋ํด ์ฃผ๋ ํด์ด์์. ์คํ ์์ค ํ๋ก์ ํธ์ ๋ฌธ์ํ ๋ฑ์ ๋ง์ด ์ฌ์ฉํฉ๋๋ค. javascript์ฉ์ผ๋ก ์ ์ฌํ ํด jsdoc ์ด ์์ง๋ง, read-the-docs ์ ์ฐ๋ํด์ ๋น๋ํ๊ณ ์ถ์ด์ ์ฐพ๊ฒ ๋ ๊ฒ ๋ฐ๋ก sphinx-js์์. GitHub - mozilla/sphinx-js: Autodoc-style ex.. [๋์ /๋๋๋๋ก] ๋ฆฌ์ฝ์ ์ด ์๋ ํ์ธ์. ์ค๋๋ง์ ๋์์์ต๋๋ค. ๋์ ๋๋๋๋ก์์๋ ์ดํ๋ฆฌ์ ๋ ์คํ ๋ "๋ฆฌ์ฝ์ ์ด" ์๊ฐํด๋๋ฆด๊ฒ์. ๋ฆฌ์ฝ์ ์ด๋ ์์ ์ ์์ ๊ฐ๊ตฌ์ ์ด ์๋ ๊ณณ์ ์๋น์ผ๋ก ๋ฐ๊ฟ์๊ทธ๋ฐ์ง ์ธ๊ด์ด๋ ๋ถ์๊ธฐ๊ฐ ์์ ๊ฐ๊ตฌ์ ๋๋์ด์ด์์. ์คํ์ธ์ด๋ก 'Rico'๋ '๋ถ์ ํ', '๋ง์๋' ์ด๋ผ๋ ๋ป์ด๋์. ๋จํ ์๋ฆฌ๋ค๋ ๋ค์ํ๊ณ , ์ฝ์ค์๋ฆฌ , 1์ธ ์ธํธ 2์ธ ์ธํธ, 3์ธ์ธํธ ์ต์ ์ด ๋ค์ํด์. ์ ๋ 3์ธ์ธํธ๋ก ์์ผ๋จน์์ด์. 3์ธ์ธํธ๋ ์์ ๋นต, ๋ฆฌ์ฝํ ์๋ฌ๋, ๊ทธ๋ฆฌ๊ณ ํ์คํ๋ ๋ฆฌ์กฐ๋ ์ค ํ 2๊ฐ + ํผ์ + ํ์์ด์์. ๋ฆฌ์ฝ์ ์ด์ ํผ์๋ ๋์ฐ๊ฐ ํจ์ค์ธ๋ฆฌ์์. ์ฒ์ ๋จน์์๋๋ ๋ฐ์ญ๋ฐ์ญํ๊ณ ํฌ๋ฆฌ์คํผํด์ ๋ง์์๋๋ฐ, ์ด๋ฒ์ ๊ฐ์๋๋ ๋๋์ด ์ข ๋ฌ๋ผ์ ธ์ ์์ฌ์ ์ด์. ์ฃผ์ฐจ๋ ๋ฆฌ์ฝ์ ์ด ๋ฐ๋ก ์ ๊ณต์์ฃผ์ฐจ์ฅ์ ํ์๋ฉด ๋ผ์. ์์ฌ ํ ์ฃผ์ฐจ ์ ๋ณด๋ฅผ ๋ง์ํ์๋ฉด.. [์ด์๋/์นด์ด์คํธ ์ฃผ๋ณ] ํ๋์ค ์์์ "์๋" ์๋ ํ์ธ์. ์ค๋ ์๊ฐ์์ผ๋๋ฆด ๊ณณ์ "์๋" ์ ๋๋ค. ์๋๋ ์ด์๋, ์นด์ด์คํธ ์์ธก ๋๋ก๋ณ์ ์์นํ๊ณ ์์ด์. ์์ ์๋ ์ด๋ฅธ ๋ถ์๊ธฐ ์๋ ์ง๋ค์ด ์์๋๋ฐ, ์ฌ์๋ ๋ถํฐ ๋๋ก๋ณ์ '๋ถ์๊ธฐ ๋ง์ง'๋ค์ด ๋ง์ด ์๊ฒผ์ด์. ๋น์คํธ๋ก ํผ๋ธ๋ฆญ, ์๋, ๋ชจํฐํ, ํผ๋ธ๋ฆญ ๋ง์ผ, ๋ก๋ก ์๋ฌ๋๋ค์ด ๊ฐ์ ๋๋ก๋ณ์ ์์นํ๊ณ ์์ต๋๋ค. ์ด์๋์ ์ฒ์ ์ด๋ฐ ์ธ์คํ ๊ฐ์ฑ ์์์ ๋ค์ด ์๊ธธ๋๋ ๊น์ง ๋๋์ด์ ์๋๋ ์ด๋ฐ ๋ถ์๊ธฐ์ ๋๋ค๊ฐ ์๋์๊ฑฐ๋ ์. ๊ทผ๋ฐ, ๋๋ก๋ณ์ด ๊ฐ๋ก์๋ค๋ ๋ง๊ณ ๊ฑด๋์ ์ ๋ฆผ๊ณต์๋ ์๊ณ ํ๋ค๋ณด๋ ์์น๋ ์ข์๊ฒ๊ฐ์์. ์๋๋ ๊ฐ๊ฒ๊ฐ ์ฌ๋๋ค์ด ํตํํ๋ ๋๋ก๋ณด๋ค ํ ๋จ์ฐจ ์์ ์์ด์. ๊ทธ๋์ ์ฌ๋ผ์ด๋ฉ ๋์ด๋ฅผ ์ด์ด๋๋ ์ง๋๊ฐ๋ ํ์ธ๋ค๊ณผ๋ ๋ค๋ฅธ ๊ณต๊ฐ์ ์๋๋ฏํ ๋๋์ ์ค๋๋ค. ์ ๋ ๋์ด ๊ฐ์ ๋ฏธ์๊ฐ ์๋ฌ๋, ํฌ๋ฆฌ์คํผ ์ค๊ฒน์ด, ๋ผ์๋๋ฅผ.. ์นด์ด์คํธ N๋ ์ฐจ ๋ฒ๊ฝ๋์ด ๊ฟํ ์๋ ํ์ธ์. ์ค๋์ ์ ๋ง ๊ณ ๋ฏผํ๋ ์ฝํ ์ธ ์์. ํ ๊ณณ์ ์์์ง, N์ฐ์ฐจ๋ก์จ, ๋ฒ๊ฝ์์ฆ์ด ๋๋ฉด ํ๊ต์ ์ ๋ง ์ฌ๋์ด ๋ง์ต๋๋ค. ๊ทผ๋ฐ ํด๊ฐ ๊ฑฐ๋ญํ ์๋ก ์ฌ๋๋ค์ด ๋ ๋ง์์ง๋ ๊ฒ ๊ฐ์์. ๊ทธ๋์ ๊ฐ๋ ๋ถ๋ช ๋๋ ๋ด๋ถ์ธ์ธ๋ฐ ์ฌ๋๋ค์ด ๋๋ฌด ๋ง์ด ์ค๋ฉด ์ ๊ฐ ์ธ๋ถ์ธ์ด ๋ ๊ฒ ๊ฐ์ ๋๋์ด ๋ค ๋๊ฐ ์์ด์. ๋ฏ์ค๊ฑฐ๋ ์. ๋๋ฌ ์ค์๋ฉด ์ด์ ์ค์ ๊ฑฐ ์์๊ฒ ๊ตฌ๊ฒฝํ๊ณ ๊ฐ์ จ์ผ๋ฉด ์ข๊ฒ ๋๋ฐ, ์ ์ ์์ชฝ์์๋ง ๊ตฌ๊ฒฝํ๋ค ๋์๊ฐ์๋ ๊ฒฝ์ฐ๋ ์๋๋ผ๊ณ ์. ๊ทธ๋์ ์ธ์ ๊ฐ ์ ๋ฆฌํด ๋ด์ผ์ง ํ๋๋ฐ, ๊ทธ๊ฒ ์ค๋์ธ๊ฐ ๋ด ๋๋ค. ์ฌํด ๋ฒ๊ฝ์ด ๋๋ฌด ์์๊ฒ ํ์ด์. ๋ฉฐ์น ์ ๊น์ง๋งํด๋, ๋ ์จ๊ฐ ์ถ์์ ๋ณ๋ก ์ ์์๋ค ์ด๋ฌ๋๋ฐ, ๋ฉฐ์น ์๊ฐ์ผ๋ก ํ๊บผ๋ฒ์ ๊ฐ์ด ํ์ด์. ์๋๋ ๋ชฉ๋ จ์ด ๊ฑฐ์ ์ง๊ณ ๋์ ๋ฒ๊ฝ์ด ํผ๋๋ฐ, ์ด๋ฒ์๋ ๋ชฉ๋ จ์ด๋ ๊ฐ์ด ํผ์ด์ ๋๋ฌด ์์ฉ๋๋ค. ๋์ถฉ .. ์จ์คํด ์กฐ์ ๋ถ์ฐ ๊น๋ฐ๋ฆฌ์ ๋ทํ ๋ฆฌ๋ทฐ (์๊ทธ๋์ ๋ ๋ทฐ ๋ทํ์ ๋น๊ต + ์ฐ์ฑ ๋ก ์ฌ์ง์ ๊ณ๋ค์ธ) ์๋ ํ์ธ์. ์ค๋์ ๋ถ์ฐ์์ ์ ๋ช ํ ํน๊ธ ํธํ ๋ทํ๋ค ์ค ํ๋์ธ ์จ์คํด ์กฐ์ ํธํ ์ ์์นํ ๊น๋ฐ๋ฆฌ์ ๋ทํ๋ฅผ ๋ฆฌ๋ทฐํด๋ณผ๊น ํด์. (์๊ทธ๋์ ๋ถ์ฐ ๋ ๋ทฐ ๋ทํ์์ ๋น๊ต๋ฅผ ์ด์ง ๊ณ๋ค์ฌ ๋ณผ๊ฒ์. ๋น์ทํ ๋ผ์ธ์ด๋ค๋ณด๋, ์์ฐ์ค๋ฝ๊ฒ ๋น๊ต๋ฅผ ํ๊ฒ๋๋๋ผ๊ตฌ์.) ์จ์คํด ์กฐ์ ํธํ ์ ๋ถ์ฐ์์ ๊ต์ฅํ ์ค๋๋ ํธํ ์ ๋๋ค. ํด์ด๋ ๋ฐฑ์ฌ์ฅ ๋ฐ๋ก ์์ ์์นํ๊ณ ์๊ณ , ๋๋ฐฑ์ฌ์ ๋ผ๊ณ ์๋ ํธํ ์ด์ฃ . ์ฌ์ค ์ ๋ "์จ์คํด ์กฐ์ "์ด๋ผ๊ณ ๋ถ๋ฅด๋ ๊ฒ๋ณด๋ค๋ "์กฐ์ ๋น์นํธํ "์ด๋ผ๊ณ ๋ถ๋ฅด๋ ๊ฒ ๋ ์์ฐ์ค๋ฌ์์. ํด์ด๋ ์กฐ์ ๋น์นํธํ ์ ๊ต์ฅํ ์ค๋๋ ๊ณณ์ผ๋ก ์๊ณ ์์ด์. ์ ํฌ ์ด๋จธ๋๊ป์ ์ ์ ์์ ์ ์์ธ์์ ์ฒ์ ๋ถ์ฐ์ผ๋ก ๋ด๋ ค์ค์ จ์ ๋ ๋ฌต์๋ ๊ธฐ์ต์ด ์๋ค๊ณ ํ์ จ์ผ๋๊น์. ๊ทธ๋ฌ๋ค 95๋ ์ฏค ๋ถ์ฐ ์จ์คํด ์กฐ์ ๋น์น ํธํ ์ ์ง๋ถ์ ์ ์ธ๊ณ ๊ทธ๋ฃน์ด ์ธ์ํ๋ฉด์ ".. ์ด์ 1 ยทยทยท 7 8 9 10 11 12 13 ยทยทยท 16 ๋ค์