diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/tex4ebook/readme.tex')
-rw-r--r-- | Master/texmf-dist/doc/support/tex4ebook/readme.tex | 58 |
1 files changed, 11 insertions, 47 deletions
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}} |