Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
MarkdownでもSphinx
Search
Sponsored
·
SiteGround - Reliable hosting with speed, security, and support you can count on.
→
Satoshi Miura
June 26, 2016
Technology
460
1
Share
MarkdownでもSphinx
Python東海30回での発表資料
Satoshi Miura
June 26, 2016
More Decks by Satoshi Miura
See All by Satoshi Miura
お金ダッシュボードを作ってみた
mursts
0
340
asyncioを軽くさわってみた
mursts
0
180
FlaskとYomanでHello World
mursts
0
400
Google App Engine入門
mursts
0
660
Other Decks in Technology
See All in Technology
React Compiler導入から21ヶ月、いま始めるならこうやる
astatsuya
2
200
生成AI時代に信頼性をどう保ち続けるか - Policy as Code の実践
akitok_
1
450
なぜ、私がCommunity Builderに?〜活動期間1か月半でも選出されたワケ〜
yama3133
0
140
Oracle AI Database@AWS:サービス概要のご紹介
oracle4engineer
PRO
4
2.6k
サンプリングは「作る」のか「使う」のか? 分散トレースのコストと運用を両立する実践的戦略 / Why you need the tail sampling and why you don't want it
ymotongpoo
4
190
パーソルキャリア IT/テクノロジー職向け 会社紹介資料|Company Introduction Deck
techtekt
PRO
0
210
既存プロダクトQAから新規プロダクトQAへ
ryotakahashi
0
150
クラウドからエッジまで ~ 1,700台を支える監視設計~
optfit
0
110
Sansan Engineering Unit 紹介資料
sansan33
PRO
1
4.5k
バイブコーディング、仕様駆動、その先へ - 「不確実性に対する検査‧適応のサイクル」を設計する
littlehands
1
540
サイボウズ、プラットフォームエンジニアリング始めるってよ ― プラットフォームチームの事業貢献と組織アラインメントの強化
ueokande
0
120
React Compiler導入の効果と運用の工夫
kakehashi
PRO
3
220
Featured
See All Featured
Documentation Writing (for coders)
carmenintech
77
5.3k
SEOcharity - Dark patterns in SEO and UX: How to avoid them and build a more ethical web
sarafernandez
0
180
Done Done
chrislema
186
16k
Kristin Tynski - Automating Marketing Tasks With AI
techseoconnect
PRO
0
240
Bioeconomy Workshop: Dr. Julius Ecuru, Opportunities for a Bioeconomy in West Africa
akademiya2063
PRO
1
110
How to build a perfect <img>
jonoalderson
1
5.5k
Paper Plane
katiecoart
PRO
1
50k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
47
8.1k
Heart Work Chapter 1 - Part 1
lfama
PRO
7
35k
Reality Check: Gamification 10 Years Later
codingconduct
0
2.1k
Lessons Learnt from Crawling 1000+ Websites
charlesmeaden
PRO
1
1.2k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
32
2.9k
Transcript
MARKDOWNͰSPHINX 2016.06.25 PYTHON౦ւ 30TH
͓લͩΕΑ > Έ͏Β͞ͱ͠(@mursts) > Python౦ւͷཧਓͷҰਓͰ͢ > GCPUG Nagoya࢝Ί·ͨ͠(new) > 7/16()ʹGCPUG
Nagoya #1
υΩϡϝϯτॻ ͍ͯ·͔͢ʁ
ΈΜͳେ͖
Ͱͳ͘
ࠓͬͪ͜Ͱ͢
SPHINXͱ͍͑
RESTRUCTUREDTEXT
օ͞Μ͔͚·͢ ͔ʁ
MARKDOWNͳΒͲ͏ Ͱ͠ΐ͏ʁ
RECOMMONMARK͑ SPHINXͰMARKDOWN͕ ͑·͢
RECOMMONMARK ?
A docutils-compatibility bridge to CommonMark.
͍ํ
$ pip install sphinx recommonmark
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'
ޙɺindex.rstʹՃͯ͠make html
ҙ > GitHub Flavored MarkdownʹରԠ͍ͯ͠·ͤΜɻ > CommonMarkͷΈʹରԠ͍ͯ͠·͢ > ςʔϒϧΛ͍͍ͨ߹reSTͰ
RESTRUCTUREDTEXT ۤखͰMARKDOWN ͳΒ࢝ΊΒΕΔ ͔ʂ
MAKRDOWNͱSPHINXͰ Α͍υΩϡϝ ϯτϥΠϑΛʂ