MarkdownでもSphinx

Python東海30回での発表資料

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