Upgrade to PRO for Only $50/Year—Limited-Time Offer! 🔥

MarkdownでもSphinx

Avatar for Satoshi Miura Satoshi Miura
June 26, 2016
Technology
1
450

 MarkdownでもSphinx

Python東海30回での発表資料

Avatar for Satoshi Miura

Satoshi Miura

June 26, 2016
Tweet

More Decks by Satoshi Miura

See All by Satoshi Miura
お金ダッシュボードを作ってみた
Avatar for Satoshi Miura mursts
0
340
asyncioを軽くさわってみた
Avatar for Satoshi Miura mursts
0
170
FlaskとYomanでHello World
Avatar for Satoshi Miura mursts
0
390
Google App Engine入門
Avatar for Satoshi Miura mursts
0
650

Other Decks in Technology

See All in Technology
プロンプトやエージェントを自動的に作る方法
Avatar for shibuiwilliam shibuiwilliam
6
5.1k
re:Invent2025 コンテナ系アップデート振り返り(+CloudWatchログのアップデート紹介)
Avatar for 枡川健太郎 masukawa
0
360
Haskell を武器にして挑む競技プログラミング ─ 操作的思考から意味モデル思考へ
Avatar for Naoya Ito naoya
6
1.5k
因果AIへの招待
Avatar for Shohei SHIMIZU sshimizu2006
0
970
Debugging Edge AI on Zephyr and Lessons Learned
Avatar for misoji engineer iotengineer22
0
200
[デモです] NotebookLM で作ったスライドの例
Avatar for Takaaki Tanaka kongmingstrap
0
140
形式手法特論：CEGAR を用いたモデル検査の状態空間削減 #kernelvm / Kernel VM Study Hokuriku Part 8
Avatar for y_taka_23 ytaka23
2
460
Ruby で作る大規模イベントネットワーク構築・運用支援システム TTDB
Avatar for Taketo Takashima taketo1113
1
300
re:Invent 2025 ~何をする者であり、どこへいくのか~
Avatar for tetutetu214 tetutetu214
0
210
Snowflakeでデータ基盤を もう一度作り直すなら / rebuilding-data-platform-with-snowflake
Avatar for pei0804 pei0804
5
1.5k
AI駆動開発における設計思想 認知負荷を下げるフロントエンドアーキテクチャ/ 20251211 Teppei Hanai
Avatar for SHIFT EVOLVE shift_evolve
PRO
2
380
re:Invent 2025 ふりかえり 生成AI版
Avatar for TakaakiKakei takaakikakei
1
210

Featured

See All Featured
Site-Speed That Sticks
Avatar for Harry Roberts csswizardry
13
1k
Testing 201, or: Great Expectations
Avatar for Joseph Mastey jmmastey
46
7.8k
The Hidden Cost of Media on the Web [PixelPalooza 2025]
Avatar for Tammy Everts tammyeverts
1
100
Measuring & Analyzing Core Web Vitals
Avatar for Philip Tellis bluesmoon
9
710
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
35
2.3k
Statistics for Hackers
Avatar for Jake VanderPlas jakevdp
799
230k
10 Git Anti Patterns You Should be Aware of
Avatar for Lemi Orhan Ergin lemiorhan
PRO
659
61k
No one is an island. Learnings from fostering a developers community.
Avatar for Antonio thoeni
21
3.6k
For a Future-Friendly Web
Avatar for Brad Frost brad_frost
180
10k
How Fast Is Fast Enough? [PerfNow 2025]
Avatar for Tammy Everts tammyeverts
3
390
The MySQL Ecosystem @ GitHub 2015
Avatar for Sam Lambert samlambert
251
13k
JavaScript: Past, Present, and Future - NDC Porto 2020
Avatar for David Neal reverentgeek
52
5.8k

Transcript

  1. MARKDOWNͰ΋SPHINX 2016.06.25 PYTHON౦ւ 30TH

  2. ͓લͩΕΑ > Έ͏Β͞ͱ͠(@mursts) > Python౦ւͷ؅ཧਓͷҰਓͰ͢ > GCPUG Nagoya࢝Ί·ͨ͠(new) > 7/16(౔)ʹGCPUG

    Nagoya #1

  3. υΩϡϝϯτॻ ͍ͯ·͔͢ʁ

  4. ΈΜͳେ޷͖

  5. Ͱ͸ͳ͘

  6. ࠓ೔͸ͬͪ͜Ͱ͢

  7. SPHINXͱ͍͑͹

  8. RESTRUCTUREDTEXT

  9. օ͞Μ͔͚·͢ ͔ʁ

  10. MARKDOWNͳΒͲ͏ Ͱ͠ΐ͏ʁ

  11. RECOMMONMARK࢖͑͹ SPHINXͰMARKDOWN͕ ࢖͑·͢

  12. RECOMMONMARK ?

  13. A docutils-compatibility bridge to CommonMark.

  14. ࢖͍ํ

  15. $ pip install sphinx recommonmark

  16. conf.py > from recommonmark.parser import CommonMarkParser > > source_parsers =

    { > '.md': CommonMarkParser, > } > < # source_suffix = ['.rst', '.md'] < source_suffix = '.rst' --- > source_suffix = ['.rst', '.md'] > # source_suffix = '.rst'

  17. ޙ͸ɺindex.rstʹ௥Ճͯ͠make html

  18. ஫ҙ > GitHub Flavored MarkdownʹରԠ͍ͯ͠·ͤΜɻ > CommonMarkͷΈʹରԠ͍ͯ͠·͢ > ςʔϒϧΛ࢖͍͍ͨ৔߹͸reSTͰ

  19. RESTRUCTUREDTEXT͸ ۤखͰ΋MARKDOWN ͳΒ࢝ΊΒΕΔ ͔΋ʂ

  20. MAKRDOWNͱSPHINXͰ ΋Α͍υΩϡϝ ϯτϥΠϑΛʂ