Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

MarkdownでもSphinx

Sponsored · SiteGround - Reliable hosting with speed, security, and support you can count on. →
Avatar for Satoshi Miura Satoshi Miura
June 26, 2016
Technology
470
1

 MarkdownでもSphinx

Python東海30回での発表資料

Avatar for Satoshi Miura

Satoshi Miura

June 26, 2016

More Decks by Satoshi Miura

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

Other Decks in Technology

See All in Technology
【視聴者参加型！】AWSセキュリティアンチパターンクイズ
Avatar for Shun Yoshie syoshie
1
490
クロスボーダーM&AのValue Upを支えるプロダクト開発。日米チームのハブになったプロダクトエンジニアの実践 / Product Engineering Conference 2026
Avatar for GENDA genda
0
110
2026-09-11 【Snowflake World Tour Tokyo 2026】Snowflakeを起点に、AI Agentが自律稼働し続ける未来へ / Driving AI Agents with Snowflake
Avatar for civitaspo civitaspo
0
270
omasushiというライブラリを作った
Avatar for polidog polidog
PRO
0
190
WAF 運用改善の承認サイクル/SRE_BizReach_MIXI_1
Avatar for Visional Engineering ＆ Design visional_engineering_and_design
2
410
Tab5をRubyで動くパソコンにする
Avatar for Katsuhiko Kageyama kishima
2
280
20260906 「AWS運用入門」著者が教える、運用業務への生成AI活用入門
Avatar for Masaru Ogura masaruogura
0
260
2026-09-09 【sigma_ucj#1】Sigma を IaC 管理したい！ / IaC for Sigma
Avatar for civitaspo civitaspo
0
110
KPIだけでは評価できないプロダクトが考えるべき Evalsという第二の評価系 / Beyond KPIs: Evals as a Second Evaluation Framework for Products #PdEConf
Avatar for Aki / @LoveIdahoBurger aki_iinuma
4
3.9k
アプリをもっと"iOSアプリっぽく"する小さな工夫 / Small Touches That Make Your App Feel More Like an iOS App
Avatar for matsuji matsuji
1
240
V8コントリビュート超入門
Avatar for Riya Amemiya riyaamemiya
0
160
OpenTelemetryのメトリクスをCloudWatchに送ってPromQLで見てみた
Avatar for Itaru Ota ota1022
0
120

Featured

See All Featured
Mobile First: as difficult as doing things right
Avatar for Swwweet swwweet
225
10k
Agile Leadership in an Agile Organization
Avatar for Dr. Kim W Petersen kimpetersen
PRO
0
230
Odyssey Design
Avatar for Ryan Kendrick rkendrick25
PRO
2
800
Practical Orchestrator
Avatar for Shlomi Noach shlominoach
191
12k
Performance Is Good for Brains [We Love Speed 2024]
Avatar for Tammy Everts tammyeverts
12
1.8k
Site-Speed That Sticks
Avatar for Harry Roberts csswizardry
13
1.5k
Exploring anti-patterns in Rails
Avatar for Elle Meredith aemeredith
3
500
Agile Actions for Facilitating Distributed Teams - ADO2019
Avatar for Mark Kilby mkilby
0
280
The Illustrated Guide to Node.js - THAT Conference 2024
Avatar for David Neal reverentgeek
1
470
How to make the Groovebox
Avatar for あそなす asonas
2
2.4k
The Mindset for Success: Future Career Progression
Avatar for Greg Gifford greggifford
PRO
0
490
Making Projects Easy
Avatar for Brett Harned brettharned
120
6.7k

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