summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/tex4ebook/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-07-26 20:31:33 +0000
committerKarl Berry <karl@freefriends.org>2021-07-26 20:31:33 +0000
commitc38f2e3735eb97eaf74132a87ca64c6980519265 (patch)
treebcb896190dc5ce20972e2d10339d5d26aa01bc1e /Master/texmf-dist/doc/support/tex4ebook/README
parent1a474c651eb1c2b83dd97da9e49738c391ebbee4 (diff)
tex4ebook (26jul21)
git-svn-id: svn://tug.org/texlive/trunk@60083 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/tex4ebook/README')
-rw-r--r--Master/texmf-dist/doc/support/tex4ebook/README61
1 files changed, 56 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/support/tex4ebook/README b/Master/texmf-dist/doc/support/tex4ebook/README
index 3634974ab82..f87bd02f422 100644
--- a/Master/texmf-dist/doc/support/tex4ebook/README
+++ b/Master/texmf-dist/doc/support/tex4ebook/README
@@ -46,7 +46,17 @@ But it is optional. You shouldn't need to modify your \TeX\ files
## Available commands
-- `\coverimage{coverimage.name}` - include cover image to the document.
+- `\coverimage[<graphicx options>]{coverimage.name}` - include cover image to
+ the document. You can pass the same options as to `\includegraphics` command
+ in the optional argument.
+
+For example:
+
+ \thispagestyle{empty}
+ \begin{document}
+ \coverimage[scale=0.8]{coverimage.name} % include scaled cover image
+ ...
+ \pagestyle{headings}
# Command line options
@@ -212,6 +222,42 @@ Add item to `<manifest>` section in the `OPF` file.
Add `XML` name space to the generated `XHTML` files. Useful in `EPUB 3`.
+### Example config file
+
+ \Preamble{xhtml}
+ \begin{document}
+ \Configure{DocumentLanguage}{de}
+ % Use following lines if your document has ISBN:
+ % \Configure{OpfScheme}{ISBN}
+ % \Configure{UniqueIdentifier}{3-0000-1111-X}
+ % Another possibility is URI that points for example to the ebook homepage:
+ \Configure{OpfScheme}{URI}
+ \Configure{UniqueIdentifier}
+ {https://de.wikipedia.org/wiki/Der_achte_Sch&ouml;pfungstag}
+ \Configure{CoverMimeType}{image/jpeg}
+ % If you don't use \coverimage in the document text,
+ % add cover image using this command:
+ \CoverMetadata{coverimage.jpg}
+ % You can also add more authors to your ebook metadata:
+ \Configure{OpfMetadata}
+ {\HCode{<dc:publisher>Deutscher Bücherbund</dc:publisher>}}
+ \Configure{OpfMetadata}
+ {\HCode{<dc:contributor>Image Artist</dc:contributor>}}
+ \Configure{OpfMetadata}
+ {\HCode{<dc:contributor>Trans Lator</dc:contributor>}}
+ \Configure{OpfMetadata}
+ {\HCode{<dc:date opf:event='original-publication'>1888</dc:date>}}
+ \EndPreamble
+
+Remarks:
+
+- Leading percent signs in the `.cfg` file introduce comments
+- If the unique identifier is a URI which contains diacritical characters, the
+ equivalent HTML code needs to be inserted. `UTF8` is not recognized at that place.
+- `UTF8` characters may be used in the `OpfMetadata` sections.
+
+
+
## Commands available in the config file
@@ -229,6 +275,7 @@ Add `XML` name space to the generated `XHTML` files. Useful in `EPUB 3`.
*Where do you start an ePUB and what is the `<guide>` section of the `.OPF` file?*^[http://epubsecrets.com/where-do-you-start-an-epub-and-what-is-the-guide-section-of-the-opf-file.php]
for some details. Note that `<guide>` is deprecated in `EPUB 3`.
+
## Build files
`tex4ebook` uses `make4ht`^[https://github.com/michal-h21/make4ht] as a build
@@ -254,10 +301,14 @@ See the `make4ht` documentation for an example and more information.
The basic support for the Fixed layout EPUB 3 can be enabled using the following configurations:
- \Configure{OpfMetadata}{\HCode{<meta property="rendition:layout">pre-paginated</meta>}}
- \Configure{OpfMetadata}{\HCode{<meta property="rendition:orientation">landscape</meta>}}
- \Configure{OpfMetadata}{\HCode{<meta property="rendition:spread">none</meta>}}
- \Configure{@HEAD}{\HCode{<meta name="viewport" content="width=1920, height=1080"/>\Hnewline}}
+ \Configure{OpfMetadata}
+ {\HCode{<meta property="rendition:layout">pre-paginated</meta>}}
+ \Configure{OpfMetadata}
+ {\HCode{<meta property="rendition:orientation">landscape</meta>}}
+ \Configure{OpfMetadata}
+ {\HCode{<meta property="rendition:spread">none</meta>}}
+ \Configure{@HEAD}
+ {\HCode{<meta name="viewport" content="width=1920, height=1080"/>\Hnewline}}
Modify the dimensions in the `<meta name="viewport>` element according to your needs.