GitHunt
FC

Flattening LaTeX projects

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.

Languages

Python100.0%

Contributors

GNU General Public License v3.0
Created August 12, 2015
Updated February 23, 2025