Difference between revisions of "Epub"

From Wiki
Jump to navigation Jump to search
m (→‎Current Issues: - combine opf fixes)
m (→‎Current Issues: - bundle OPS)
Line 97: Line 97:
 
== Current Issues ==
 
== Current Issues ==
  
As of 00:21, 8 June 2011 (CEST):
+
As of 13:34, 8 June 2011 (CEST):
  
 
<table>
 
<table>
Line 117: Line 117:
 
         <tr>
 
         <tr>
 
               <td>epubreader</td>
 
               <td>epubreader</td>
               <td><code>test.epub</code></td>
+
               <td>OPS 2.0.1</td>
 
               <td>This XML file does not appear to have any style information associated with it.</td>
 
               <td>This XML file does not appear to have any style information associated with it.</td>
 
         </tr>
 
         </tr>
 
         <tr>
 
         <tr>
 
               <td>kindlegen</td>
 
               <td>kindlegen</td>
               <td><code>back-exp.lua</code></td>
+
               <td>OPS 2.0.1</td>
 
               <td>No BODY tag found in content file.</td>
 
               <td>No BODY tag found in content file.</td>
 
         </tr>
 
         </tr>
 
         <tr>
 
         <tr>
 
               <td>kindlegen</td>
 
               <td>kindlegen</td>
               <td><code>test.opf</code></td>
+
               <td>OPS 2.0.1</td>
 
               <td>Cover not specified, [http://s3.amazonaws.com/kindlegen/AmazonKindlePublishingGuidelinesV1.3.pdf amazon]</td>
 
               <td>Cover not specified, [http://s3.amazonaws.com/kindlegen/AmazonKindlePublishingGuidelinesV1.3.pdf amazon]</td>
 
         </tr>
 
         </tr>

Revision as of 11:36, 8 June 2011

ConTeXt has preliminary epub support starting from current 2011.05.18.


In order to make an epub (archive) from your ConTeXt source files, you need to:

  1. enable the export backend in your .tex file or environment file (see Project structure)
  2. call the appropriate mtxrun command (with the epub script) shown in the output of a context run or in the log file


Note: There is no support for graphics yet, that will be included in a later version.

Export

To enable the export backend, depending on your needs, one of the following lines has to be included at the beginning of the document (before \starttext).

\setupbackend[export=yes]
\setupbackend[export=yes,xhtml=yes]
\setupbackend[export=yes,xhtml=whatever.xhtml]
\setupbackend[export=yes,css={whatever.css,somemore.css}]

The backend can export into:

  • xml
  • xhtml
  • xhtml+css


For making an epub, you need an xhtml export.

cld-mkvi

It is also possible to hook css into the output, see thread: ntg-context.

Example:

\setupbackend
   [export=cld-mkiv-export.xml,
    xhtml=cld-mkiv-export.xhtml,
    css={cld-mkiv-export.css,mathml.css}]

Mtxrun

The actual generation of the epub can be triggered with the mtxrun command shown in the output.


Example log entry:

...
backend         > export > saving xml data in 'oeps.export
backend         > export > saving css template in 'oeps.template
backend         > export > saving xhtml variant in 'oeps.xhtml
backend         > export > saving specification in 'oeps.specification' (mtxrun --script epub --make oeps.specification)
...

The "oeps" will be replaced with the appropriate name given to the export backend.


Therefore, execute:

mtxrun --script epub --make oeps.specification

This will create an oeps.tree folder with an oeps.epub inside it.


More on this on the mailing list, thread starts at: ntg-context.

Example

\setupbackend[export=yes,xhtml=test.xhtml]
\starttext
Hello world!
\stoptext

Tools

Viewer:

Editor:

Validation:

Specification:

Current Issues

As of 13:34, 8 June 2011 (CEST):

tool description error
mtx-epub.lua OPF 2.0.1 bookid & ncx fix
epubcheck-1.2 OPS 2.0.1 test.xhtml: <document>
elements from namespace "" are not allowed
xhtml DOCTYPE missing, html + body elements
epubreader OPS 2.0.1 This XML file does not appear to have any style information associated with it.
kindlegen OPS 2.0.1 No BODY tag found in content file.
kindlegen OPS 2.0.1 Cover not specified, amazon


feature description
id field sort out id name from specs, xhtml name, 3.0 draft, uuid
cover add cover element
toc table of contents is missing
chapter break new title element → new xhtml
graphics include graphics