Changes

{{todo|This page is meant work in progress and an update to replace the current pages [[Epub]] and [[Epub_Sample]].}}

< [[XML]] | [[HTMLExport]] | [[Epub|Old ePub docs]] | [[Epub_Sample|Old ePub Sample]] >

Beware, these The ePub/HTML facilities of ConTeXt work only with MkIV since some version in December 2014 and require additional work are based on its [[Export]] of XML/XHTML. Make sure you get useful export output from your source code!project before you try ePub.

= Minimal example Documentation about ePub =

<texcode>* [https://en.wikipedia.org/wiki/EPUB Wikipedia entry] with some examples* [http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm Open Packaging Format] (OPF) 2.0.1 specs; contains also information about NCX* [https://www.iso.org/standard/53255.html ePub3 ISO/IEC TS 30135-1:2014] (Buy specs for 118 CHF?)\setupbackend* [export=yeshttps://github.com/w3c/epubcheck ePub Check]validator (most validation tools are based on this)

If you compile thisalready ran ConTeXt on your project and got the file structure as described in [[Export]], you can run {{code|1=mtxrun --script epub --make minimal}} to get ...a structure like:

* .epub: The export epub file is just a zipped version of the directory structure.* mimetype: contains usable content only for content that is "well structured{{code|1=application/epub+zip}}" in an XML sense* container. That means, you need xml points to mark everythingthe root file "minimal.opf"* cover.xhtml is the cover image shown by ePub readers* -div.xhtml: your content* .opf: list of all resources, from markup spans over paragraphs and enumeration items to chapters and parts with <tex>startthis keeps the "book" together.See also [http://www.idpf.<org/epub/20/spec/tex> <tex>stopOPF_2.0.1_draft.</tex>htm OPF specs].* .ncx: table of contents

<texcode>...\startsection[title={A section}]Compressing the structure =

\startitemize[packed* <tt>mimetype</tt> must be the first directory entry of the archive.* You must not use "extra file attributes",joinup]\startitem \stopitem\startitem \stopitem\startitem \stopitem\startitem \stopiteme.g. from macOS (AKA resource forks) or NTFS; use the X parameter of zip.\stopitemize* You don’t want some other lurking files like macOS’s <tt>.DS_Store</tt> directory information or PDF images; exclude them from recursive packaging.

\stopsectionWrite about...* Cover</texcode>* ToC* Readers= Minimal useful example =* Styling* Images<texcode>\setupbackend[export=yes]\setupmainlanguage[en] \starttext \startparagraph\input tufte\stopparagraph \stoptext</texcode>* Better workflow