Metadata-Version: 2.1
Name: xml2epub
Version: 1.3
Summary: 将 html链接, html文件 或 html文本 转换成 epub文件，并自动添加封面.
Home-page: https://github.com/dfface/xml2epub
Author: dfface
Author-email: dfface@sina.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# html2epub

## 修改介绍

原项目已经较为成熟 [Html2Epub](https://github.com/zzZ5/Html2Epub) ，此次更改是为了满足自身需求，主要是取消 html string 的清洗：

* html string 通过 `create_chapter_from_string` 的参数 `strict` 控制，`False` 表示不清洗
* xml string中如果包含`<title>封面</title>`或者`<title>cover</title>`，则应该自动生成 epub 文件的封面
* 关于替换静态资源，做的改进是图片的名称由`uuid`改为`md5(url)`

## 简介

原项目为python2项目 [pypub](https://github.com/wcember/pypub) , 此为python3项目, 并进行了些许修改.

将 html链接, html文件 或 html文本 转换成 epub文件.

>**tips**
>
>关于epub文件的格式可以参考 [EPUB - Wikipedia](https://en.wikipedia.org/wiki/EPUB).

## 快速使用

```python
import html2epub

epub = xml2epub.Epub('My First Epub')
chapter = xml2epub.create_chapter_from_url('https://en.wikipedia.org/wiki/EPUB')
epub.add_chapter(chapter)
epub.create_epub('OUTPUT_DIRECTORY')
```

## 参考文献

1. *[wcember/pypub: Python library to programatically create epub files](https://github.com/wcember/pypub).*
2. *[EPUB - Wikipedia](https://en.wikipedia.org/wiki/EPUB).*


