diff options
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r-- | Master/texmf-dist/doc/support/tex4ebook/README | 139 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/tex4ebook/changelog.tex | 100 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/tex4ebook/readme.tex | 137 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf | bin | 73368 -> 78095 bytes |
4 files changed, 255 insertions, 121 deletions
diff --git a/Master/texmf-dist/doc/support/tex4ebook/README b/Master/texmf-dist/doc/support/tex4ebook/README index 951dad5a573..796445674a2 100644 --- a/Master/texmf-dist/doc/support/tex4ebook/README +++ b/Master/texmf-dist/doc/support/tex4ebook/README @@ -2,24 +2,22 @@ # Introduction -`TeX4ebook` is bundle of Lua scripts and `LaTeX` packages for conversion of -LaTeX files to ebook formats, for example `epub`, `mobi` and `epub3`. `tex4ht` -is used as conversion engine. +`TeX4ebook` is a tool for conversion from \LaTeX\ to +ebook formats, such as EPUB, MOBI and EPUB 3. +It is based on `TeX4ht`^[https://tug.org/tex4ht/], +which provides instructions for the actual \LaTeX\ to HTML conversion, +and on `make4ht`^[https://ctan.org/pkg/make4ht?lang=en]. -Note that while `mobi` is supported by Amazon Kindle, most widespread ebook -reader, it doesn't support `mathml` and this means that math must re represented -as images. The same is true for `epub`. This is not a good thing, especially -for inline math, as you may experience wrong baselines. If your ebook contains -math, the only correct solution is to produce `epub3`, as it supports `mathml`. -The issue with `epub3` is, that majority of `e-ink` ebook readers doesn't -support this format, reader applications exists mainly for Android and Apple -devices. For books which contains mainly prose, all formats should be suitable, -but `epub3` supports most features from web standards, such as `CSS`. -As with `tex4ht`, the emphasis is on conversion of document's logical structure -and metadata, basic visual appearance is preserved as well, but you should use +The conversion is focused on the logical structure of the converted document +and metadata. Basic visual appearance is preserved as well, but you should use custom configurations if you want to make the document more visually appealing. -You can include custom `CSS` or fonts in configuration files. +You can include custom `CSS` or fonts in a configuration file. + +`TeX4ebook` supports the same features as `make4ht`, in particular build files and extensions. +These may be used for post-processing of the generated HTML files, or to configure the image conversion. +See the `make4ht` documentation to see the supported features. + ## License @@ -38,6 +36,7 @@ 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 a package which causes a compilation error. + If you want to use `tex4ebook` commands, add this line to your document preamble: @@ -51,9 +50,13 @@ But it is optional. You shouldn't need to modify your \TeX\ files # Command line options +`-a,--loglevel` + +: Set message log level. Possible values: debug, info, status, warning, error, fatal. Default: status. + `-c,--config` -: specify custom config file for `tex4ht` +: specify custom config file for `TeX4ht` **example config file**: File `sample.cfg` @@ -78,7 +81,11 @@ But it is optional. You shouldn't need to modify your \TeX\ files `-f,--format (default epub)` -: Output format. Epub, Epub3 and Mobi formats are supported. +: Output format. Possible values are `epub`, `epub3` and `mobi`. + +`-j,--jobname` + +: Specify the output file name, without file extension. `-l,--lua` @@ -97,7 +104,7 @@ But it is optional. You shouldn't need to modify your \TeX\ files `-s,--shell-escape` -: Enable shell escape in htlatex run. This may be needed if you run external +: Enable shell escape in the `htlatex` run. This is necessary for the execution of the external commands from your source files. `-t,--tidy` @@ -112,12 +119,11 @@ But it is optional. You shouldn't need to modify your \TeX\ files `-v,--version` : Print the version number. - # Configuration -`tex4ebook` uses `tex4ht`^[http://www.tug.org/tex4ht/] for conversion from LaTeX -to html. `tex4ht` is highly configurable using config files. Basic config file +`TeX4ebook` uses `TeX4ht`^[http://www.tug.org/tex4ht/] for conversion from LaTeX +to html. `TeX4ht` is highly configurable using config files. Basic config file structure is \Preamble{xhtml, comma separated list of options} @@ -127,16 +133,16 @@ 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], +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], -*Low level commands*^[http://www.cvr.cc/?p=482]. +*Configure part 1*^[https://web.archive.org/web/20180908234227/http://www.cvr.cc/?p=323], +*Configure part 2*^[https://web.archive.org/web/20180908201057/http://www.cvr.cc/?p=362], +*Low level commands*^[https://web.archive.org/web/20180909101325/http://cvr.cc/?p=482]. Available options for `\Preamble` command are listed in the article -*TeX4ht: options*^[http://www.cvr.cc/?p=504]. *Comparison of tex4ebook and Pandoc output*^[https://github.com/richelbilderbeek/travis_tex_to_epub_example_1] +*TeX4ht: options*^[https://web.archive.org/web/20180813043722/http://cvr.cc/?p=504]. *Comparison of tex4ebook and Pandoc output*^[https://github.com/richelbilderbeek/travis_tex_to_epub_example_1] -Great source of tips for `tex4ht` configuring is *tex4ht tag on TeX.sx*^[http://tex.stackexchange.com/questions/tagged/tex4ht], there is also a *tag for tex4ebook*^[http://tex.stackexchange.com/questions/tagged/tex4ebook]. +A great source of tips for `TeX4ht` configuration is *tex4ht tag on TeX.sx*^[http://tex.stackexchange.com/questions/tagged/tex4ht]. There is also a *tag for tex4ebook*^[http://tex.stackexchange.com/questions/tagged/tex4ebook]. Examples of interesting questions are *including images and fonts in ebooks*^[http://tex.stackexchange.com/a/213165/2891] @@ -149,7 +155,7 @@ or *setting image size in em units instead of pt*^[http://tex.stackexchange.com/ \Configure{UniqueIdentifier}{identifier} -Every epub file should have unique identifier, like ISBN, DOI, URI etc. +Every EPUB file should have unique identifier, like ISBN, DOI, URI etc. Default identifier is URI, with value `http://example.com/\jobname`. \Configure{@author}{\let\footnote\@gobble} @@ -161,7 +167,7 @@ which don't belongs here, such as `\footnote`. \Configure{OpfScheme}{URI} Type of unique identifier, default type is URI. It is -used only in `epub`, it is deprecated for `epub3` +used only in the EPUB format, it is deprecated for EPUB 3. \Configure{resettoclevels}{list of section types in descending order} @@ -170,7 +176,7 @@ value is the whole document hierarchy, from `\part` to `\paragraph`. \Configure{DocumentLanguage}{language code} -Each ePub file must declare the document language. It is inferred from `babel` main +Each EPUB file must declare the document language. It is inferred from `babel` main language by default, but you can configure it when it doesn't work correctly. The `language code` should be in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) form. @@ -203,11 +209,11 @@ Add item to `<manifest>` section in the `OPF` file. \Configure{xmlns}{prefix}{uri} -Add xml name space to `xhtml` files. Useful in `EPUB 3` +Add `XML` name space to the generated `XHTML` files. Useful in `EPUB 3`. -## Commands available in config files +## Commands available in the config file `\OpfRegisterFile[filename]` @@ -244,53 +250,44 @@ See the `make4ht` documentation for an example and more information. # Troubleshooting +## Fixed layout EPUB + +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}} + +Modify the dimensions in the `<meta name="viewport>` element according to your needs. + +## Math issues + +Note that while `mobi` is supported by Amazon Kindle, most widespread ebook +reader, it doesn't support `MathML`. This means that math must be represented +as images. The same issue is true for the EPUB format as well. +This is problematic especially for the inline math, as you may experience wrong +vertical alignment of the math content and surrounding text. If your ebook contains +math, a better solution is to produce the `epub3` format, as it supports `MathML`. +The issue with EPUB 3 is that majority of `e-ink` ebook readers don't +support it. Reader applications exists mainly for Android and Apple +devices. For books which contains mainly prose, all formats should be suitable, +but EPUB 3 supports most features from web standards, such as `CSS`. + +## Compilation errors + When compilation of the document breaks with error during `LaTeX` run, it may -be caused by some problem in `tex4ht` configuration. Comment out line +be caused by some problem in `TeX4ht` configuration. Comment out line `\usepackage{tex4ebook}` in your source file and run command: htlatex filename -if same error as in `tex4ebook` run arises, the problem is in some `tex4ht` +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 +*TeX4ht mailing list*^[http://tug.org/mailman/listinfo/tex4ht] or on *TeX.sx*^[http://tex.stackexchange.com/]. -<!-- -## Fontspec - -`tex4ht` currently doesn't support `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 `tex4ht`. - -Sample: - - \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 - -The drawback is that not all characters of the Unicode range are supported with -`inputenc`. For some solutions of this limitation, see a thread on *tex4ht -mailing list*^[http://tug.org/pipermail/tex4ht/2013q1/000719.html] - -Other approach is to use `alternative4ht` package from [helpers4ht](https://github.com/michal-h21/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 [example](http://michal-h21.github.io/samples/helpers4ht/fontspec.html). ---> - ## Validation In case of successful compilation, use command line tool `epubcheck`^[you need diff --git a/Master/texmf-dist/doc/support/tex4ebook/changelog.tex b/Master/texmf-dist/doc/support/tex4ebook/changelog.tex index d7743b1204f..0d3393cca58 100644 --- a/Master/texmf-dist/doc/support/tex4ebook/changelog.tex +++ b/Master/texmf-dist/doc/support/tex4ebook/changelog.tex @@ -3,6 +3,106 @@ \begin{itemize} \item + 2019/11/01 + + \begin{itemize} + \tightlist + \item + released version \texttt{0.3} + \end{itemize} +\item + 2019/10/20 + + \begin{itemize} + \tightlist + \item + fixed the \texttt{TOC} cleanup in the \texttt{ePub\ 3} mode. + \item + added support for the \texttt{page-spread-left} and + \texttt{page-spreat-right} properties. + \end{itemize} +\item + 2019/10/20 + + \begin{itemize} + \tightlist + \item + addapted to use the \texttt{make4ht} logging mechanism. + \end{itemize} +\item + 2019/10/06 + + \begin{itemize} + \tightlist + \item + fixed bug with void elements parsing in the OPF file. + \item + undo \texttt{\textbackslash{}XeTeXcharclass} for the \texttt{:} + character when the OPF file is generated. + \end{itemize} +\item + 2019/09/16 + + \begin{itemize} + \tightlist + \item + make the default build sequence before loading of the extensions. + Some extensions need to modify the build sequence. + \end{itemize} +\item + 2019/08/28 + + \begin{itemize} + \tightlist + \item + added support for reading input from \texttt{STDIN}. + \end{itemize} +\item + 2019/08/27 + + \begin{itemize} + \tightlist + \item + added support for the \texttt{-\/-jobname} command line option. + \end{itemize} +\item + 2019/08/25 + + \begin{itemize} + \tightlist + \item + use the \texttt{mkparams.get\_args} function to retrieve the command + line options + \end{itemize} +\item + 2019/07/24 + + \begin{itemize} + \tightlist + \item + added support for the \texttt{\textbackslash{}author} command with + an optional argument + \end{itemize} +\item + 2019/05/09 + + \begin{itemize} + \tightlist + \item + added support for the \texttt{\textbackslash{}title} command with an + optional argument + \end{itemize} +\item + 2019/04/04 + + \begin{itemize} + \tightlist + \item + register appendix chapters and section in the OPF file list + \item + fixed handling of appendices in the NCX table of contents + \end{itemize} +\item 2019/03/21 \begin{itemize} diff --git a/Master/texmf-dist/doc/support/tex4ebook/readme.tex b/Master/texmf-dist/doc/support/tex4ebook/readme.tex index 2a6110e03fc..13b064bf31d 100644 --- a/Master/texmf-dist/doc/support/tex4ebook/readme.tex +++ b/Master/texmf-dist/doc/support/tex4ebook/readme.tex @@ -1,29 +1,23 @@ \hypertarget{introduction}{% \section{Introduction}\label{introduction}} -\texttt{TeX4ebook} is bundle of Lua scripts and \texttt{LaTeX} packages -for conversion of LaTeX files to ebook formats, for example -\texttt{epub}, \texttt{mobi} and \texttt{epub3}. \texttt{tex4ht} is used -as conversion engine. - -Note that while \texttt{mobi} is supported by Amazon Kindle, most -widespread ebook reader, it doesn't support \texttt{mathml} and this -means that math must re represented as images. The same is true for -\texttt{epub}. This is not a good thing, especially for inline math, as -you may experience wrong baselines. If your ebook contains math, the -only correct solution is to produce \texttt{epub3}, as it supports -\texttt{mathml}. The issue with \texttt{epub3} is, that majority of -\texttt{e-ink} ebook readers doesn't support this format, reader -applications exists mainly for Android and Apple devices. For books -which contains mainly prose, all formats should be suitable, but -\texttt{epub3} supports most features from web standards, such as -\texttt{CSS}. - -As with \texttt{tex4ht}, the emphasis is on conversion of document's -logical structure and metadata, basic visual appearance is preserved as -well, but you should use custom configurations if you want to make the -document more visually appealing. You can include custom \texttt{CSS} or -fonts in configuration files. +\texttt{TeX4ebook} is a tool for conversion from \LaTeX~to ebook +formats, such as EPUB, MOBI and EPUB 3. It is based on +\texttt{TeX4ht}\footnote{\url{https://tug.org/tex4ht/}}, which provides +instructions for the actual \LaTeX~to HTML conversion, and on +\texttt{make4ht}\footnote{\url{https://ctan.org/pkg/make4ht?lang=en}}. + +The conversion is focused on the logical structure of the converted +document and metadata. Basic visual appearance is preserved as well, but +you should use custom configurations if you want to make the document +more visually appealing. You can include custom \texttt{CSS} or fonts in +a configuration file. + +\texttt{TeX4ebook} supports the same features as \texttt{make4ht}, in +particular build files and extensions. These may be used for +post-processing of the generated HTML files, or to configure the image +conversion. See the \texttt{make4ht} documentation to see the supported +features. \hypertarget{license}{% \subsection{License}\label{license}} @@ -67,8 +61,11 @@ But it is optional. You shouldn't need to modify your \TeX~files \section{Command line options}\label{command-line-options}} \begin{description} +\item[\texttt{-a,-\/-loglevel}] +Set message log level. Possible values: debug, info, status, warning, +error, fatal. Default: status. \item[\texttt{-c,-\/-config}] -specify custom config file for \texttt{tex4ht} +specify custom config file for \texttt{TeX4ht} \end{description} \textbf{example config file}: File \texttt{sample.cfg} @@ -95,7 +92,10 @@ 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 formats are supported. +Output format. Possible values are \texttt{epub}, \texttt{epub3} and +\texttt{mobi}. +\item[\texttt{-j,-\/-jobname}] +Specify the output file name, without file extension. \item[\texttt{-l,-\/-lua}] Use LuaLaTeX as TeX engine. \item[\texttt{-m,-\/-mode\ (default\ default)}] @@ -107,8 +107,8 @@ times. Resolution of generated images, for example math. It should meet resolution of target devices, which is usually about 167 ppi. \item[\texttt{-s,-\/-shell-escape}] -Enable shell escape in htlatex run. This may be needed if you run -external commands from your source files. +Enable shell escape in the \texttt{htlatex} run. This is necessary for +the execution of the 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}. @@ -121,8 +121,8 @@ Print the version number. \hypertarget{configuration}{% \section{Configuration}\label{configuration}} -\texttt{tex4ebook} uses \texttt{tex4ht}\footnote{\url{http://www.tug.org/tex4ht/}} -for conversion from LaTeX to html. \texttt{tex4ht} is highly +\texttt{TeX4ebook} uses \texttt{TeX4ht}\footnote{\url{http://www.tug.org/tex4ht/}} +for conversion from LaTeX to html. \texttt{TeX4ht} is highly configurable using config files. Basic config file structure is \begin{verbatim} @@ -134,19 +134,19 @@ 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 -commands}\footnote{\url{http://www.cvr.cc/?p=482}}. Available options -for \texttt{\textbackslash{}Preamble} command are listed in the article -\emph{TeX4ht: options}\footnote{\url{http://www.cvr.cc/?p=504}}. +part 1}\footnote{\url{https://web.archive.org/web/20180908234227/http://www.cvr.cc/?p=323}}, +\emph{Configure part 2}\footnote{\url{https://web.archive.org/web/20180908201057/http://www.cvr.cc/?p=362}}, +\emph{Low level commands}\footnote{\url{https://web.archive.org/web/20180909101325/http://cvr.cc/?p=482}}. +Available options for \texttt{\textbackslash{}Preamble} command are +listed in the article \emph{TeX4ht: options}\footnote{\url{https://web.archive.org/web/20180813043722/http://cvr.cc/?p=504}}. \emph{Comparison of tex4ebook and Pandoc output}\footnote{\url{https://github.com/richelbilderbeek/travis_tex_to_epub_example_1}} -Great source of tips for \texttt{tex4ht} configuring is \emph{tex4ht tag -on TeX.sx}\footnote{\url{http://tex.stackexchange.com/questions/tagged/tex4ht}}, -there is also a \emph{tag for tex4ebook}\footnote{\url{http://tex.stackexchange.com/questions/tagged/tex4ebook}}. +A great source of tips for \texttt{TeX4ht} configuration is \emph{tex4ht +tag on TeX.sx}\footnote{\url{http://tex.stackexchange.com/questions/tagged/tex4ht}}. +There is also a \emph{tag for tex4ebook}\footnote{\url{http://tex.stackexchange.com/questions/tagged/tex4ebook}}. Examples of interesting questions are \emph{including images and fonts in ebooks}\footnote{\url{http://tex.stackexchange.com/a/213165/2891}} or @@ -161,7 +161,7 @@ in ebooks}\footnote{\url{http://tex.stackexchange.com/a/213165/2891}} or \Configure{UniqueIdentifier}{identifier} \end{verbatim} -Every epub file should have unique identifier, like ISBN, DOI, URI etc. +Every EPUB file should have unique identifier, like ISBN, DOI, URI etc. Default identifier is URI, with value \texttt{http://example.com/\textbackslash{}jobname}. @@ -179,8 +179,8 @@ to strip away any information which don't belongs here, such as \Configure{OpfScheme}{URI} \end{verbatim} -Type of unique identifier, default type is URI. It is used only in -\texttt{epub}, it is deprecated for \texttt{epub3} +Type of unique identifier, default type is URI. It is used only in the +EPUB format, it is deprecated for EPUB 3. \begin{verbatim} \Configure{resettoclevels}{list of section types in descending order} @@ -194,7 +194,7 @@ file. Default value is the whole document hierarchy, from \Configure{DocumentLanguage}{language code} \end{verbatim} -Each ePub file must declare the document language. It is inferred from +Each EPUB file must declare the document language. It is inferred from \texttt{babel} main language by default, but you can configure it when it doesn't work correctly. The \texttt{language\ code} should be in \href{https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes}{ISO 639-1} @@ -243,11 +243,12 @@ Add item to \texttt{\textless{}manifest\textgreater{}} section in the \Configure{xmlns}{prefix}{uri} \end{verbatim} -Add xml name space to \texttt{xhtml} files. Useful in \texttt{EPUB\ 3} +Add \texttt{XML} name space to the generated \texttt{XHTML} files. +Useful in \texttt{EPUB\ 3}. -\hypertarget{commands-available-in-config-files}{% -\subsection{Commands available in config -files}\label{commands-available-in-config-files}} +\hypertarget{commands-available-in-the-config-file}{% +\subsection{Commands available in the config +file}\label{commands-available-in-the-config-file}} \begin{description} \item[\texttt{\textbackslash{}OpfRegisterFile{[}filename{]}}] @@ -293,8 +294,44 @@ information. \hypertarget{troubleshooting}{% \section{Troubleshooting}\label{troubleshooting}} +\hypertarget{fixed-layout-epub}{% +\subsection{Fixed layout EPUB}\label{fixed-layout-epub}} + +The basic support for the Fixed layout EPUB 3 can be enabled using the +following configurations: + +\begin{verbatim} +\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}} +\end{verbatim} + +Modify the dimensions in the +\texttt{\textless{}meta\ name="viewport\textgreater{}} element according +to your needs. + +\hypertarget{math-issues}{% +\subsection{Math issues}\label{math-issues}} + +Note that while \texttt{mobi} is supported by Amazon Kindle, most +widespread ebook reader, it doesn't support \texttt{MathML}. This means +that math must be represented as images. The same issue is true for the +EPUB format as well. This is problematic especially for the inline math, +as you may experience wrong vertical alignment of the math content and +surrounding text. If your ebook contains math, a better solution is to +produce the \texttt{epub3} format, as it supports \texttt{MathML}. The +issue with EPUB 3 is that majority of \texttt{e-ink} ebook readers don't +support it. Reader applications exists mainly for Android and Apple +devices. For books which contains mainly prose, all formats should be +suitable, but EPUB 3 supports most features from web standards, such as +\texttt{CSS}. + +\hypertarget{compilation-errors}{% +\subsection{Compilation errors}\label{compilation-errors}} + When compilation of the document breaks with error during \texttt{LaTeX} -run, it may be caused by some problem in \texttt{tex4ht} configuration. +run, it may be caused by some problem in \texttt{TeX4ht} configuration. Comment out line \texttt{\textbackslash{}usepackage\{tex4ebook\}} in your source file and run command: @@ -303,9 +340,9 @@ htlatex filename \end{verbatim} if same error as in \texttt{tex4ebook} run arises, the problem is in -some \texttt{tex4ht} configuration. Try to identify the source of +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 +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/}}. diff --git a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf Binary files differindex 6c7fd83af08..8372406fd9d 100644 --- a/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf +++ b/Master/texmf-dist/doc/support/tex4ebook/tex4ebook-doc.pdf |