Sphinxをはじめよう 第3版

5章EPUBに変換してみよう

前の章では、Sphinxを使ってドキュメントをPDFに変換する方法を学びました。Sphinxは他にも、文書の配布や閲覧が手軽な電子書籍用のフォーマットであるEPUBへの変換もサポートしています。EPUBは多くの電子書籍リーダが対応しているので、電子辞書やしおりなどの読書向け機能のサポートを受けながら文章を読んでもらうことができます。

本章では技術書を例にEPUBへの変換を行ってみます。まずは 「3.2 プロジェクトの作成 」で説明したように、 sphinx-quickstart コマンドでプロジェクトを作成しましょう。 プロジェクト作成後、以下のテキストを index.rst として保存してください。

============ Sphinxの歴史 ============ .. _beginning: はじまり =========== Sphinxは Georg Brandl というPythonのリリースマネージャーによって2007年の前半に開発がスタートしました。当時のPythonドキュメントはLaTeXで書かれていました。しかし、LaTeXは難解で、ドキュメントを自分から更新したいと言い出すユーザが少なかったようです。 そのため、当時一部で使われていた **reStructuredText** とその実装の **docutils** を使ってコードを書きはじめたのです。 Sphinxという名前について ============================ Sphinxという名前はpython.orgのwebサイトで使用している「pyramid」システムに関連した名前、ということで付けられたようです。当時すでにCMU SphinxやSphinx ...