Package: txt2mobi3
Convert Chinese novel txt files into Kindle mobi files. It basically
migratestxt2mobifrom
Python2 to Python3. Since it supports Chinese only, the documentation
and the code comments are written in Chinese.注意：目前只支持两种中文编码：UTF-8和GB2312。此转换工具依赖于Amazon
KindleGen官方转换工具，因此在其Python
package中已包含下载好的分别支持Linux、MacOS和Windows下的三个KindleGen可执行文件。此转换工具会根据当前操作系统来选择相应的KindleGen来调用。1. 安装1.1. 从PyPI安装：$pipinstalltxt2mobi31.2. 从本地安装：$gitclonehttps://github.com/renweizhukov/txt2mobi3.git$cdtxt2mobi3$pipinstall-e.2. 使用命令行工具txt2mobi3_clt可以使用帮助来获得可用的子命令：$./txt2mobi3_clt-husage:txt2mobi3_clt<command>[<args>]可用的子命令如下：init初始化从txt到mobi的转化。在运行其他命令前，该命令应该被执行一次且仅一次。gconf读取从txt到mobi的转化配置。sconf修改从txt到mobi的转化配置。rconf重置从txt到mobi的转化配置。conv进行从txt到mobi的转化。drun预演从txt到mobi的转化。将一个txt转化为一个可被AmazonKindle使用的mobi文件。positionalarguments:command可执行的子命令optionalarguments:-h,--helpshowthishelpmessageandexit注意在Windows
console中运行txt2mobi3_clt时可能需要先执行下面这个chcp命令将code
page设成“UTF-8”，否则无法正确显示其输出的中文字符。chcp 650012.1. 初始化在运行其他命令前，该命令应该被执行一次且仅一次。初始化后会生成配置文件.config.ini。$txt2mobi3_cltinit-husage:txt2mobi3_cltinit[-h]初始化从txt到mobi的转化：(1)创建配置文件.config.ini；(2)下载默认封面图片。optionalarguments:-h,--helpshowthishelpmessageandexit2.2. 读取配置读取.config.ini中的配置。$./txt2mobi3_cltgconf-husage:txt2mobi3_cltgconf[-h][-k][-i][-c][-m]读取从txt到mobi的转化配置：(1)Amazon官方转化工具KindleGen的本地路径；(2)默认封面图片的本地路径；(3)是否划分章节并生成目录；(4)最大章节数。optionalarguments:-h,--helpshowthishelpmessageandexit-k,--kindlegenAmazon官方转化工具KindleGen的本地路径-i,--defcoverimg默认封面图片的本地路径-c,--chapterization划分章节并生成目录-m,--maxchapter最大章节数2.3. 修改配置修改.config.ini中的配置。$./txt2mobi3_cltsconf-husage:txt2mobi3_cltsconf[-h][-kKINDLEGEN][-iDEF_COVER_IMG][-cCHAPTERIZATION][-mMAX_CHAPTER]修改从txt到mobi的转化配置：(1)Amazon官方转化工具KindleGen的本地路径；(2)默认封面图片的本地路径；(3)是否划分章节并生成目录；(4)最大章节数。optionalarguments:-h,--helpshowthishelpmessageandexit-kKINDLEGEN,--kindlegenKINDLEGENAmazon官方转化工具KindleGen的本地路径-iDEF_COVER_IMG,--defcoverimgDEF_COVER_IMG默认封面图片的本地路径-cCHAPTERIZATION,--chapterizationCHAPTERIZATION划分章节并生成目录-mMAX_CHAPTER,--maxchapterMAX_CHAPTER最大章节数2.4. 重置配置将.config.ini中的配置重置为默认配置。$./txt2mobi3_cltrconf-husage:txt2mobi3_cltrconf[-h]重置从txt到mobi的转化配置：(1)Amazon官方转化工具KindleGen的本地路径；(2)默认封面图片的本地路径；(3)是否划分章节并生成目录；(4)最大章节数。optionalarguments:-h,--helpshowthishelpmessageandexit2.5. 进行从txt到mobi的转化将txt文件转化为mobi文件同时也会生成一些中间文件（ncx，opf，html）。$txt2mobi3_cltconv-husage:txt2mobi3_cltconv[-h]-xTXT_FILE-tTITLE[-aAUTHOR][-iCOVER_IMG_FILE][-dDEST_DIR]将一个txt文件转化为mobi：调用KindleGen来生成mobi文件。optionalarguments:-h,--helpshowthishelpmessageandexit-xTXT_FILE,--txtTXT_FILEtxt文件的本地路径-tTITLE,--titleTITLEmobi书的标题-aAUTHOR,--authorAUTHORmobi书的作者（可选项）-iCOVER_IMG_FILE,--coverimgCOVER_IMG_FILE封面图片的本地路径（可选项）-dDEST_DIR,--destDEST_DIRmobi书的输出目录（可选项）例子：$txt2mobi3_cltconv-x海晏_琅琊榜.txt-t琅琊榜-a海宴2.4. 预演从txt到mobi的转化预演将txt文件转化为mobi文件，但并不生成mobi，只生成一些中间文件（ncx，opf，html）。$txt2mobi3_cltdrun-husage:txt2mobi3_cltdrun[-h]-xTXT_FILE-tTITLE[-aAUTHOR][-iCOVER_IMG_FILE][-dDEST_DIR]预演从txt到mobi的转化：生成转化过程中的中间文件但不会调用KindleGen来生成最终的mobi文件。optionalarguments:-h,--helpshowthishelpmessageandexit-xTXT_FILE,--txtTXT_FILEtxt文件的本地路径-tTITLE,--titleTITLEmobi书的标题-aAUTHOR,--authorAUTHORmobi书的作者（可选项）-iCOVER_IMG_FILE,--coverimgCOVER_IMG_FILE封面图片的本地路径（可选项）-dDEST_DIR,--destDEST_DIRmobi书的输出目录（可选项）例子：$txt2mobi3_cltdrun-x海晏_琅琊榜.txt-t琅琊榜-a海宴3. 关于Python3中的UnicodePython3与Python2处理Unicode的方式有很大不同，具体可参考：https://nedbatchelder.com/text/unipain.html4. README.rstREADME.rst is generated from README.md viapandoc.$pandoc--from=markdown--to=rst--output=README.rstREADME.md