NAME
ltximg - LaTeX environments to image and standalone files
SYNOPSIS
ltximg [<options>] [--] <filename>.<tex|ltx>
DESCRIPTION
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
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.
EXAMPLE
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.
DOCUMENTATION
For full documentation use:
texdoc ltximg
ISSUES AND REPORTS
Repository : <https://github.com/pablgonz/ltximg>
Bug tracker: <https://github.com/pablgonz/ltximg/issues>
AUTHOR
Pablo González Luengo, [email protected].
COPYRIGHT AND LICENSE
Copyright 2013-2021 Pablo González, [email protected].
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.
SEE ALSO
gs(1), dvips(1), ps2pdf(1), pdfcrop(1), pdftops(1), pdftocairo(1), pdftoppm(1)