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
380
Google App Engine入門
Avatar for Satoshi Miura mursts
0
640

Other Decks in Technology

See All in Technology
Tech-Verse 2025 Global CTO Session
Avatar for LINEヤフーTech (LY Corporation Tech) lycorptech_jp
PRO
0
720
製造業からパッケージ製品まで、あらゆる領域をカバー！生成AIを利用したテストシナリオ生成 / 20250627 Suguru Ishii
Avatar for SHIFT EVOLVE shift_evolve
PRO
1
150
怖くない！はじめてのClaude Code
Avatar for Shinya Masadome（東京AI祭） shinya337
0
110
Amazon ECS & AWS Fargate 運用アーキテクチャ2025 / Amazon ECS and AWS Fargate Ops Architecture 2025
Avatar for iselegant iselegant
17
5.8k
強化されたAmazon Location Serviceによる新機能と開発者体験
Avatar for Yasunori Kirimoto dayjournal
3
230
生成AI時代 文字コードを学ぶ意義を見出せるか？
Avatar for hiroshi ueda hrsued
1
640
フィンテック養成勉強会#54
Avatar for フィンテック養成コミュニティ finengine
0
180
Witchcraft for Memory
Avatar for pocke pocke
1
500
Oracle Audit Vault and Database Firewall 20 概要
Avatar for oracle4engineer oracle4engineer
PRO
3
1.7k
急成長を支える基盤作り〜地道な改善からコツコツと〜 #cre_meetup
Avatar for すてにゃん stefafafan
0
130
AWS Organizations 新機能！マルチパーティ承認の紹介
Avatar for yhana yhana
1
170
Amazon S3標準/ S3 Tables/S3 Express One Zoneを使ったログ分析
Avatar for ShigeruOda shigeruoda
4
570

Featured

See All Featured
The Pragmatic Product Professional
Avatar for Laura Van Doore lauravandoore
35
6.7k
4 Signs Your Business is Dying
Avatar for Josh Pigford shpigford
184
22k
Java REST API Framework Comparison - PWX 2021
Avatar for Matt Raible mraible
31
8.7k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
Avatar for Michelle Schulp Hunt marktimemedia
31
2.4k
KATA
Avatar for Megan Lloyd mclloyd
30
14k
YesSQL, Process and Tooling at Scale
Avatar for Rocio Delgado rocio
173
14k
Adopting Sorbet at Scale
Avatar for Ufuk Kayserilioglu ufuk
77
9.4k
Optimizing for Happiness
Avatar for Tom Preston-Werner mojombo
379
70k
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
69
11k
Put a Button on it: Removing Barriers to Going Fast.
Avatar for kastner kastner
60
3.9k
Save Time (by Creating Custom Rails Generators)
Avatar for Garrett Dimon garrettdimon
PRO
31
1.2k
jQuery: Nuts, Bolts and Bling
Avatar for Doug Neiner dougneiner
63
7.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Ͱ ΋Α͍υΩϡϝ ϯτϥΠϑΛʂ