天地有情

Sphinx で epub を生成してみる

Sphinx で epub を生成してみる

ドキュメントツール Sphinx においては,HTML, latex, epub, pdf, texinfo, などが
生成できます.今回は Windows上で epub を生成する手順を説明します.

(注意)
   Sphinx のインストール方法や基本的な使い方は,すでに理解されているものとします.

§1.前準備

epub の実行ファイルの拡張子は .epub です.これをビューするには Viewer が必要です.
以下のサイトから,いずれかを入手してください.

1.アドビシステムズ (Adobe Systems) の DigitalEditions を入手する.

   http://helpx.adobe.com/jp/digital-editions/kb/8409.html


2.アマゾン(Amazon)の KindlePreviewer を入手する.

   http://www.amazon.com/gp/feature.html?docId=1000765261

3.文書ファイル(sample.rst)は予め作成しておく.拡張子は .rst が標準である.

   例えば,[青空文庫]から適当な小説を選び,テキストファイル形式の *.zip を
   ダウンロードし,解凍後に得られた *.txt を *.rst にリネームする.
   なお,文字コードは Shift_JIS になっているので, UTF-8 に変更しておく.

   青空文庫:http://www.aozora.gr.jp/index_pages/index_top.html

§2.作業手順

1.Desktop上に作業ディレクトリ[sample]を作成する.
2.[sample]に移動. コマンドプロセッサ cmd.exe のショートカットを置き,次を実行.

  c:\Users\xxx\Desktop\sample> sphinx-quickstart
    ※ 問い合わせに対して,主に[y,n]で答える.[Enter]キーを押すだけでよいが,
    project名,author名,version番号の3つは入力必須である.
    なお,途中において,次の問い合わせには y とする.
    
    Sphinx can also add configuration for epub output:
    > Do you want to use the epub builder (y/n) [n]: y
    

    ※ 作成済みテキストファイル [sample.rst] を 既存の index.rst に拡張子無しで追記登録する.
  
  c:\Users\xxx\Desktop\sample> make epub

  [sample]以下に _build\epubディレクトリ が作成され,その中に sample.epub ファイルができる.

3.sample.epub をクリックするか,[前準備]で述べた ビュアーに ドラッグドロップ すると オープンします.



   例題に用いた,sample.rst は[学問のすすめ]の一部です.
   
*************************************************************************************************

===============
学問のすすめ
===============

福沢諭吉


初編
=====

「天は人の上に人を造らず人の下に人を造らず」と言えり。されば天より人を生ずるには、万人は万人みな同じ位に
して、生まれながら貴賤《きせん》上下の差別なく、万物の霊たる身と心との働きをもって天地の間にあるよろずの
物を資《と》り、もって衣食住の用を達し、自由自在、互いに人の妨げをなさずしておのおの安楽にこの世を渡らし
め給うの趣意なり。されども今、広くこの人間世界を見渡すに、かしこき人あり、おろかなる人あり、貧しきもあり、
富めるもあり、貴人もあり、下人もありて、その有様雲と泥《どろ》との相違あるに似たるはなんぞや。その次第は
なはだ明らかなり。『実語教《じつごきょう》』に、「人学ばざれば智なし、智なき者は愚人なり」とあり。されば
賢人と愚人との別は学ぶと学ばざるとによりてできるものなり。また世の中にむずかしき仕事もあり、やすき仕事も
あり。そのむずかしき仕事をする者を身分重き人と名づけ、やすき仕事をする者を身分軽き人という。すべて心を
用い、心配する仕事はむずかしくして、手足を用うる力役《りきえき》はやすし。ゆえに医者、学者、政府の役人、
または大なる商売をする町人、あまたの奉公人を召し使う大百姓などは、身分重くして貴き者と言うべし。

*************************************************************************************************
   
   今回は,DigitalEditions でオープンした結果を示します.


epub01x.png

 
 
epub02.png



スポンサーサイト
  1. 2014/07/01(火) 09:11:23|
  2. epub
  3. | トラックバック:0
  4. | コメント:0
<<BXjscls の pdflatex で日本語組版をしてみた | ホーム | wkhtmltopdf の使い方>>

コメント

コメントの投稿


管理者にだけ表示を許可する

トラックバック

トラックバック URL
http://konoyonohana.blog.fc2.com/tb.php/75-b19dc3c0
この記事にトラックバックする(FC2ブログユーザー)