From c38f2e3735eb97eaf74132a87ca64c6980519265 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 26 Jul 2021 20:31:33 +0000 Subject: tex4ebook (26jul21) git-svn-id: svn://tug.org/texlive/trunk@60083 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/support/tex4ebook/README | 61 +++++++++++++++-- .../texmf-dist/doc/support/tex4ebook/changelog.tex | 55 +++++++++++++++ Master/texmf-dist/doc/support/tex4ebook/readme.tex | 74 +++++++++++++++++++-- .../doc/support/tex4ebook/tex4ebook-doc.pdf | Bin 79505 -> 83506 bytes 4 files changed, 179 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc') 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[]{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 `` 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ö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{Deutscher Bücherbund}} + \Configure{OpfMetadata} + {\HCode{Image Artist}} + \Configure{OpfMetadata} + {\HCode{Trans Lator}} + \Configure{OpfMetadata} + {\HCode{1888}} + \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 `` 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 `` 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{pre-paginated}} - \Configure{OpfMetadata}{\HCode{landscape}} - \Configure{OpfMetadata}{\HCode{none}} - \Configure{@HEAD}{\HCode{\Hnewline}} + \Configure{OpfMetadata} + {\HCode{pre-paginated}} + \Configure{OpfMetadata} + {\HCode{landscape}} + \Configure{OpfMetadata} + {\HCode{none}} + \Configure{@HEAD} + {\HCode{\Hnewline}} Modify the dimensions in the `pre-paginated}} -\Configure{OpfMetadata}{\HCode{landscape}} -\Configure{OpfMetadata}{\HCode{none}} -\Configure{@HEAD}{\HCode{\Hnewline}} +\Configure{OpfMetadata} +{\HCode{pre-paginated}} +\Configure{OpfMetadata} +{\HCode{landscape}} +\Configure{OpfMetadata} +{\HCode{none}} +\Configure{@HEAD} +{\HCode{\Hnewline}} \end{verbatim} Modify the dimensions in the diff --git a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf index 3546db973f5..170a8fc4f1c 100644 Binary files a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf and b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf differ -- cgit v1.2.3