diff options
Diffstat (limited to 'support/make4ht/README')
-rw-r--r-- | support/make4ht/README | 43 |
1 files changed, 40 insertions, 3 deletions
diff --git a/support/make4ht/README b/support/make4ht/README index 0675e1d0ce..561d6bd14d 100644 --- a/support/make4ht/README +++ b/support/make4ht/README @@ -34,6 +34,7 @@ It will produce a file named `filename.html` if the compilation goes without fat possible values: tex4ht or lua4ht -c,--config (default xhtml) Custom config file -d,--output-dir (default "") Output directory + -B,--build-dir (default nil) Build directory -e,--build-file (default nil) If the build filename is different than `filename`.mk4 -f,--format (default nil) Output file format @@ -207,6 +208,12 @@ should copy all output files to the correct destinations. $ make4ht -d outputdir filename.tex +`make4ht` can also output temporary files to a build directory, thanks to the `--build-dir` (or `-B`) +option. The following command with put `.aux`, `.4tc` and other auxiliary files to the +`build` dir, and the generated `.html` and `.css` files to the `outputdir` directory. + + $ make4ht -B build -d outputdir filename.tex + ## Image conversion and postprocessing of the generated files \TeX4ht\ can convert parts of the document to images. This is useful @@ -248,7 +255,13 @@ may post-process the output files or request additional commands for the compila The extensions can be enabled or disabled by appending `+EXTENSION` or `-EXTENSION` after the output format name: - $ make4ht -uf html5+tidy filename.tex + $ make4ht -f html5+tidy filename.tex + +In `xhtml` and `html5` output formats, the `common_domfilters` extension is triggered automatically, but +it can still be disabled using: + + $ make4ht -f html5-common_domfilters filename.tex + Available extensions: @@ -260,8 +273,14 @@ common\_filters common\_domfilters : clean the HTML file using DOM filters. It is more powerful than -`common_filters`. Used DOM filters are `fixinlines`, `idcolons`, -`joincharacters`, `sectionid` and `tablerows`. + `common_filters`. It used following DOM filters: `fixinlines`, `idcolons`, + `joincharacters`, `mathmlfixes`, `tablerows`,`booktabs`, `sectionid` + and`itemparagraphs` + +copy\_images + +: Copies the images to the output directory. This is useful if the original + images are stored in directories above the document directory. detect\_engine @@ -1015,6 +1034,24 @@ Default values: } } +## The `copy_images` extension + +extensions + +: table with list of image extensions that should be processed. + + +img\_dir + +: name of the output directory where images should be stored + +Default values: + + filter_settings "copy_images" { + extensions = {"png", "jpg", "jpeg", "svg"}, + img_dir = "" + } + ## The `fixinlines` dom filter inline\_elements |