Manga-Downloader 技术文档

1. 安装指南

依赖项

• Python 2.6+，包括 3.x 版本。
• 如果需要使用 Kindle 转换功能，需要安装 PIL（Python Imaging Library）。

安装步骤

1. 确保系统中已安装 Python 2.6 或更高版本。
2. 下载 Manga-Downloader 项目源码。
3. 安装所需的依赖项：
   • 对于 Python 2.x 版本，可以使用 pip install Pillow 安装 PIL。
   • 对于 Python 3.x 版本，PIL 已经被 Pillow 替代，同样使用 pip install Pillow 安装。

2. 项目的使用说明

基本用法

manga.py [options] <manga name> <manga name> <etc.>

• 运行脚本时，系统会提供三个漫画网站的选择，按下回车键默认选择第一个网站。
• 选择网站后，脚本会列出该系列在所选网站上的所有章节。
• 当提示“下载哪些章节？”时，可以输入用 - 和 , 分隔的章节号，或者输入 all 下载所有章节。

示例

• manga.py -d "C:\Documents and Settings\admin\Documents\Manga\" -z Bleach：在 Windows 机器上下载 'Bleach' 到指定目录，使用 .zip 压缩。
• ./manga.py --overwrite Bleach：在 Linux/Unix 机器上下载 'Bleach' 到当前目录，使用 .cbz 压缩并覆盖之前下载的章节。
• 1,2,9-12：下载章节 1、2 和 9 到 12。
• all：下载所有章节。
• ./manga.py -x example.xml：解析 example.xml 文件并运行脚本。

3. 项目API使用文档

选项说明

• --version：显示程序版本号并退出。
• -h, --help：显示帮助信息并退出。
• --all：下载所有可用章节。
• -d <download path>, --directory=<download path>：指定下载目录，默认为以漫画名称命名的目录。
• --overwrite：覆盖之前下载的章节。
• -t <number>, --threads=<number>：限制章节线程数，默认值为 3。
• --verbose：详细输出。
• -x <xmlfile path>, --xml=<xmlfile path>：解析 .xml 文件并下载所有新章节。
• -z, --zip：使用 .zip 压缩下载，默认使用 .cbz。
• -c, --convertFiles：将下载的文件转换为指定设备可接受的格式和大小。
• --device：指定目标设备进行图像转换。
• --convertDirectory：转换指定目录中的图像文件。
• --inputDirectory：指定包含待转换图像的目录。
• --outputDirectory：指定存储转换后图像的目录，默认为 DOWNLOAD_PATH/Pictures。
• -k <number of chapters in tankoubon>, --tankoubon=<number of chapters in tankoubon>：创建包含多个章节的卷文件，并指定每卷的章节数，默认值为 1（不创建卷文件）。
• --cleanChapters：如果指定了 -k，则在创建卷文件后删除单个章节文件，默认值为 False。

4. 项目安装方式

源码安装

1. 克隆或下载项目源码：

   git clone https://github.com/jiaweihli/manga_downloader.git
   

2. 进入项目目录：

   cd manga_downloader
   

3. 安装依赖项：

   pip install -r requirements.txt
   

直接运行

1. 确保 Python 已正确安装。
2. 直接运行 manga.py 脚本：

   python manga.py [options] <manga name>
   

通过以上步骤，您可以顺利安装并使用 Manga-Downloader 项目。