summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-08-24 22:19:06 +0000
committerKarl Berry <karl@freefriends.org>2018-08-24 22:19:06 +0000
commit9dec02fb03afe114f68ce75e31f6c5f8ee0adcf8 (patch)
tree7297cba51c519c366979124dca49ad56641794d9 /Master/texmf-dist/doc/support
parent9067afb3f8bce172638d12a6f926ab82547590e6 (diff)
make4ht (24aug18)
git-svn-id: svn://tug.org/texlive/trunk@48477 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/make4ht/README27
-rw-r--r--Master/texmf-dist/doc/support/make4ht/changelog.tex129
-rw-r--r--Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdfbin101505 -> 106622 bytes
-rw-r--r--Master/texmf-dist/doc/support/make4ht/readme.tex36
4 files changed, 192 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/make4ht/README b/Master/texmf-dist/doc/support/make4ht/README
index 6b9ba2e30cf..c878fdb1db4 100644
--- a/Master/texmf-dist/doc/support/make4ht/README
+++ b/Master/texmf-dist/doc/support/make4ht/README
@@ -119,6 +119,11 @@ tidy
: clean the `HTML` files using the `tidy` command.
+dvisvgm_hashes
+
+: efficient generation of SVG pictures using Dvisvgm. It can utilize
+multiple processor cores and generates only changed images.
+
common\_filters
: clean the output HTML files using filters.
@@ -777,6 +782,20 @@ Example:
}
}
+### The `dvisvgm_hashes` extension
+
+options
+
+: command line options for Dvisvgm. The default value is `-n --exact -c 1.15,1.15`.
+
+cpu_cnt
+
+: number of processor cores used for conversion. The extension tries to detect the available cores automatically by default.
+
+parallel_size
+
+: number of pages used in each Dvisvgm call. The extension detects changed pages in the DVI file and construct multiple calls to Dvisvgm with only changed pages.
+
# Configuration file {#configfile}
@@ -883,6 +902,14 @@ Another option is to add a space before `tex4ht` options:
The former way is preferable, though.
+## Filenames containing spaces
+
+`tex4ht` cannot handle filenames containing spaces. `make4ht` thus replaces spaces in input file names with underscores, so generated XML files use underscores instead of spaces as well.
+
+## Filenames containing non-ASCII characters
+
+The `odt` output doesn't support accented filenames, it is best to stick to ASCII characters in filenames.
+
# License
Permission is granted to copy, distribute and/or modify this software
diff --git a/Master/texmf-dist/doc/support/make4ht/changelog.tex b/Master/texmf-dist/doc/support/make4ht/changelog.tex
index ac9e2aa6e33..ec2c521110f 100644
--- a/Master/texmf-dist/doc/support/make4ht/changelog.tex
+++ b/Master/texmf-dist/doc/support/make4ht/changelog.tex
@@ -3,6 +3,135 @@
\begin{itemize}
\item
+ 2018/08/23
+
+ \begin{itemize}
+ \tightlist
+ \item
+ released version 0.2c
+ \end{itemize}
+\item
+ 2018/08/21
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added processor core detection on Windows
+ \item
+ make processor number configurable
+ \item
+ updated the documentation.
+ \end{itemize}
+\item
+ 2018/08/20
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added \texttt{dvisvgm\_hashes} extension
+ \end{itemize}
+\item
+ 2018/07/03
+
+ \begin{itemize}
+ \tightlist
+ \item
+ create the \texttt{mimetype} file to achieve the ODT file validity
+ \end{itemize}
+\item
+ 2018/07/02
+
+ \begin{itemize}
+ \tightlist
+ \item
+ disabled conversion of XML entities for \&, \textless{} and
+ \textgreater{} characters back to Unicode, because it breaks XML
+ validity
+ \end{itemize}
+\item
+ 2018/06/27
+
+ \begin{itemize}
+ \tightlist
+ \item
+ fixed root dir detection
+ \end{itemize}
+\item
+ 2018/06/26
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added code for detection of TeX distribution root for Miktex and TL
+ \end{itemize}
+\item
+ 2018/06/25
+
+ \begin{itemize}
+ \tightlist
+ \item
+ moved call to \texttt{xtpipes} from \texttt{t4ht} to the
+ \texttt{ODT} format drives. This should fix issues with path
+ expansion in \texttt{tex4ht.env} in TeX distributions.
+ \end{itemize}
+\item
+ 2018/06/22
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added \texttt{mkutils.find\_zip} function. It detects \texttt{zip}
+ or \texttt{miktex-zip} executables
+ \end{itemize}
+\item
+ 2018/06/19
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added new filter: \texttt{entities-to-unicode}. It converts XML
+ entites for Unicode characters back to Unicode.
+ \item
+ execute \texttt{entities-to-unicode} filter on text and math files
+ in the ODT output.
+ \end{itemize}
+\item
+ 2018/06/12
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added support for direct \texttt{ODT} file packing
+ \end{itemize}
+\item
+ 2018/06/11
+
+ \begin{itemize}
+ \tightlist
+ \item
+ new function available for formats, \texttt{format.modify\_build}
+ \item
+ function \texttt{mkutils.delete\_dir} for directory removal
+ \item
+ function \texttt{mkutils.mv} for file moving
+ \item
+ started on packing of the \texttt{ODT} files directly by the format,
+ instead of \texttt{t4ht}
+ \end{itemize}
+\item
+ 2018/06/08
+
+ \begin{itemize}
+ \tightlist
+ \item
+ added support for filenames containing spaces
+ \item
+ added support for filenames containing non-ascii characters
+ \item
+ don't require sudo for the installation, let the user to install
+ symbolic links to \texttt{\$PATH}
+ \end{itemize}
+\item
2018/05/03
\begin{itemize}
diff --git a/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf b/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf
index bc684e17682..d25efb855d9 100644
--- a/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf
+++ b/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/make4ht/readme.tex b/Master/texmf-dist/doc/support/make4ht/readme.tex
index 261e3f2b882..20bf33575d1 100644
--- a/Master/texmf-dist/doc/support/make4ht/readme.tex
+++ b/Master/texmf-dist/doc/support/make4ht/readme.tex
@@ -155,6 +155,9 @@ Available extensions:
use \texttt{Latexmk} for \LaTeX~compilation.
\item[tidy]
clean the \texttt{HTML} files using the \texttt{tidy} command.
+\item[dvisvgm\_hashes]
+efficient generation of SVG pictures using Dvisvgm. It can utilize
+multiple processor cores and generates only changed images.
\item[common\_filters]
clean the output HTML files using filters.
\item[common\_domfilters]
@@ -863,6 +866,23 @@ filter_settings "staticsite" {
}
\end{verbatim}
+\hypertarget{the-dvisvgm_hashes-extension}{%
+\subsubsection{\texorpdfstring{The \texttt{dvisvgm\_hashes}
+extension}{The dvisvgm\_hashes extension}}\label{the-dvisvgm_hashes-extension}}
+
+\begin{description}
+\item[options]
+command line options for Dvisvgm. The default value is
+\texttt{-n\ -\/-exact\ -c\ 1.15,1.15}.
+\item[cpu\_cnt]
+number of processor cores used for conversion. The extension tries to
+detect the available cores automatically by default.
+\item[parallel\_size]
+number of pages used in each Dvisvgm call. The extension detects changed
+pages in the DVI file and construct multiple calls to Dvisvgm with only
+changed pages.
+\end{description}
+
\hypertarget{configfile}{%
\section{Configuration file}\label{configfile}}
@@ -999,6 +1019,22 @@ make4ht hello.tex "customcfg,charset=utf-8" " -cunihtf -utf8" -d foo
The former way is preferable, though.
+\hypertarget{filenames-containing-spaces}{%
+\subsection{Filenames containing
+spaces}\label{filenames-containing-spaces}}
+
+\texttt{tex4ht} cannot handle filenames containing spaces.
+\texttt{make4ht} thus replaces spaces in input file names with
+underscores, so generated XML files use underscores instead of spaces as
+well.
+
+\hypertarget{filenames-containing-non-ascii-characters}{%
+\subsection{Filenames containing non-ASCII
+characters}\label{filenames-containing-non-ascii-characters}}
+
+The \texttt{odt} output doesn't support accented filenames, it is best
+to stick to ASCII characters in filenames.
+
\hypertarget{license}{%
\section{License}\label{license}}