Man page - ltximg(1)

Packages contains this manual

Manual

ltximg

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
DOCUMENTATION
ISSUES AND REPORTS
AUTHOR
COPYRIGHT AND LICENSE
SEE ALSO

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)