Sphinxを、MercurialとPandocを組み合わせて Markdown記法で運用できるようにしたお話。
![SphinxをMarkdownで使い隊](https://cdn-ak-scissors.b.st-hatena.com/image/square/ba772b21e94fe21277a105952b0f778541e50ad3/height=288;version=1;width=512/https%3A%2F%2Fcdn.slidesharecdn.com%2Fss_thumbnails%2Fsphinxmarkdown-130707041141-phpapp01-thumbnail-4.jpg%3Fcb%3D1373170561)
Sphinxを、MercurialとPandocを組み合わせて Markdown記法で運用できるようにしたお話。
この記事は Sphinx アドベントカレンダーの 19日目です。 markdown と Sphinx (reST) Sphinx では文書を書く際の記述フォーマットに reStructured Text を利用していますが、 世を広く見回すと、github 然り、bitbucket 然り、様々な場所で markdown フォーマットが利用されています。 markdown フォーマットは reST と比べると表現力が低い上、表現を拡張することができないという点が指摘されています。 表現を拡張することができないため、いくつかの方言が存在するという問題もあります。 ですが、reST と比べてシンプルで、なおかつポピュラーに利用されているフォーマットであるため、 新しく Sphinx に触り始める人の取っ掛かりとしては、markdown はうってつけのフォーマットと言えます。 sphinxcont
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く