/flap

Flattening LaTeX projects

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

FLaP — Flat LaTeX Projects

last release on PyPI License Build status Code coverage Code quality Downloads

FlaP is a simple utility that flattens LaTeX projects. It takes a well-organised LaTeX project—one you so carefully crafted—and merged it into a vulgar single LaTeX file in a 'flat' directory.

  • Why? Some publishers require one such flat structure when you submit the sources of your manuscript, and I got tired to flatten the sources by hand.

  • Another one? There already a couple of tools that merge latex projects such as latexpand, flatex or flatten. As far as I know, they only merge TeX files, without moving graphics around. I learned recently about texDirflatten, which seems to be an alternative, but I haven't tried it.

Installation

FLaP requires Python 3 (3.6, 3.6, 3.8 and 3.9 are tested). The easiest way to install latest official release is to use pip using:

$ pip install flap

Alternatively, you get the latest development version using:

$ pip install git+https://github.com/fchauvel/flap.git

Should you want to look at the code, you may download the sources distribution and use

$ git clone https://github.com/fchauvel/flap.git 
$ cd flap
$ python setup.py install .`

Usage Example

For the newest (development) version, use:

$ flap project/main.tex output/directory

Prior to v0.4.1 (included), we invoke FLaP using:

$ python -m flap project/main.tex output/directory

See also the online documentation.

Contact Us

If you give FLaP a try, please report any bugs, issues or feature request using the issue tracker.