EPUB: Difference between revisions

(11 intermediate revisions by the same user not shown)

Line 2:

==Contents==

* There must be a file <tt>~~metadata~~</tt> in the toplevel containing the string <tt>application/epub+zip</tt>

* There must be a file <tt>mimetype</tt> in the toplevel containing the string <tt>application/epub+zip</tt>

* There must be a directory <tt>META-INF</tt> in the toplevel containing:

** <tt>container.xml</tt> specifies one or more ''rootfiles'', using their locations relative to the toplevel:

<pre>

<?xml version="1.0"?>

</rootfiles>

</container>

</pre>

==EPUB-specific markup==

Ensure you've referenced <tt>xmlns:epub="http://www.idpf.org/2007/ops</tt> in your <tt>html</tt> tag.

When using reflowable EPUB, there's no real concept of a page, and thus no real concept of footnotes. One can move them to the end of a chapter, but an arguably better solution is a popup. Enclose the footnote text in an <tt>aside</tt> tag ala:

<div class="footnote"><a href="#CALLSITE">*</a>Footnote text.</div>

</aside>

</syntaxhighlight>

Use of <tt>epub:type="footnote"</tt> ought result in the text being hidden, but you might need <tt>hidden="hidden"</tt> in your <tt>aside</tt> tag. Unfortunately, this latter causes problems with the popup text in Calibre (at least version 7.4).

Wrap the callsite with an <tt>a</tt> tag:

<a role="doc-noteref" epub:type="noteref" href="#SOMEID" id>Callsite text.</a>

</syntaxhighlight>

Without <tt>role="doc-noteref"</tt>, you will not get a popup in Calibre.

===Entities===

EPUB3 eliminates all but a few HTML entitites.

* &nbsp; ↦ &#160;

==See also==

* [https://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines.pdf Kindle Publishing Guidelines] from Amazon

@@ Line 2: / Line 2: @@
 ==Contents==
-* There must be a file <tt>metadata</tt> in the toplevel containing the string <tt>application/epub+zip</tt>
+* There must be a file <tt>mimetype</tt> in the toplevel containing the string <tt>application/epub+zip</tt>
+* There must be a directory <tt>META-INF</tt> in the toplevel containing:
+** <tt>container.xml</tt> specifies one or more ''rootfiles'', using their locations relative to the toplevel:
+<pre>
+<?xml version="1.0"?>
+<container xmlns="urn:oasis:names:tc:opendocument:xmlns:container" version="1.0">
+ <rootfiles>
+  <rootfile full-path="PATHPATHPATH" media-type="application/oebps-package+xml"/>
+ </rootfiles>
+</container>
+</pre>
+==EPUB-specific markup==
+Ensure you've referenced <tt>xmlns:epub="http://www.idpf.org/2007/ops</tt> in your <tt>html</tt> tag.
+When using reflowable EPUB, there's no real concept of a page, and thus no real concept of footnotes. One can move them to the end of a chapter, but an arguably better solution is a popup. Enclose the footnote text in an <tt>aside</tt> tag ala:
+<syntaxhighlight lang="html">
+<aside hidden="hidden" epub:type="footnote" id="SOMEID">
+ <div class="footnote"><a href="#CALLSITE">*</a>Footnote text.</div>
+</aside>
+</syntaxhighlight>
+Use of <tt>epub:type="footnote"</tt> ought result in the text being hidden, but you might need <tt>hidden="hidden"</tt> in your <tt>aside</tt> tag. Unfortunately, this latter causes problems with the popup text in Calibre (at least version 7.4).
+Wrap the callsite with an <tt>a</tt> tag:
+<syntaxhighlight lang="html">
+<a role="doc-noteref" epub:type="noteref" href="#SOMEID" id>Callsite text.</a>
+</syntaxhighlight>
+Without <tt>role="doc-noteref"</tt>, you will not get a popup in Calibre.
+===Entities===
+EPUB3 eliminates all but a few HTML entitites.
+* &amp;nbsp; ↦ &amp;#160;
+==See also==
+* [https://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines.pdf Kindle Publishing Guidelines] from Amazon

Dank (talk | contribs)