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

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
330
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
E2Eテスト設計_自動化のリアル___Playwrightでの実践とMCPの試み__AIによるテスト観点作成_.pdf
Avatar for ファインディ株式会社（イベント資料アップ用） findy_eventslides
2
620
Oracle Base Database Service 技術詳細
Avatar for oracle4engineer oracle4engineer
PRO
12
80k
Claude Code Subagents 再入門 ~cc-sddの実装で学んだこと~
Avatar for Gota gotalab555
3
840
カンファレンスに託児サポートがあるということ / Having Childcare Support at Conferences
Avatar for nobu09 nobu09
1
570
HR Force における DWH の併用事例 ~ サービス基盤としての BigQuery / 分析基盤としての Snowflake ~@Cross Data Platforms Meetup #2「BigQueryと愉快な仲間たち」
Avatar for Ryo Suzuki ryo_suzuki
0
210
Findy Team+ QAチーム これからのチャレンジ！
Avatar for ファインディ株式会社（イベント資料アップ用） findy_eventslides
0
180
LLM時代にデータエンジニアの役割はどう変わるか？
Avatar for Ikki Miyazaki ikkimiyazaki
6
1.4k
スタートアップにおけるこれからの「データ整備」
Avatar for ShoMaekawa/ウィル shomaekawa
2
480
これがLambdaレス時代のChatOpsだ！実例で学ぶAmazon Q Developerカスタムアクション活用法
Avatar for iwamot iwamot
PRO
6
1.1k
AWSでAgentic AIを開発するための前提知識の整理
Avatar for Kiminori Yokoi nasuvitz
2
160
Contract One Engineering Unit 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
0
8.8k
Geospatialの世界最前線を探る [2025年版]
Avatar for Yasunori Kirimoto dayjournal
1
220

Featured

See All Featured
Optimising Largest Contentful Paint
Avatar for Harry Roberts csswizardry
37
3.5k
Fireside Chat
Avatar for paigeccino paigeccino
40
3.7k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
Avatar for Chris Coyier chriscoyier
508
140k
Context Engineering - Making Every Token Count
Avatar for Addy Osmani addyosmani
6
250
StorybookのUI Testing Handbookを読んだ
Avatar for Shingo Yamazaki zakiyama
31
6.2k
Building an army of robots
Avatar for Kyle Neath kneath
306
46k
A designer walks into a library…
Avatar for Paul Jervis Heath pauljervisheath
209
24k
Designing for humans not robots
Avatar for Tammie Lister tammielis
254
26k
Distributed Sagas: A Protocol for Coordinating Microservices
Avatar for Caitie McCaffrey caitiem20
333
22k
Building Flexible Design Systems
Avatar for Yesenia Perez-Cruz yeseniaperezcruz
329
39k
The Illustrated Children's Guide to Kubernetes
Avatar for Chris Short chrisshort
49
51k
Into the Great Unknown - MozCon
Avatar for Noah Learner thekraken
40
2.1k

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