Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Sphinx/docutilsの光と闇

Avatar for cocoatomo cocoatomo
November 28, 2018
Programming
1
840

 Sphinx/docutilsの光と闇

Avatar for cocoatomo

cocoatomo

November 28, 2018
Tweet

More Decks by cocoatomo

See All by cocoatomo
みんなの知らない翻訳の世界
Avatar for cocoatomo cocoatomo
0
770
PyPy における静的解析
Avatar for cocoatomo cocoatomo
0
150
型とは何か
Avatar for cocoatomo cocoatomo
0
110
Sphinx が支える翻訳ドキュメント
Avatar for cocoatomo cocoatomo
0
2.6k

Other Decks in Programming

See All in Programming
データの民主化を支える、透明性のあるデータ利活用への挑戦 2025-06-25 Database Engineering Meetup#7
Avatar for Kentaro Yoshida y_ken
0
340
ふつうの技術スタックでアート作品を作ってみる
Avatar for Akira Yagi akira888
0
440
ペアプロ × 生成AI 現場での実践と課題について / generative-ai-in-pair-programming
Avatar for コドモン開発チーム codmoninc
1
14k
スタートアップの急成長を支えるプラットフォームエンジニアリングと組織戦略
Avatar for Yusuke Suto sutochin26
0
3.9k
What Spring Developers Should Know About Jakarta EE
Avatar for ivargrimstad ivargrimstad
0
420
コードの90%をAIが書く世界で何が待っているのか / What awaits us in a world where 90% of the code is written by AI
Avatar for r-kagaya rkaga
50
33k
Goで作る、開発・CI環境
Avatar for Shinpei Mine sin392
0
200
Node-RED を（HTTP で）つなげる MCP サーバーを作ってみた
Avatar for High U highu
0
120
WebViewの現在地 - SwiftUI時代のWebKit - / The Current State Of WebView
Avatar for marcy731 marcy731
0
110
「Cursor/Devin全社導入の理想と現実」のその後
Avatar for Ryoichi Saito saitoryc
0
760
プロダクト志向ってなんなんだろうね
Avatar for RightTouch righttouch
PRO
0
180
Systèmes distribués, pour le meilleur et pour le pire - BreizhCamp 2025 - Conférence
Avatar for Sébastien LECACHEUR slecache
0
120

Featured

See All Featured
KATA
Avatar for Megan Lloyd mclloyd
30
14k
The Success of Rails: Ensuring Growth for the Next 100 Years
Avatar for Eileen M. Uchitelle eileencodes
45
7.5k
Helping Users Find Their Own Way: Creating Modern Search Experiences
Avatar for Dan Newman danielanewman
29
2.7k
For a Future-Friendly Web
Avatar for Brad Frost brad_frost
179
9.8k
XXLCSS - How to scale CSS and keep your sanity
Avatar for Zaharenia Atzitzikaki sugarenia
248
1.3M
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
30
2.1k
Scaling GitHub
Avatar for Zach Holman holman
459
140k
A Modern Web Designer's Workflow
Avatar for Chris Coyier chriscoyier
694
190k
Unsuck your backbone
Avatar for Amy Palamountain ammeep
671
58k
Making Projects Easy
Avatar for Brett Harned brettharned
116
6.3k
The Language of Interfaces
Avatar for Des Traynor destraynor
158
25k
BBQ
Avatar for Matthew Crist matthewcrist
89
9.7k

Transcript

  1. Sphinx/docutils ܕ෇͚ͷޫͱҋ @cocoatomo

  2. ΞδΣϯμ 1. ܕͱ͸ 2. Pythonͷܕώϯτ 3. ޙ෇͚ͷܕ෇͚࡞ۀ 4. ܕ෇͚ͷҋ 5.

    ܕ෇͚ͷޫ 6. ऴΘΓʹ

  3. 1. ܕͱ͸ • ஋ͷछผ෼ྨ • ࣮ߦલʹ൑໌͠ͳ͍ܕʢಈతܕʣ • ॊೈͳϓϩάϥϜ͕ॻ͚Δ • ॊೈա͗ͯͲΜͳ஋͕དྷΔ͔෼͔Βͳ͍

    • ࣮ߦલʹ൑໌͢Δܕʢ੩తܕʣ • ࣮ߦલʹ෦෼తʹόά͕ݕग़Ͱ͖Δ • ܕγεςϜ͕ځ۶ͳ͜ͱ΋ʢ΋͏ੲͷ࿩ʣ

  4. 2. Pythonͷܕώϯτ • ม਺ɺؔ਺ʢύϥϝʔλ&ฦΓ஋ʣʹର͢Δܕࢦఆ • ͋͘·ͰΦϓγϣϯ • ੩తͳܕղੳπʔϧ͕ར༻/࣮ߦ࣌ʹ͸ແࢹ • PEP

    484 -- Type Hints • PEP 561 -- Distributing and Packaging Type Information

  5. 3. ޙ෇͚ͷܕ෇͚࡞ۀ • ม਺΍ؔ਺ͷ࢖ΘΕํ͔ΒܕΛਪଌ • ୅ೖ஋ɺଐੑɺҾ਺ɺฦΓ஋͕୅ೖ͞ΕΔม਺ͳͲ • ෳ਺ͷܕ͕༗ΓಘΔ৔߹͸UnionΛ࢖͏ • Ͳ͏ͯ͠΋ܕ͕෇͚ΒΕͳ͍ͱ͖͸ܕΛແࢹ͢Δ

    • # type: ignoreͱ͍͏ίϝϯτͰແࢹ • ಈతʹੜ͑Δଐੑɺ৯͍ҧ͏ϝιουΦʔόʔϥΠυ

  6. 4. ܕ෇͚ͷҋ • ܕ͕෼͔Βͳ͍ • ಛʹϑϨʔϜϫʔΫͷ൚༻తͳ࣮૷ • ઈରʹטΈ߹Θͳ͍ܕ • docutils.nodes.Elementͷ__add__ͱ__iadd__

    • Mypy͸Ҿ਺ͷܕ͕ಉ͡Ͱ͋Δ͜ͱΛٻΊΔ ͕……

  7. __add__ͱ__iadd__

  8. 5. ܕ෇͚ͷޫ • όά͕ݟ෇͔Δ • quote_plusͷฦΓ஋ʢstrʣͷdecodeϝιουΛ ݺ΅͏ͱ͢Δ͕ʢPy3ʹ͸ʣͦΜͳ΋ͷ͸ແ͍!! • https://github.com/sphinx-doc/sphinx/commit/ 3808405b50503f8902ce6c061272c2e7d1b359

    cc#diff-d0e894e396b3cee20ed52b6be6ad63e6

  9. decodeΛ࡟আ

  10. 6. ऴΘΓʹ • ΈΜͳγϯϓϧͳܕ͕෇͘PythonίʔυΛॻ͜ ͏ͳ!! • ※஫. docutilsʹ΋ޫ͸͋Δ͠ɺSphinxʹ΋ҋ͸͋ Δ