# epublib

**Repository Path**: hihopeorg/epublib

## Basic Information

- **Project Name**: epublib
- **Description**: 读取/写入 epub格式文件的核心实现
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 6
- **Created**: 2022-03-09
- **Last Updated**: 2024-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# epublib

## 简介

> Epublib是一个用于读取/写入/操作epub文件的ets库


## 效果展示：
![动画](epublib.jpeg)


## 下载安装

```shell
npm install @ohos/epublib --save
```
OpenHarmony  npm环境配置等更多内容，请参考 [如何安装OpenHarmony npm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md) 。


## 使用说明
### 示例代码
1.在page页面中引入avro
```
import {DOMParser,EpubReader,EpubWriter, Book,Author,EpubResource,MediaType,Metadata,MediatypeService} from "@ohos/epublib"
```
2.使用

```
  funcStart(input: string) {
    console.log("-----funcStart----filePath-----------------" + input)
    let result = EpubReader.readEpub(input);
    if (result != undefined) {
      result.then((book) => {
        this.text = book.getResources()
          .getResourceMap()
          .get("chapter_446465249.xhtml")
          .getStrData()
          .toString();
        console.error("----index-result-------" + this.text)
        this.testEpubWriter(book)

      });
    }
  }

```

## 接口说明
1. 获取Book实例。
` EpubReader.readEpub(inPath:string, encoding?:string, lazyLoadedTypes?: Array<MediaType>):Book`
2. 获取构成该书的所有图像、章节、章节、xhtml文件、样式表等的集合。
   `Book.getResources(): Resources `
3. 获取该书内容。
   `EpubResource.getStrData()`

## 约束与限制

在下述版本验证通过：

- DevEco Studio 版本：3.1 Beta1（3.1.0.200），OpenHarmony SDK:API9（3.2.10.6）

## 目录结构

````
|---- epublib  
|     |---- entry  # 示例代码文件夹
|     |---- epublib   # 电子书库文件夹
|         |---- index.ets 提供外部接口文件    
|             |---- src
|                 |---- main
|                     |---- ets
|                         |---- components
|                             |---- domain # 相关的book一系列数据model
|                             |---- epub   # 解析处理 
|                             |---- service # 定义了支持的媒体类型
|                             |---- util # 通用方法库
|                             |---- Constants.ets # 常量定义
|     |---- README.md  # 安装使用方法                    
````


## 贡献代码

使用过程中发现任何问题都可以提 [Issue](https://gitee.com/hihopeorg/epublib/issues)给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/hihopeorg/epublib/pulls) 。

## 开源协议

本项目基于 [Apache License 2.0](https://gitee.com/hihopeorg/epublib/blob/master/LICENSE) ，请自由地享受和参与开源。