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

MarkdownでもSphinx

Satoshi Miura
June 26, 2016
Technology
1
420

 MarkdownでもSphinx

Python東海30回での発表資料

Satoshi Miura

June 26, 2016
Tweet

More Decks by Satoshi Miura

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

Other Decks in Technology

See All in Technology
Signals Unleashed: The Full Guide
rainerhahnekamp
0
350
アプリがつくるNOT A HOTELブランド
hokuts
0
450
オブザーバビリティの Primary Signals
onk
PRO
0
540
Aurora MySQL v3(MySQL8.0互換)の オンラインDDLの罠挙動を全バージョンで検証した
yutakikai
0
150
マルチアカウント環境への発見的統制の導入
ch1aki
1
1.3k
巨大なテーブルのテーブル定義を無停止で安全に誰でも変更できるようにする / Table-definitions-for-huge-tables-can-be-modified-by-anyone-safely-and-non-disruptively
freee
1
730
Tableau事例紹介 / Tableau Case Study of Eureka
kazuya_araki_tokyo
1
170
元インフラエンジニアに成る / Human Resources to Human Relations
bobtani
2
730
コンパウンドスタートアップのためのスケーラブルでセキュアなInfrastructure as Codeパイプラインを考える / Scalable and Secure Infrastructure as Code Pipeline for a Compound Startup
yuyatakeyama
3
1.8k
カオナビの利用実績をアウトカムへつなげる旅 / example-of-data-management-startup-in-kaonavi
kaonavi
0
110
コンテナセキュリティの基本と脅威への対策
kyohmizu
3
670
DevOpsDays History and my DevOps story
kawaguti
PRO
8
1.4k

Featured

See All Featured
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
352
28k
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
185
16k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
8
8.3k
We Have a Design System, Now What?
morganepeng
42
6.7k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
219
21k
Typedesign – Prime Four
hannesfritz
36
2k
Automating Front-end Workflow
addyosmani
1354
200k
What's in a price? How to price your products and services
michaelherold
237
11k
Bash Introduction
62gerente
604
210k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
18
1.7k
Adopting Sorbet at Scale
ufuk
67
8.6k
RailsConf 2023
tenderlove
1
530

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