txt2mobi3 0.2.3

Convert Chinese novel txt files into Kindle mobi files.

Convert Chinese novel txt files into Kindle mobi files. It basically migrates txt2mobi3 from Python2 to Python3. Since it supports Chinese only, the documentation and the code comments are written in Chinese.

注意：

1. 目前只支持两种中文编码：UTF-8和GB2312。

2. 此转换工具依赖于Amazon KindleGen官方转换工具，因此在其Python package中已包含下载好的分别支持Linux、MacOS和Windows下的三个KindleGen可执行文件。此转换工具会根据当前操作系统来选择相应的KindleGen来调用。

1. 安装

1.1. 从PyPI安装：

$ pip install txt2mobi3

1.2. 从本地安装：

$ git clone https://github.com/renweizhukov/txt2mobi3.git
$ cd txt2mobi3
$ pip install -e .

2. 使用命令行工具txt2mobi3_clt

可以使用帮助来获得可用的子命令：

$ ./txt2mobi3_clt -h
usage: txt2mobi3_clt <command> [<args>]

    可用的子命令如下：
        init    初始化从txt到mobi的转化。在运行其他命令前，该命令应该被执行一次且仅一次。
        config  配置从txt到mobi的转化。
        conv    进行从txt到mobi的转化。
        dryrun  预演从txt到mobi的转化。


将一个txt转化为一个可被Amazon Kindle使用的mobi文件。

positional arguments:
  command     可执行的子命令

optional arguments:
  -h, --help  show this help message and exit

注意在Windows console中运行txt2mobi3_clt时可能需要先执行下面这个chcp命令将code page设成“UTF-8”，否则无法正确显示其输出的中文字符。

chcp 65001

2.1. 初始化

在运行其他命令前，该命令应该被执行一次且仅一次。初始化后会生成配置文件.config.ini。

$ txt2mobi3_clt init

2.2. 修改配置

修改.config.ini中的配置。

$ ./txt2mobi3_clt config -h
usage: txt2mobi3_clt [-h] [-k KINDLEGEN] [-i DEF_COVER_IMG]
                     [-c CHAPTERIZATION] [-m MAX_CHAPTER]

配置从txt到mobi的转化：

    (1) 设置Amazon官方转化工具KindleGen的本地路径；
    (2) 设置默认封面图片的本地路径；
    (3) 设置是否划分章节并生成目录；
    (4) 设置最大章节数。


optional arguments:
  -h, --help            show this help message and exit
  -k KINDLEGEN, --kindlegen KINDLEGEN
                        Amazon官方转化工具KindleGen的本地路径
  -i DEF_COVER_IMG, --defcoverimg DEF_COVER_IMG
                        默认封面图片的本地路径
  -c CHAPTERIZATION, --chapterization CHAPTERIZATION
                        划分章节并生成目录
  -m MAX_CHAPTER, --maxchapter MAX_CHAPTER
                        最大章节数

2.3. 进行从txt到mobi的转化

将txt文件转化为mobi文件同时也会生成一些中间文件（ncx，opf，html）。

$ txt2mobi3_clt conv -h
usage: txt2mobi3_clt [-h] -x TXT_FILE -t TITLE [-a AUTHOR] [-i COVER_IMG_FILE]
                     [-d DEST_DIR]

将一个txt文件转化为mobi：

    调用KindleGen来生成mobi文件。


optional arguments:
  -h, --help            show this help message and exit
  -x TXT_FILE, --txt TXT_FILE
                        txt文件的本地路径
  -t TITLE, --title TITLE
                        mobi书的标题
  -a AUTHOR, --author AUTHOR
                        mobi书的作者（可选项）
  -i COVER_IMG_FILE, --coverimg COVER_IMG_FILE
                        封面图片的本地路径（可选项）
  -d DEST_DIR, --dest DEST_DIR
                        mobi书的输出目录（可选项）

例子：

$ txt2mobi3_clt conv --txt 海晏_琅琊榜.txt --title 琅琊榜 --author 海宴

2.4. 预演从txt到mobi的转化

预演将txt文件转化为mobi文件，但并不生成mobi，只生成一些中间文件（ncx，opf，html）。

$ txt2mobi3_clt dryrun -h
usage: txt2mobi3_clt [-h] -x TXT_FILE -t TITLE [-a AUTHOR] [-i COVER_IMG_FILE]
                     [-d DEST_DIR]

预演从txt到mobi的转化：

    生成转化过程中的中间文件但不会调用KindleGen来生成最终的mobi文件。


optional arguments:
  -h, --help            show this help message and exit
  -x TXT_FILE, --txt TXT_FILE
                        txt文件的本地路径
  -t TITLE, --title TITLE
                        mobi书的标题
  -a AUTHOR, --author AUTHOR
                        mobi书的作者（可选项）
  -i COVER_IMG_FILE, --coverimg COVER_IMG_FILE
                        封面图片的本地路径（可选项）
  -d DEST_DIR, --dest DEST_DIR
                        mobi书的输出目录（可选项）

例子：

$ txt2mobi3_clt dryrun --txt 海晏_琅琊榜.txt --title 琅琊榜 --author 海宴

3. 关于Python3中的Unicode

Python3与Python2处理Unicode的方式有很大不同，具体可参考：

https://nedbatchelder.com/text/unipain.html

4. README.rst

README.rst is generated from README.md via pandoc.

$ pandoc --from=markdown --to=rst --output=README.rst README.md