rbook 0.7.1

A fast, format-agnostic, ergonomic ebook library for reading, building, and editing EPUB 2 and 3.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

use crate::ebook::epub::consts::{opf, xml};
use crate::ebook::epub::manifest::EpubManifestEntryData;
use crate::ebook::epub::write::writer::package::PackageWriter;
use crate::ebook::epub::write::writer::toc::TocData;
use crate::ebook::resource::consts::mime;
use crate::writer::WriterResult;
use crate::writer::xml::write_element;
use std::io::Write;

impl<W: Write> PackageWriter<'_, W> {
    pub(super) fn write_manifest(&mut self) -> WriterResult<()> {
        let entries = &self.ctx.epub.manifest.entries;

        write_element! {
            writer: self.writer,
            tag: opf::MANIFEST,
            inner_content: {
                for (id, entry) in entries {
                    self.write_item(id, entry)?;
                }
                self.write_generated_toc_items()?;
            }
        }
    }

    fn write_item(&mut self, id: &str, item: &EpubManifestEntryData) -> WriterResult<()> {
        let supported = self.ctx.supports_epub3();

        write_element! {
            writer: self.writer,
            tag: opf::ITEM,
            attributes: {
                xml::ID            => id,
                opf::HREF          => &*self.resolver.relativize(&item.href),
                opf::MEDIA_TYPE    => item.media_type.as_str(),
                opf::FALLBACK      => item.fallback.as_deref(),

                // EPUB 3 attributes
                opf::MEDIA_OVERLAY where supported => item.media_overlay.as_deref(),
                opf::PROPERTIES    where supported => item.properties.as_option_str(),

                ..item.attributes.iter_key_value(),
            }
        }
    }

    fn write_generated_toc_items(&mut self) -> WriterResult<()> {
        // EPUB 2 NCX ToC
        if let Some(ncx) = &self.ctx.toc.epub2_ncx
            && ncx.is_generated
        {
            self.write_generated_toc_item(ncx, mime::NCX, &[])?;
        }
        // EPUB 3 NAV XHTML ToC
        if let Some(nav) = &self.ctx.toc.epub3_nav
            && nav.is_generated
        {
            self.write_generated_toc_item(
                nav,
                mime::XHTML,
                &[(opf::PROPERTIES, opf::NAV_PROPERTY)],
            )?;
        }
        Ok(())
    }

    fn write_generated_toc_item(
        &mut self,
        toc: &TocData<'_>,
        media_type: &str,
        attributes: &[(&str, &str)],
    ) -> WriterResult<()> {
        write_element! {
            writer: self.writer,
            tag: opf::ITEM,
            attributes: {
                xml::ID         => &*toc.id,
                opf::HREF       => &*self.resolver.relativize(&toc.location),
                opf::MEDIA_TYPE => media_type,
                ..attributes.iter().copied(),
            }
        }
    }
}