epub 패키지는 서버, 웹 및 플러터 환경에서 작동하도록 설계된 EPUB 파일을 파싱하고 읽기 위한 Dart 라이브러리입니다. 개발자가 프로그래밍적으로 EPUB 문서의 콘텐츠, 메타데이터 및 구조를 추출할 수 있게 해줍니다. 패키지는 표준 EPUB 형식을 지원하며 장, 이미지, 스타일링 정보에 대한 접근을 제공합니다. 전자책 처리가 필요한 애플리케이션, 예를 들어 리더, 변환기 또는 콘텐츠 관리 시스템에 적합합니다.
This does not rely on the dart:io package in any way, so it is avilable for both desktop and web-based implementations
Installing
Add the package to the dependencies section of your pubspec.yaml
dependencies:epub:^2.0.0
Example
//Get the epub into memory somehowString fileName = "hittelOnGoldMines.epub";
String fullPath = path.join(io.Directory.current.path, fileName);
var targetFile = new io.File(fullPath);
List<int> bytes = await targetFile.readAsBytes();
// Opens a book and reads all of its content into memoryEpubBook epubBook = awaitEpubReader.readBook(bytes);
// COMMON PROPERTIES// Book's titleString title = epubBook.Title;
// Book's authors (comma separated list)String author = epubBook.Author;
// Book's authors (list of authors names)List<String> authors = epubBook.AuthorList;
// Book's cover image (null if there is no cover)Image coverImage = epubBook.CoverImage;
// CHAPTERS// Enumerating chapters
epubBook.Chapters.forEach((EpubChapter chapter) {
// Title of chapterString chapterTitle = chapter.Title;
// HTML content of current chapterString chapterHtmlContent = chapter.HtmlContent;
// Nested chaptersList<EpubChapter> subChapters = chapter.SubChapters;
});
// CONTENT// Book's content (HTML files, stlylesheets, images, fonts, etc.)EpubContent bookContent = epubBook.Content;
// IMAGES// All images in the book (file name is the key)Map<String, EpubByteContentFile> images = bookContent.Images;
EpubByteContentFile firstImage = images.values.first;
// Content type (e.g. EpubContentType.IMAGE_JPEG, EpubContentType.IMAGE_PNG)EpubContentType contentType = firstImage.ContentType;
// MIME type (e.g. "image/jpeg", "image/png")String mimeContentType = firstImage.ContentMimeType;
// HTML & CSS// All XHTML files in the book (file name is the key)Map<String, EpubTextContentFile> htmlFiles = bookContent.Html;
// All CSS files in the book (file name is the key)Map<String, EpubTextContentFile> cssFiles = bookContent.Css;
// Entire HTML content of the book
htmlFiles.values.forEach((EpubTextContentFile htmlFile) {
String htmlContent = htmlFile.Content;
});
// All CSS content in the book
cssFiles.values.forEach((EpubTextContentFile cssFile){
String cssContent = cssFile.Content;
});
// OTHER CONTENT// All fonts in the book (file name is the key)Map<String, EpubByteContentFile> fonts = bookContent.Fonts;
// All files in the book (including HTML, CSS, images, fonts, and other types of files)Map<String, EpubContentFile> allFiles = bookContent.AllFiles;
// ACCESSING RAW SCHEMA INFORMATION// EPUB OPF dataEpubPackage package = epubBook.Schema.Package;
// Enumerating book's contributors
package.Metadata.Contributors.forEach((EpubMetadataContributor contributor){
String contributorName = contributor.Contributor;
String contributorRole = contributor.Role;
});
// EPUB NCX dataEpubNavigation navigation = epubBook.Schema.Navigation;
// Enumerating NCX metadata
navigation.Head.Metadata.forEach((EpubNavigationHeadMeta meta){
String metadataItemName = meta.Name;
String metadataItemContent = meta.Content;
});
// Writing Datavar written = awaitEpubWriter.writeBook(epubBook);
// You can even re-read the book into a new object! var bookRoundTrip = awaitEpubReader.readBook(written);