ltximg - Man Page

ltximg [<options>] [--] <filename>.<tex|ltx>

ltximg automates the process of extracting and converting environments from LaTeX file to image formats and standalone files using ghostscript and poppler-utils. Generates a one file with only extracted environments and other with all extracted environments converted to \includegraphics.

By default the extracted environments are:

preview pspicture tikzpicture pgfpicture psgraph postscript PSTexample

Options that accept a value require either a blank space or = between the option and the value. Multiple short options can be bundling and if the last option takes a comma separated list you need -- at the end. Relative or absolute paths for directories and files is not supported.

If used without [<options>] the extracted environments are converted to pdf image format and saved in ./images directory using pdflatex and preview package for process.

General script options:

-h,  --help

Display command line help and exit.

-v,  --version

Display current version and exit.

-V,  --verbose

Verbose printing information.

-l,  --log

Write .log file with debug information.

-t,  --tif

Create .tif files using ghostscript.

-b,  --bmp

Create .bmp files using ghostscript.

-j,  --jpg

Create .jpg files using ghostscript.

-p,  --png

Create .png files using ghostscript.

-e,  --eps

Create .eps files using pdftops.

-s,  --svg

Create .svg files using pdftocairo.

-P,  --ppm

Create .ppm files using pdftoppm.

-g,  --gray

Gray scale for images using ghostscript.

-f,  --force

Capture \psset and \tikzset to extract.

-n,  --noprew

Create images files without preview package.

-r integer, --runs=integer

Set the number of times the compiler will run on the input file for environment extraction (default: 1).

-d integer, --dpi=integer

Dots per inch resolution for images (default: 150).

-m integer, --margins=integer

Set margins in bp for pdfcrop (default: 0).

-o filename, --output=filename

Create output file.

--imgdir=dirname

Set name of directory to save images and files (default: images).

--prefix=string

Set prefix append to each generated files (default: fig).

--myverb=macroname

Add \macroname to verbatim inline search (default: myverb).

--clean=doc|pst|tkz|all|off

Removes specific block text in output file (default: doc).

--zip

Compress files generated in .zip format.

--tar

Compress files generated in .tar.gz format.

--srcenv

Create files with only code of environments.

--subenv

Create standalone files for environments.

--shell

Enable \write18{SHELL COMMAND}.

--latex

Using latex>dvips>ps2pdf for compiler input and pdflatex for compiler output.

--dvips

Using latex>dvips>ps2pdf for compiler input and latex>dvips>ps2pdf for compiler output.

--dvilua

Using dvilualatex>dvips>ps2pdf for compiler input and lualatex for compiler output.

--dvipdf

Using latex>dvipdfmx for compiler input and latex>dvipdfmx for compiler output.

--xetex

Using xelatex for compiler input and output.

--luatex

Using lualatex for compiler input and output.

--arara

Use arara for compiler input and output.

--latexmk

Using latexmk for compiler output file.

--norun

Run script, but no create images files.

--nopdf

Don't create a .pdf image files.

--nocrop

Don't run pdfcrop.

--extrenv=env1,env2,...

Add new environments to extract.

--skipenv=env1,env2,...

Skip some default environments to extract.

--verbenv=env1,env2,...

Add new verbatim environments.

--writenv=env1,env2,...

Add new verbatim write environments.

--deltenv=env1,env2,...

Delete environments in output file.

ltximg --latex -e -p --subenv -o test-out.ltx test-in.ltx

Create a ./images directory (if it doesn't exist) with all extracted environments converted to .pdf, .eps, .png and standalone files, a file test-in-fig-all.ltx with all extracted environments and the file test-out.ltx with all environments converted to \includegraphics using latex>dvips>ps2pdf and preview package for test-in.ltx and pdflatex for test-out.ltx.

For full documentation use:

texdoc ltximg

Repository : <https://github.com/pablgonz/ltximg>

Bug tracker: <https://github.com/pablgonz/ltximg/issues>

Pablo González Luengo, pablgonz@yahoo.com.

Copyright 2013-2021 Pablo González, pablgonz@yahoo.com.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

gs(1), dvips(1), ps2pdf(1), pdfcrop(1), pdftops(1), pdftocairo(1), pdftoppm(1)