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

Sphinx/docutilsの光と闇

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →
Avatar for cocoatomo cocoatomo
November 28, 2018
Programming
870
1

 Sphinx/docutilsの光と闇

Avatar for cocoatomo

cocoatomo

November 28, 2018

More Decks by cocoatomo

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

Other Decks in Programming

See All in Programming
Surviving Black Friday: 329 billion requests with Falcon!
Avatar for Samuel Williams ioquatix
0
3k
検索設計から
推論設計への重心移動と
Recall-First Retrieval
Avatar for po3rin po3rin
5
1.6k
書籍「ユーザーストーリーマッピング」が私のバイブル
Avatar for asumikam asumikam
4
490
[RubyKaigi 2026] Require Hooks
Avatar for Vladimir Dementyev palkan
1
310
20年以上続くプロダクトでも使い続けられる静的解析ツールを求めて
Avatar for Atsushi Matsuo matsuo_atsushi
0
150
2026-04-15 Spring IO - I Can See Clearly Now
Avatar for Jonatan Ivanov jonatan_ivanov
1
200
(Re)make Regexp in Ruby: Democratizing internals for the JIT
Avatar for TSUYUSATO Kitsune makenowjust
3
1k
The Past, Present, and Future of Enterprise Java
Avatar for ivargrimstad ivargrimstad
0
600
ハーネスエンジニアリングとは？
Avatar for kinopee kinopeee
13
6.9k
AI時代のエンジニアリングの原則 / Engineering Principles in the AI ​​Era
Avatar for haru860 haru860
0
1.2k
【ディップ｜26年新卒研修資料】OpenAPI/Swagger REST API研修
Avatar for ディップ株式会社 dip_tech
PRO
0
150
How We Practice Exploratory Testing in Iterative Development( #scrumniigata ) / 反復開発の中で、探索的テストをどう実施しているか
Avatar for teyamagu teyamagu
PRO
3
790

Featured

See All Featured
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
Avatar for Irina Nazarova irinanazarova
9
1.3k
CSS Pre-Processors: Stylus, Less & Sass
Avatar for Bermon Painter bermonpainter
360
30k
We Have a Design System, Now What?
Avatar for Morgane Peng morganepeng
55
8.1k
世界の人気アプリ100個を分析して見えたペイウォール設計の心得
Avatar for Akihiro Kokubo akihiro_kokubo
PRO
70
39k
How GitHub (no longer) Works
Avatar for Zach Holman holman
316
150k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
Avatar for Stéphanie Walter stephaniewalter
287
14k
brightonSEO & MeasureFest 2025 - Christian Goodrich - Winning strategies for Black Friday CRO & PPC
Avatar for Christian Goodrich cargoodrich
3
690
Noah Learner - AI + Me: how we built a GSC Bulk Export data pipeline
Avatar for Tech SEO Connect techseoconnect
PRO
0
180
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
Avatar for Tammy Everts tammyeverts
55
3.3k
Rebuilding a faster, lazier Slack
Avatar for samanthasiow samanthasiow
85
9.5k
Navigating the Design Leadership Dip - Product Design Week Design Leaders+ Conference 2024
Avatar for Andy Polaine apolaine
0
300
The Curse of the Amulet
Avatar for Matthew Lei leimatthew05
1
12k

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ʹ΋ҋ͸͋ Δ