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

MarkdownでもSphinx

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →
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
レガシー共有バッチ基盤への挑戦 - SREドリブンなリアーキテクチャリングの取り組み
Avatar for Konishi tatsuhiro tatsukoni
0
200
2026年、サーバーレスの現在地 -「制約と戦う技術」から「当たり前の実行基盤」へ- /serverless2026
Avatar for Serverless Operations slsops
2
210
予期せぬコストの急増を障害のように扱う――「コスト版ポストモーテム」の導入とその後の改善
Avatar for Masahiro Yoshizawa muziyoshiz
1
1.6k
Tebiki Engineering Team Deck
Avatar for Tebiki, Inc. tebiki
0
24k
CDK対応したAWS DevOps Agentを試そう_20260201
Avatar for モブエンジニア（Masaki Okuda） masakiokuda
1
200
入社1ヶ月でデータパイプライン講座を作った話
Avatar for Yuta Ozaki waiwai2111
1
250
ZOZOにおけるAI活用の現在 ~開発組織全体での取り組みと試行錯誤~
Avatar for ZOZO Developers zozotech
PRO
5
4.8k
Databricks Free Edition講座 データサイエンス編
Avatar for Takaaki Yayoi taka_aki
0
290
10Xにおける品質保証活動の全体像と改善 #no_more_wait_for_test
Avatar for nihonbuson nihonbuson
PRO
2
200
What happened to RubyGems and what can we learn?
Avatar for Mike McQuaid mikemcquaid
0
250
フルカイテン株式会社 エンジニア向け採用資料
Avatar for FULL KAITEN fullkaiten
0
10k
Context Engineeringの取り組み
Avatar for nutslove nutslove
0
280

Featured

See All Featured
The Cost Of JavaScript in 2023
Avatar for Addy Osmani addyosmani
55
9.5k
Fantastic passwords and where to find them - at NoRuKo
Avatar for Phil Nash philnash
52
3.6k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
Avatar for Morgane Peng morganepeng
133
19k
Everyday Curiosity
Avatar for Cassini Nazir cassininazir
0
130
Color Theory Basics | Prateek | Gurzu
Avatar for Gurzu gurzu
0
190
jQuery: Nuts, Bolts and Bling
Avatar for Doug Neiner dougneiner
65
8.4k
10 Git Anti Patterns You Should be Aware of
Avatar for Lemi Orhan Ergin lemiorhan
PRO
659
61k
The Invisible Side of Design
Avatar for Vitaly Friedman smashingmag
302
51k
Avoiding the “Bad Training, Faster” Trap in the Age of AI
Avatar for Mike Taylor tmiket
0
72
Testing 201, or: Great Expectations
Avatar for Joseph Mastey jmmastey
46
8k
How To Speak Unicorn (iThemes Webinar)
Avatar for Michelle Schulp Hunt marktimemedia
1
380
How Fast Is Fast Enough? [PerfNow 2025]
Avatar for Tammy Everts tammyeverts
3
450

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Ͱ ΋Α͍υΩϡϝ ϯτϥΠϑΛʂ