ltximg(1) General Commands Manual ltximg(1)
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, pablgonz@yahoo.com.
COPYRIGHT AND LICENSE
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.
SEE ALSO
gs(1), dvips(1), ps2pdf(1), pdfcrop(1), pdftops(1), pdftocairo(1),
pdftoppm(1)
2.1 2021-05-21 ltximg(1)
Generated by dwww version 1.15 on Sat Jun 29 02:37:03 CEST 2024.