diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/support/make4ht/README | 27 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/make4ht/changelog.tex | 129 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf | bin | 101505 -> 106622 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/make4ht/readme.tex | 36 |
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 Binary files differindex bc684e17682..d25efb855d9 100644 --- a/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf +++ b/Master/texmf-dist/doc/support/make4ht/make4ht-doc.pdf 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}} |