Tar all files needed to re-compile your LaTeX project
Project description
tartex
TarTeX is a command-line utility to generate a tarball including all (non-system) source files needed to compile your LaTeX project.
Table of Contents
Installation
Note: You must have latexmk
and pdflatex
, as well as a full LaTeX env
installed. tartex
will not include any system-wide files, such as TeX style
files, classes, etc. in the tar file.
Using pipx
This is the easy way to install tagged releases.
pipx install tartex
From GitHub sources:
Compile using hatch to generate a wheel,
which may be then installed using pipx
as follows:
git clone https://github.com/badshah400/tartex.git
cd tartex
hatch build
pipx install ./dist/*.whl
Usage
Supported OS: Potentially any POSIX-like, tested only on Linux.
usage: tartex [-h] [-a ADD] [-b] [-l] [-o OUTPUT] [-s] [-v] [-x EXCL] [-j | -J | -z] [-V] filename
Build a tarball including all source files needed to compile your LaTeX project (version 0.1.0).
positional arguments:
filename Input file name (.tex or .fls)
options:
-h, --help show this help message and exit
-a ADD, --add ADD Comma separated list of additional files (wildcards allowed!) to include (loc relative to main TeX file)
-b, --bib find and add bib file to tarball
-l, --list Print a list of files to include and quit (no tarball generated)
-o OUTPUT, --output OUTPUT
Name of output tar.gz file (w/o the .tar.gz extension)
-s, --summary Print a summary at the end
-v, --verbose Print file names added to tarball
-x EXCL, --excl EXCL Comma separated list of files (wildcards allowed!) to exclude (loc relative to main TeX file)
-j, --bzip2 Compress tar with bzip2, generating .tar.bz2 file
-J, --xz Compress tar with xz, generating .tar.xz file
-z, --gzip Compress tar with gzip, generating .tar.gz file (default)
-V, --version Print tartex version
Note: If the source dir of your LaTeX project already contains the .fls
file previously generated by, say latex -record
or latexmk
, then tartex
will directly use that file to determine which input files to include in the
tarball. Otherwise, tartex
will recompile your project using latexmk
in a
temp dir and use the .fls
file generated there. To be precise, recompilation
will invoke:
latexmk -f -pdf -cd -outdir=<tmpdir> -interaction=nonstopmode filename
.
License
tartex
is distributed under the terms of the MIT license.
Similar utilities
- bundledoc is a post-processor for the
snapshot
package that bundles together all the classes, packages and files needed to build a given LaTeX document.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.