Sphinx/docutilsܕ͚ͷޫͱҋ@cocoatomo
View Slide
ΞδΣϯμ1. ܕͱ2. Pythonͷܕώϯτ3. ޙ͚ͷܕ͚࡞ۀ4. ܕ͚ͷҋ5. ܕ͚ͷޫ6. ऴΘΓʹ
1. ܕͱ• ͷछผྨ• ࣮ߦલʹ໌͠ͳ͍ܕʢಈతܕʣ• ॊೈͳϓϩάϥϜ͕ॻ͚Δ• ॊೈա͗ͯͲΜͳ͕དྷΔ͔͔Βͳ͍• ࣮ߦલʹ໌͢Δܕʢ੩తܕʣ• ࣮ߦલʹ෦తʹόά͕ݕग़Ͱ͖Δ• ܕγεςϜ͕ځ۶ͳ͜ͱʢ͏ੲͷʣ
2. Pythonͷܕώϯτ• มɺؔʢύϥϝʔλ&ฦΓʣʹର͢Δܕࢦఆ• ͋͘·ͰΦϓγϣϯ• ੩తͳܕղੳπʔϧ͕ར༻/࣮ߦ࣌ʹແࢹ• PEP 484 -- Type Hints• PEP 561 -- Distributing and Packaging TypeInformation
3. ޙ͚ͷܕ͚࡞ۀ• มؔͷΘΕํ͔ΒܕΛਪଌ• ೖɺଐੑɺҾɺฦΓ͕ೖ͞ΕΔมͳͲ• ෳͷܕ͕༗ΓಘΔ߹UnionΛ͏• Ͳ͏ͯ͠ܕ͕͚ΒΕͳ͍ͱ͖ܕΛແࢹ͢Δ• # type: ignoreͱ͍͏ίϝϯτͰແࢹ• ಈతʹੜ͑Δଐੑɺ৯͍ҧ͏ϝιουΦʔόʔϥΠυ
4. ܕ͚ͷҋ• ܕ͕͔Βͳ͍• ಛʹϑϨʔϜϫʔΫͷ൚༻తͳ࣮• ઈରʹטΈ߹Θͳ͍ܕ• docutils.nodes.Elementͷ__add__ͱ__iadd__• MypyҾͷܕ͕ಉ͡Ͱ͋Δ͜ͱΛٻΊΔ͕……
__add__ͱ__iadd__
5. ܕ͚ͷޫ• όά͕ݟ͔Δ• quote_plusͷฦΓʢstrʣͷdecodeϝιουΛݺ΅͏ͱ͢Δ͕ʢPy3ʹʣͦΜͳͷແ͍!!• https://github.com/sphinx-doc/sphinx/commit/3808405b50503f8902ce6c061272c2e7d1b359cc#diff-d0e894e396b3cee20ed52b6be6ad63e6
decodeΛআ
6. ऴΘΓʹ• ΈΜͳγϯϓϧͳܕ͕͘PythonίʔυΛॻ͜͏ͳ!!• ※. docutilsʹޫ͋Δ͠ɺSphinxʹҋ͋Δ