Cleans the LaTeX code of your paper to submit to arXiv.
Project description
arxiv_latex_cleaner
This tool allows you to easily clean the LaTeX code of your paper to submit to
arXiv. From a folder containing all your code, e.g. /path/to/latex/
, it
creates a new folder /path/to/latex_arXiv/
, that is ready to ZIP and upload to
arXiv.
Example call:
arxiv_latex_cleaner /path/to/latex --im_size 500 --images_whitelist='{"images/im.png":2000}'
Installation:
pip install arxiv-latex-cleaner
Alternatively, you can download the source code:
git clone https://github.com/google-research/arxiv-latex-cleaner
cd arxiv-latex-cleaner/
python -m arxiv_latex_cleaner --help
And install as a command-line program directly from the source code:
python setup.py install
Main features:
Privacy-oriented
- Removes all auxiliary files (
.aux
,.log
,.out
, etc.). - Removes all comments from your code (yes, those are visible on arXiv and you
do not want them to be). These also include
\begin{comment}\end{comment}
environments. - Optionally removes user-defined commands entered with
commands_to_delete
(such as\todo{}
that you at the end redefine as the empty string).
Size-oriented
There is a 10MB limit on arXiv submissions, so to make it fit:
- Removes all unused
.tex
files (those that are not in the root and not included in any other.tex
file). - Removes all unused images that take up space (those that are not actually
included in any used
.tex
file). - Optionally resizes all images to
im_size
pixels, to reduce the size of the submission. You can whitelist some images to skip the global size usingimages_whitelist
. - Optionally compresses
.pdf
files using ghostscript (Linux and Mac only). You can whitelist some PDFs to skip the global size usingimages_whitelist
.
Usage:
usage: arxiv_latex_cleaner@v0.1.0 [-h] [--resize_images] [--im_size IM_SIZE]
[--compress_pdf]
[--pdf_im_resolution PDF_IM_RESOLUTION]
[--images_whitelist IMAGES_WHITELIST]
[--commands_to_delete COMMANDS_TO_DELETE [COMMANDS_TO_DELETE ...]]
input_folder
Clean the LaTeX code of your paper to submit to arXiv. Check the README for
more information on the use.
positional arguments:
input_folder Input folder containing the LaTeX code.
optional arguments:
-h, --help show this help message and exit
--resize_images Resize images.
--im_size IM_SIZE Size of the output images (in pixels, longest side).
Fine tune this to get as close to 10MB as possible.
--compress_pdf Compress PDF images using ghostscript (Linux and Mac
only).
--pdf_im_resolution PDF_IM_RESOLUTION
Resolution (in dpi) to which the tool resamples the
PDF images.
--images_whitelist IMAGES_WHITELIST
Images (and PDFs) that won't be resized to the default
resolution,but the one provided here. Value is pixel
for images, and dpi forPDFs, as in --im_size and
--pdf_im_resolution, respectively. Format is a
dictionary as: '{"path/to/im.jpg": 1000}'
--commands_to_delete COMMANDS_TO_DELETE [COMMANDS_TO_DELETE ...]
LaTeX commands that will be deleted. Useful for e.g.
user-defined \todo commands.
Note
This is not an officially supported Google product.
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.
Source Distribution
Built Distribution
Close
Hashes for arxiv_latex_cleaner-0.1.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8d5f1f90f42335da4a0682c42423b0a0d8ee1fed5c777931e10e8e9ce9c7a5ee |
|
MD5 | 54b4e4fee6a1d520f0319ca3bda0d2e9 |
|
BLAKE2b-256 | c2be4f5543f4001a42918d77b7e2a962f052fdd0f8363972e0e81a4ca6a0f26c |
Close
Hashes for arxiv_latex_cleaner-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 880f04cf04bb04039c6c2c5087aed186e33a416ab19f160caea5569d83aec793 |
|
MD5 | 8b118d9cedc669fd536a95cf3772c86d |
|
BLAKE2b-256 | daf6a309318d89aeb0eb4bfa73a1b17cf8a108d9bb670c7f21af5309a0224992 |