KindleGen與Markdown轉換為Mobi的Kindle電子書工具：m2m.exe

自從使用Kindle當做閱讀網路小說的主要工具後，經常都要使用Calibre來將HTML檔轉換成Kindle支援的Mobi檔（參考：使用Calibre轉換TXT電子書(含目錄)並傳送至Kindle Paperwhite操作全攻略），但Calibre在轉換較大檔案時（其實也不過10多MB而已）卻要花費許多時間，少則半小時，多則40、50分鐘以上，通常就中斷轉換，直接使用文字格式了，缺點當然就是沒有目錄，降低了閱讀品質。最終搜尋到了亞馬遜用來編寫Kindle標準文件的工具：KindleGen，藉由KindleGen我們就能更方便的來控制要產生的電子書了。m2m.exe則是我寫來簡化製作Kindle電子書的小工具。

KindleGen需要的檔案

KindleGen是一個命令行指令，執行時會讀取下列檔案，依.opf檔的控制來產生Mobi檔：

KindleGen參數

在命令提示字元視窗執行kindlegen.exe就能開始編寫書籍：

cd \util\kindlegen
kindlegen.exe  mybook.opf

執行過程會顯示在DOS視窗裡，若有錯誤訊息而中斷執行，則再去修改相關檔案後再次執行即可。執行時有下列參數可用：

To convert an EPUB or HTML book to the Kindle Format 8, use KindleGen version 2 or higher as 
described below:

kindlegen filename.opf/.htm/.html/.epub [-c0 or -c1 or c2] [-verbose] [-western] [-o 
<file name>]

Note:
zip formats are supported for XMDF and FB2 sources
directory formats are supported for XMDF sources
Options:
-c0: no compression
-c1: standard DOC compression
-c2: Kindle huffdic compression (recommended for large, text-heavy files)
-o <file name>: Specifies the output file name. Output file will be created in the 
same directory as that of input file. <file name> should not contain directory path.
-verbose: provides more information during ebook conversion
-western: force build of Windows-1252 book
-releasenotes: display release notes
-gif: images are converted to GIF format (no JPEG in the book)
-locale 執行時顯示訊息的語系，如en或zh （只有簡體中文）

由以上說明可知，kindlegen.exe不只接受 .opf檔，也能使用.htm、.html或.epub，但本文只使用了.opf檔。詳細的參數說明請參考 Amazon Kindle Publishing Guidelines — How to make books available for the Kindle platform 第十頁。

NCX檔與OPF檔

上述原始檔案比較特別的是.ncx與.opf檔，二者皆為XML格式，簡述如下。

.ncx用來產生Kindle裡的目錄的樹狀控制，沒有這個控制就不像在看電子書。重要的標籤範例如下，範例裡建了三個導航點：目錄、第一卷與第一章，目錄與第一卷在第一層，第一章在第二層。每個導航點都有依序排列的playOrder與點擊後的錨點位置：

<navMap>
  <navPoint class="toc" id="toc" playOrder="0">
    <navLabel>
      <text>目錄</text>
    </navLabel>
    <content src="toc.html"/>
  </navPoint>

  <navPoint class="welcome" id="welcome" playOrder="1">
    <navLabel>
    <text>第一卷 第一卷標題</text>
    </navLabel>
    <content src="mybook.html#SECTION_1"/>
    <navPoint class="welcome" id="welcome" playOrder="2">
      <navLabel>
      <text>第一章 第一章標題</text>
      </navLabel>
      <content src="mybook.html#SECTION_2"/>
    </navPoint>

.opf主要由４大部份組成：

mybook.opf範例：

<?xml version="1.0"?>
<package version="2.0" xmlns="http://www.idpf.org/2007/opf" unique-identifier="BookId">

  <metadata xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:opf="http://www.idpf.org/2007/opf">
    <dc:title>我的電子書</dc:title>
    <dc:language>zh-TW</dc:language>
    <dc:identifier id="BookId" opf:scheme="ISBN">123456789Y</dc:identifier>
    <dc:creator opf:file-as="(未知)" opf:role="aut">(未知)</dc:creator>
    <dc:publisher>Jerry</dc:publisher>
    <dc:subject>我的電子書</dc:subject>
    <dc:date>2015-08-29</dc:date>
    <dc:description>我的電子書</dc:description>
    <meta name="cover" content="my-cover-image" />
  </metadata>
 
  <manifest>
    <item id="tc" properties="nav" href="toc.html" media-type="application/xhtml+xml"/>
    <item id="book" href="mybook.html" media-type="application/xhtml+xml"/>
    <item id="stylesheet" href="style.css" media-type="text/css"/>
    <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>
    <item id="my-cover-image" href="mybook.jpg" media-type="image/jpeg" />
  </manifest>
 
  <!-- Each itemref references the id of a document designated in the manifest. The order of the itemref elements organizes the associated content files into the linear reading order of the publication.  -->
  <spine toc="ncx">
    <itemref idref="tc" />
    <itemref idref="book" />
  </spine>
 
  <!-- The Kindle reading system supports two special guide items which are both mandatory.
  type="toc" [mandatory]: a link to the HTML table of contents
  type="text" [mandatory]: a link to where the content of the book starts (typically after the front matter) -->
  <guide>
    <reference type="toc" title="Table of Contents" href="toc.html"/>
    <reference type="text" title="Beginning" href="mybook.html"></reference>
  </guide> 
</package>

M2M：將Markdown轉換為Mobi的工具

為了方便產生KindleGen需要的檔案，我花了一兩天閑暇時間以Lazarus寫了一個小工具m2m：Markdown to Mobi，只要指定好要使用的文字檔（Markdown格式）後就能產生所有需要的檔案並叫用KindleGen產生.Mobi檔：

m2m.exe的使用方法很簡單，指定好文字檔後再依1、2、3的順序點擊按鈕就可以了。檢視Mobi檔可以下載Kindle Previewer，再把.mobi的預設應用程式設定為Kindle Previewer。

• m2m下載：https://goo.gl/dvwFiM
• KindleGen下載：Amazon的下載點；kindlegen有新版時可由此更新
• Kindle Previewer下載：Amazon的下載點

Markdown檔製作要點

Markdown文字檔編碼必須是UTF-8不帶BOM，通常只要再加上章節開頭的標題符號，第一層標題用一個半形井字號，第二層標題用兩個半形井字號，如果全文只有一層就用兩個半形井字號，如：

文字檔裡的空行不用處理，轉出HTML檔時會全部被濾掉，每個段落在HTML裡會被夾在<p>…</p>裡。因受限於Kindle，目錄階層最多兩層。

M2M操作要點

1. m2m.exe依template.ncx、template.opf等樣板檔來產生原始檔，有特殊需求時可自行修改樣板檔，讓系統產生出不同內容的檔案。
2. 【第二層最多項目數】用在文本只有一層標題的狀況，系統自動依此數目插入第一層標題，例如全文有1000章， 系統會產生成 第1部份 (第二層是第1章到第20章）、第2部份 (第二層是第21章到第40章），方便章節切換。
3. 〔2.產生設定檔案〕執行後最好檢視一下toc.html，以確認自已製作的Markdown章節有正確的產生出來，若看到錯誤，則可以按書籍檔名右方的編輯按鈕進入編輯，書籍檔修改後必須再按〔1.讀檔〕重新讀入新的內容
4. 〔3.產生Mobi檔〕若彈出的kindlegen.exe有錯誤訊息，依訊息修改相關檔案。例如出現toc.html不為UTF-8編碼訊息，則打開toc.html找看看錯誤並修正。
5. 〔3.產生Mobi檔〕進行到產生最後卻出現無法產生Mobi檔：同樣的原始檔有時kindlegen無法產生檔案，請再重覆執行幾次看看，或直接在DOS視窗執行mybook.bat。
6. KindleGen使用 -c2 壓縮選項時失敗率較高，但能產生較小檔案。
7. 修改mybook.opf將封面圖片設定刪掉可讓Kindle產生預設的封面。
8. 最後以Kindow Previewer查看Mobi檔的內容是否一切正確。先看本文、封面，再看目錄內容和NCX。

相關連結

• m2m下載：https://goo.gl/dvwFiM
• KindleGen下載：Amazon的下載點；kindlegen有新版時可由此更新
• Kindle Previewer下載：Amazon的下載點

＃＃

您可能也會有興趣的類似文章

• Kindle Paperwhite新手入門簡易操作說明 (0則留言, 2014/12/28)
• 使用Calibre轉換TXT電子書(含目錄)並傳送至Kindle Paperwhite操作全攻略 (0則留言, 2015/01/02)
• 使用「長篇小說網頁擷取程式」產生電子書 (0則留言, 2015/08/03)
• 亞馬遜 Kindle網站終於有一丁點進步… (0則留言, 2015/02/17)
• 使用JNovelDownloader擷取卡提諾與伊莉的電子書 (0則留言, 2015/08/05)
• 伊藤穰一：把部落格「Google」化 (2005/07 e天下雜誌) (0則留言, 2005/09/12)
• 第一個jqGrid範例：Local array (1則留言, 2010/02/13)
• [Xuite] 自由欄位設定的問題 (4則留言, 2005/04/16)
• 用jQuery改造WordPress網頁 (2則留言, 2009/10/27)
• Zen Coding：HTML網頁快速編寫利器 (0則留言, 2013/04/17)
• 可取代Evernote的為知筆記（WizNote） (3則留言, 2015/01/18)
• WordPress瀏覽圖片的FancyBox外掛 (8則留言, 2010/07/10)
• [Database] Aqua Data Studio 4.0.2推出 (0則留言, 2005/02/23)
• 第一個附中的「畢業」書包 (3則留言, 2006/05/21)
• Dropbox服務四之一：使用DropboxAutomator自動化你的Dropbox (0則留言, 2012/04/28)