ltximg - LaTeX environments to image and standalone files
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)