Talk Proposal Submission
If you are interested in attending this talk at PyCon JP 2017, please use the social media share buttons below. We will consider the popularity of the proposals when making our selection.
talk
世界でいちばん簡単なSphinx入門(ja)
Speakers
Toshiyuki Ishii
Audience level:
Novice
Category:
Documentation
Description
Sphinxは非常に強力なPython製のドキュメンテーションツールです。
Pythonだけではなく、LinuxカーネルやCakePHPなど他言語の著名なOSSのドキュメントに使用されています。
しかし、導入に際してreStructuredTextの壁、設定の煩雑さなどが原因で二の足を踏んでいる方が多いと思います。
本セッションではマークダウンとGUIを使い、世界でいちばん簡単なSphinx入門をお教えします。
Objectives
Sphinxで一番最初にぶつかるreStructuredTextの壁をマークダウンで回避し、Sphinxの便利な機能を体験してもらう。
Abstract
Sphinxを始めるに当たって一番の障壁となるのはreStructuredTextでしょう。
GitHubをはじめ多くのWebサービスがマークダウンを採用しています、すでにマークダウンで書かれたドキュメント資産があるという方もいるでしょう。
しかし、SphixでマークダウンとreStructuredTextが併用できたら便利だと思いませんか？
Sphinxをはじめようとしたけど`conf.py`の設定が難しくて断念した方はいませんか？
もし、GUIから数回のマウスクリックでSphinxのドキュメントが作成できたら便利だと思いませんか？
本セッションでは、GUIとマークダウンを使った世界でいちばん簡単なSphinxの使い方をお教えします。
