summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/tex4ebook
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-01-10 22:21:28 +0000
committerKarl Berry <karl@freefriends.org>2019-01-10 22:21:28 +0000
commit0446755d9f93d095627779097695fa3468811b93 (patch)
tree31b8f58994f6d3c32a58fb54e238ee0472646543 /Master/texmf-dist/doc/support/tex4ebook
parent8368bb1a1e80c128b441a121a8fda08f0e32d5ae (diff)
tex4ebook (10jan19)
git-svn-id: svn://tug.org/texlive/trunk@49665 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/tex4ebook')
-rw-r--r--Master/texmf-dist/doc/support/tex4ebook/README32
-rw-r--r--Master/texmf-dist/doc/support/tex4ebook/changelog.tex77
-rw-r--r--Master/texmf-dist/doc/support/tex4ebook/readme.tex58
-rw-r--r--Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdfbin72915 -> 72222 bytes
4 files changed, 107 insertions, 60 deletions
diff --git a/Master/texmf-dist/doc/support/tex4ebook/README b/Master/texmf-dist/doc/support/tex4ebook/README
index d6ba3c51f23..228fe58df6f 100644
--- a/Master/texmf-dist/doc/support/tex4ebook/README
+++ b/Master/texmf-dist/doc/support/tex4ebook/README
@@ -35,16 +35,15 @@ Run on the command line:
tex4ebook [options] filename
You don't have to modify your source files unless you want to use commands
-defined by `tex4ebook` in the document, or when your document uses some
-unsupported package like `fontspec` (see details bellow how to solve this
-issue).
+defined by `tex4ebook` in the document, or when your document uses a
+package which causes a compilation error.
If you want to use `tex4ebook` commands, add this line to your document
preamble:
\usepackage{tex4ebook}
-but it is optional. You shouldn't need to modify your \TeX\ files
+But it is optional. You shouldn't need to modify your \TeX\ files
## Available commands
@@ -79,11 +78,11 @@ but it is optional. You shouldn't need to modify your \TeX\ files
`-f,--format (default epub)`
-: Output format. epub, epub3 and mobi are supported.
+: Output format. Epub, Epub3 and Mobi formats are supported.
`-l,--lua`
-: Runs htlualatex instead of htlatex.
+: Use LuaLaTeX as TeX engine.
`-m,--mode (default default)`
@@ -105,9 +104,14 @@ but it is optional. You shouldn't need to modify your \TeX\ files
: process output html files with `HTML tidy` command^[It needs to be installed separately].
+`-x,--xetex`
+
+: Use xelatex for document compilation
+
+
`-v,--version`
-: print version number
+: Print the version number.
# Configuration
@@ -122,9 +126,9 @@ structure is
...
\EndPreamble
-Basic info about command configurations can be found in a work-in-progres
- *tex4ht tutorial*^[https://github.com/michal-h21/helpers4ht/wiki/tex4ht-tutorial]
-, *tex4ht documentation*^[http://www.tug.org/applications/tex4ht/mn11.html],
+Basic info about command configurations can be found in a
+work-in-progres *tex4ht tutorial*^[https://github.com/michal-h21/helpers4ht/wiki/tex4ht-tutorial],
+*tex4ht documentation*^[http://www.tug.org/applications/tex4ht/mn11.html],
and in series of blogposts on CV Radhakrishnan's blog:
*Configure part 1*^[http://www.cvr.cc/?p=323],
*Configure part 2*^[http://www.cvr.cc/?p=362],
@@ -209,8 +213,8 @@ Add xml name space to `xhtml` files. Useful in `EPUB 3`
`\OpfGuide[filename]{title}{type}`
-: Add file to the `<guide>` section in the `OPF` file. See *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]
+: Add file to the `<guide>` section in the `OPF` file. See
+ *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
@@ -244,8 +248,9 @@ if same error as in `tex4ebook` run arises, the problem is in some `tex4ht`
configuration. Try to identify the source of problem and if you cannot find the
solution, make minimal example showing the error and ask for help either on
*tex4ht mailing list*^[http://tug.org/mailman/listinfo/tex4ht] or on
-*TeX-sx*^[http://tex.stackexchange.com/].
+*TeX.sx*^[http://tex.stackexchange.com/].
+<!--
## Fontspec
`tex4ht` currently doesn't support `fontspec` and open type fonts. At this
@@ -278,6 +283,7 @@ Other approach is to use `alternative4ht` package from [helpers4ht](https://gith
bundle. It works only with Lua backend, but it supports full unicode and you
don't have to use conditional package inclusion in your document. See
an [example](http://michal-h21.github.io/samples/helpers4ht/fontspec.html).
+-->
## Validation
diff --git a/Master/texmf-dist/doc/support/tex4ebook/changelog.tex b/Master/texmf-dist/doc/support/tex4ebook/changelog.tex
index a7df4b691b6..ebec6ca8175 100644
--- a/Master/texmf-dist/doc/support/tex4ebook/changelog.tex
+++ b/Master/texmf-dist/doc/support/tex4ebook/changelog.tex
@@ -3,6 +3,83 @@
\begin{itemize}
\item
+ 2019/01/10
+
+ \begin{itemize}
+ \tightlist
+ \item
+ released version \texttt{0.2b}
+ \end{itemize}
+\item
+ 28/11/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added support for appendix sections to the NCX file
+ \end{itemize}
+\item
+ 27/11/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ use the \texttt{uni-html4} option by default. It will convert some
+ math characters as Unicode chars.
+ \end{itemize}
+\item
+ 13/11/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added --xetex option to the README
+ \end{itemize}
+\item
+ 30/10/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ use the original section numbering in TOC in the Epub 3 output. The
+ numbering of the \texttt{\textless{}ol\textgreater{}} list is
+ disabled by CSS.
+ \end{itemize}
+\item
+ 18/10/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ fixed the executable installation
+ \end{itemize}
+\item
+ 03/09/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ updated the \texttt{-\/-help} message
+ \end{itemize}
+\item
+ 30/08/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ removed spurious \texttt{\textbackslash{}NoFonts} command in the
+ footnote configuration, it caused formating issues in the document
+ following a footnote
+ \end{itemize}
+\item
+ 22/06/2018
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added support for the output directory selection
+ \end{itemize}
+\item
09/05/2018
\begin{itemize}
diff --git a/Master/texmf-dist/doc/support/tex4ebook/readme.tex b/Master/texmf-dist/doc/support/tex4ebook/readme.tex
index e8ef08d4df8..75db5437183 100644
--- a/Master/texmf-dist/doc/support/tex4ebook/readme.tex
+++ b/Master/texmf-dist/doc/support/tex4ebook/readme.tex
@@ -42,8 +42,7 @@ tex4ebook [options] filename
You don't have to modify your source files unless you want to use
commands defined by \texttt{tex4ebook} in the document, or when your
-document uses some unsupported package like \texttt{fontspec} (see
-details bellow how to solve this issue).
+document uses a package which causes a compilation error.
If you want to use \texttt{tex4ebook} commands, add this line to your
document preamble:
@@ -52,7 +51,7 @@ document preamble:
\usepackage{tex4ebook}
\end{verbatim}
-but it is optional. You shouldn't need to modify your \TeX~files
+But it is optional. You shouldn't need to modify your \TeX~files
\hypertarget{available-commands}{%
\subsection{Available commands}\label{available-commands}}
@@ -96,9 +95,9 @@ Specify make4ht build file\footnote{\url{https://github.com/michal-h21/make4ht\#
Defaulf build file filename is \texttt{filename.mk4}, use this option if
you use different filename.
\item[\texttt{-f,-\/-format\ (default\ epub)}]
-Output format. epub, epub3 and mobi are supported.
+Output format. Epub, Epub3 and Mobi formats are supported.
\item[\texttt{-l,-\/-lua}]
-Runs htlualatex instead of htlatex.
+Use LuaLaTeX as TeX engine.
\item[\texttt{-m,-\/-mode\ (default\ default)}]
This set \texttt{mode} variable, accessible in the build file. Default
supported values are \texttt{default} and \texttt{draft}. In
@@ -113,8 +112,10 @@ external commands from your source files.
\item[\texttt{-t,-\/-tidy}]
process output html files with \texttt{HTML\ tidy} command\footnote{It
needs to be installed separately}.
+\item[\texttt{-x,-\/-xetex}]
+Use xelatex for document compilation
\item[\texttt{-v,-\/-version}]
-print version number
+Print the version number.
\end{description}
\hypertarget{configuration}{%
@@ -133,8 +134,8 @@ configurable using config files. Basic config file structure is
\end{verbatim}
Basic info about command configurations can be found in a
-work-in-progres \emph{tex4ht tutorial}\footnote{\url{https://github.com/michal-h21/helpers4ht/wiki/tex4ht-tutorial}}
-, \emph{tex4ht documentation}\footnote{\url{http://www.tug.org/applications/tex4ht/mn11.html}},
+work-in-progres \emph{tex4ht tutorial}\footnote{\url{https://github.com/michal-h21/helpers4ht/wiki/tex4ht-tutorial}},
+\emph{tex4ht documentation}\footnote{\url{http://www.tug.org/applications/tex4ht/mn11.html}},
and in series of blogposts on CV Radhakrishnan's blog: \emph{Configure
part 1}\footnote{\url{http://www.cvr.cc/?p=323}}, \emph{Configure part
2}\footnote{\url{http://www.cvr.cc/?p=362}}, \emph{Low level
@@ -248,7 +249,7 @@ spec}\footnote{\url{http://www.idpf.org/epub/301/spec/epub-publications.html\#se
\item[\texttt{\textbackslash{}OpfGuide{[}filename{]}\{title\}\{type\}}]
Add file to the \texttt{\textless{}guide\textgreater{}} section in the
\texttt{OPF} file. See \emph{Where do you start an ePUB and what is the
-\texttt{\textless{}guide\textgreater{}} section of the .OPF
+\texttt{\textless{}guide\textgreater{}} section of the \texttt{.OPF}
file?}\footnote{\url{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 \texttt{\textless{}guide\textgreater{}} is
deprecated in \texttt{EPUB\ 3}.
@@ -296,44 +297,7 @@ some \texttt{tex4ht} configuration. Try to identify the source of
problem and if you cannot find the solution, make minimal example
showing the error and ask for help either on \emph{tex4ht mailing
list}\footnote{\url{http://tug.org/mailman/listinfo/tex4ht}} or on
-\emph{TeX-sx}\footnote{\url{http://tex.stackexchange.com/}}.
-
-\hypertarget{fontspec}{%
-\subsection{Fontspec}\label{fontspec}}
-
-\texttt{tex4ht} currently doesn't support \texttt{fontspec} and open
-type fonts. At this moment, workaround for this is to modify your source
-file and conditionally include fontspec and any other conflicting
-packages only when document is not processed with \texttt{tex4ht}.
-
-Sample:
-
-\begin{verbatim}
-\documentclass{article}
-\makeatletter
-\@ifpackageloaded{tex4ht}{%
-% Packages for tex4ht unicode support
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage[english,czech]{babel}
-}{%
-% Packages for xelatex
-\usepackage{fontspec}
-\usepackage{polyglossia}
-\setmainfont{Latin Modern Roman}
-}
-\makeatother
-\end{verbatim}
-
-The drawback is that not all characters of the Unicode range are
-supported with \texttt{inputenc}. For some solutions of this limitation,
-see a thread on \emph{tex4ht mailing list}\footnote{\url{http://tug.org/pipermail/tex4ht/2013q1/000719.html}}
-
-Other approach is to use \texttt{alternative4ht} package from
-\href{https://github.com/michal-h21/helpers4ht}{helpers4ht} bundle. It
-works only with Lua backend, but it supports full unicode and you don't
-have to use conditional package inclusion in your document. See an
-\href{http://michal-h21.github.io/samples/helpers4ht/fontspec.html}{example}.
+\emph{TeX.sx}\footnote{\url{http://tex.stackexchange.com/}}.
\hypertarget{validation}{%
\subsection{Validation}\label{validation}}
diff --git a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf
index 8942a088e64..42f18620c0a 100644
--- a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf
+++ b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf
Binary files differ