summaryrefslogtreecommitdiff
path: root/support/make4ht/README
diff options
context:
space:
mode:
Diffstat (limited to 'support/make4ht/README')
-rw-r--r--support/make4ht/README43
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