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
Using AI Tools Around Software Development
Avatar for inouehi inouehi
0
1.2k
Perplexity Slack Botを作ってAI活用を進めた話 / AI Engineering Summit プレイベント
Avatar for yukyan n3xem
0
660
FormFlow - Build Stunning Multistep Forms
Avatar for Yonel Ceruto González yceruto
1
170
Javaのルールをねじ曲げろ！禁断の操作とその代償から学ぶメタプログラミング入門 / A Guide to Metaprogramming: Lessons from Forbidden Techniques and Their Price
Avatar for nrs nrslib
3
2k
人には人それぞれのサービス層がある
Avatar for shimabox shimabox
3
680
A comprehensive view of refactoring
Avatar for Marabesi marabesi
0
660
「ElixirでIoT!!」のこれまでとこれから
Avatar for takasehideki takasehideki
0
360
実践ArchUnit ～実例による検証パターンの紹介～
Avatar for 荻原利雄 ogiwarat
2
260
Kotlin エンジニアへ送る：Swift 案件に参加させられる日に備えて～似てるけど色々違う Swift の仕様 / from Kotlin to Swift
Avatar for Elvis Shi lovee
1
180
Java on Azure で LangGraph！
Avatar for Kohei Saito kohei3110
0
140
Passkeys for Java Developers
Avatar for Yoshikazu Nojima ynojima
3
860
Claude Codeの使い方
Avatar for ttnyt8701 ttnyt8701
1
120

Featured

See All Featured
Side Projects
Avatar for Sacha Greif sachag
455
42k
Fight the Zombie Pattern Library - RWD Summit 2016
Avatar for Marcelo Somers marcelosomers
233
17k
Measuring & Analyzing Core Web Vitals
Avatar for Philip Tellis bluesmoon
7
480
The MySQL Ecosystem @ GitHub 2015
Avatar for Sam Lambert samlambert
251
13k
Gamification - CAS2011
Avatar for David Bonilla davidbonilla
81
5.3k
Speed Design
Avatar for Sergey Chernyshev sergeychernyshev
31
990
A designer walks into a library…
Avatar for Paul Jervis Heath pauljervisheath
206
24k
It's Worth the Effort
Avatar for 3n 3n
184
28k
We Have a Design System, Now What?
Avatar for Morgane Peng morganepeng
52
7.6k
[RailsConf 2023 Opening Keynote] The Magic of Rails
Avatar for Eileen M. Uchitelle eileencodes
29
9.5k
Facilitating Awesome Meetings
Avatar for Lara Hogan lara
54
6.4k
Agile that works and the tools we love
Avatar for Rasmus Luckow-Nielsen rasmusluckow
329
21k

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