Package: tartex
tartexTarTeX is a command-line utility to generate a tarball including all required
— but no more! — (non-system) source files to (re)compile your LaTeX project
elsewhere.Table of ContentsFeaturesInstallationUsageLicenseSimilar utilitiesFeaturesDefaults to including the least number of files needed to recompile your LaTeX project in the output tar file.Creates tarballs compatible with arXiv (and most journal) requirements.Automatically determines pdf or ps processing based on source dir contents.Supports different compression methods for output tarball.Does not modify or create files inside source directory itself.Preserves directory structure in generated tarball, i.e. no flattening.Handy options to allow edge cases.Native TAB-completion for common interactive shells: bash, fish, and zsh (help welcome for others).InstallationNote: Unless you provide a prepared ".fls" file asFILENAMEinput, you
must havelatexmkandpdflatex, as well as a full LaTeX env installed to
allow compilation of your LaTeX project.tartexdoes not include any
system-wide files, such as standard TeX style files, classes, etc. in the tar
file.Using pipxThis is the easy way to install tagged releases.pipx install tartexFrom GitHub sources:Compile usinghatchto generate a wheel,
which may be then installed usingpipxas follows:git clone https://github.com/badshah400/tartex.gitcd tartexhatch buildpipx install ./dist/*.whlUsageSupported OS: Potentially any POSIX-like, testedonlyon Linux.usage: tartex [OPTIONS] FILENAMEBuild a tarball including all source files needed to compile your LaTeX project(version 0.4.1).positional arguments:FILENAME                 input file name (with .tex or .fls suffix)options:-h, --help               show this help message and exit-V, --version            print tartex version and exit-a, --add=PATTERNS       include additional files matching glob-stylePATTERN; separate multiple PATTERNS using commas-b, --bib                find and add bib file to tarball-l, --list               print list of files to include and quit-o, --output=NAME[.SUF]  output tar file name; tar compression mode will beinferred from .SUF, if possible (default 'gz')-s, --summary            print a summary at the end-v, --verbose            increase verbosity (-v, -vv, etc.)-x, --excl=PATTERNS      exclude file names matching PATTERNS-j, --bzip2              recompress with bzip2 (.bz2) (overrides .SUF in'-o')-J, --xz                 recompress with lzma (.xz) (overrides .SUF in '-o')-z, --gzip               recompress with gzip (.gz) (overrides .SUF in '-o')Options for latexmk processing:--latexmk-tex=TEXMODE    force TeX processing mode used by latexmk; TEXMODEmust be one of: dvi, luatex, lualatex, pdf, pdflua,ps, xdv, xelatex-F, --force-recompile    force recompilation even if .fls existsShell completion options:--completion             print shell completion guides for tartex--bash-completions       install bash completions for tartex--fish-completions       install fish completions for tartex--zsh-completions        install zsh completions for tartexNote: If the source dir of your LaTeX project already contains the.flsfile previously generated by, saylatex -recordorlatexmk, thentartexwill directly use that file to determine which input files to include in the
tarball. Otherwise,tartexwill recompile your project usinglatexmkin a
temp dir and use the.flsfile generated there. To be precise, recompilation
will invoke:latexmk -f -<texmode> -cd -outdir=<tmpdir> -interaction=nonstopmode filenametexmodeis one ofpdforpsby default, as detemined from the contents of
the source dir. It may be overridden by the--latexmk-texoption.Licensetartexis distributed under the terms of theMITlicense.Similar utilitiesbundledocis a post-processor for thesnapshotpackage that bundles together all the classes, packages and files needed to build a given LaTeX document.