Laidout Version 0.097.1

https://laidout.org

The latest releases: https://github.com/Laidout/laidout/releases

What it can do right now

Laidout is desktop publishing software built from the ground up with imposition in mind. Currently one may arrange pages into various impositions, such as a booklet, or even a dodecahedron. You can fill pages with images, gradients (linear, radial, and mesh), mesh transformed images, engraving-like fill objects, and some basic text. Export with varying degrees of success to Svg, Scribus, Pdf, and more.

See it in action here: https://www.youtube.com/playlist?list=PL22F7148142927C13

Sometimes there are experimental tools you can activate by running: laidout --experimental or laidout -E

Please post about any snags to Laidout's github issue tracker: https://github.com/Laidout/laidout/issues.

Laidout is currently in the 'mostly works on my machine' stage of development. It was created and developed by Tom Lechner (https://www.tomlechner.com) since around 2005.

System Requirements

Currently, Laidout only runs in variations of Linux. It is being developed on a Debian stable system, thus that one is the most hassle free to setup.

Laidout should work on variations of mostly recent Linux distributions, and also Macs.

Laidout will not currently run on Windows. Feel free to subsidize a port by showering the developer with money.

Please see https://laidout.org/faq.html for some extra help. Let me know if you get stuck trying to install. It is supposed to be easy!

Compiling Releases

If you are compiling from development git, not from a release, please see Compiling from development git below.

You will need a few extra development libraries on your computer in order to compile Laidout. Running ./configure does a simple check for these, but the check is so simple, that it may miss them or otherwise get confused.

For everything, you will need the header files for at least: harfbuzz, freetype2, fontconfig, cairo, graphicsmagick++, x11, ssl, cups, gegl, sqlite3, ftgl, opengl, Imlib2

If you are on a debian based system, you can probably install these with this command:

apt-get install g++ pkg-config libpng-dev libreadline-dev libx11-dev libxext-dev libxi-dev libxrandr-dev libxft-dev libcups2-dev libimlib2-dev libfontconfig-dev libfreetype6-dev libssl-dev xutils-dev libcairo2-dev libharfbuzz-dev libsqlite3-dev libgraphicsmagick++1-dev mesa-common-dev libglu1-mesa-dev libftgl-dev zlib1g-dev libgegl-dev

On Fedora, this list is more like this:

sudo dnf install -y gegl-devel cairo-devel cups-devel fontconfig-devel ftgl-devel glibc-headers harfbuzz-devel imlib2-devel lcms-devel libpng-devel libX11-devel libXext-devel libXft-devel libXi-devel mesa-libGL-devel mesa-libGLU-devel openssl-devel readline-devel sqlite-devel xorg-x11-proto-devel zlib-devel GraphicsMagick-c++-devel libstdc++-devel freetype-devel imake

Some of the above packages are technically optional. See Optional Dependencies section below for more about that.

To compile and install Laidout, just run these three easy steps:

./configure
make
make install
(or sudo make install)

Note that if your computer has, say, 8 processors, you can compile much faster using make -j 8 instead of plain make.

Run ./configure --help for a full list of configuration options.

make install will put laidout-(whatever version) in (usually) /usr/local/bin, and make a symbolic link /usr/local/bin/laidout point to it. To install elsewhere, do: ./configure --prefix=/path/to/somewhere/else

You do not need to make install in order to run. Simply run src/laidout. Laidout does not really depend on any other files, but you may be missing icons. If you do this , you can set a specific place or places to search for icons by modifying the file ~/.config/laidout/(version)/laidoutrc. This will have been created the first time you run Laidout. Open this file, and if the magic worked, simply uncomment the line for icon_dir and set to the directory you want. For the uninstalled icons, this would be (this directory)/src/icons.

Making a deb package

If you want to create a deb package of Laidout, make sure you have the fakeroot, dpkg-dev, and debhelper packages installed, and have all the other packages listed from the Compiling Releases section above, and do this from the top laidout directory:

touch Makefile-toinclude
make deb

This makes sure there is a "debian" directory, then calls dpkg-buildpackage -rfakeroot.

If the magic works, you will find installable packages in the directory directly above the Laidout directory. If it does not work, please let me know so I can fix it!

If the magic does NOT work, and you fail with this error:

dpkg-shlibdeps: error: no dependency information found for /usr/lib/libGL.so.1

then you need to change: dh_shlibdeps in debian/rules to: dh_shlibdeps --dpkg-shlibdeps-params=--ignore-missing-info Maybe something to do with non-packaged NVidia drivers?

If you do run into problems and have to run make deb again, you might want to run with -nc option, so you don't have rebuild everything again.:

dpkg-buildpackage -rfakeroot -nc

Optional Dependencies

If you get in a bind about dependencies, from ./configure you can disable certain libraries to aid in compiling.

Specifically:

• OpenGL: If you don't need the opengl polyhedron unwrapper, use --nogl
• Sqlite: If you don't care about Fontmatrix font tags, use --disable-sqlite
• Gegl: If you don't want to mess around with gegl, it's trickier, but just probably just comment out geglnodes.so in src/plugins/Makefile

Compiling from development git

Compiling from git source requires a few more steps than compiling releases. Be advised that the dev version may be rather buggy compared to "stable" versions!

Here is a fast and easy way to get Laidout up and running from development source:

1. Grab Laidout source from github (make sure the git package is installed):

    git clone https://github.com/Laidout/laidout.git
   

2. Laidout is currently built upon its own custom gui library called the Laxkit (http://github.com/Laidout/laxkit).

   Enter the laidout directory and optionally get the Laxkit source. If you do not clone the Laxkit repo, it will be cloned automatically during ./configure:

    cd laidout
    git clone http://github.com/Laidout/laxkit.git laxkit
   

3. Compile the goods. Make sure you have all the packages from the Compiling Releases section above, then do this:

    ./configure --prefix=WHERE_TO_INSTALL
    make
   

   Do NOT make install yet. Also note that if your computer has, say, 8 processors, you can compile much faster using make -j 8 instead of plain make.

4. Icons. Steps 1-3 have (ideally) compiled everything. You can run Laidout (at src/laidout) without icons and also without installing it anywhere.

   When downloading development source code, the icons have not yet been generated. Making the icons requires Laidout to be built already, and will generate a couple hundred png icon files from ./src/icons/icons.svg, ./src/icons/icons-tiling.svg and ./laxkit/lax/icons/icons.svg. Each top level object in those files with ids that start with a capital letter will have an icon generated of the same name. To build icons from all three sources:

   cd src/icons
   make all-with-lax
   

   If for some reason you cannot see any icons after you run Laidout, even after you have generated them, you can tell Laidout to search particular directories for icons by adding a line like the following to ~/.config/laidout/(version)/laidoutrc:

   icon_dir /path/to/icon/directory
   

5. Ok, now do make install.

   A note about uninstalling. Work needs to be done on "make uninstall" to not remove things that were installed to those directories other than with "make install", such as the addition of extra resources. Right now, everything in prefix/share/laidout/(version) will be removed on uninstall (but not anything in ~/.config/laidout). If this is causing you difficulty, please let me know, and I'll try to finally fix this.

6. Running Laidout might spit out copious amounts of debugging info to stderr if you run from a terminal. If this is not desired, you can turn this off with make hidegarbage before doing make (the same goes for the Laxkit). Be advised that this requires Perl to be installed. Or, you can just run Laidout like this:

   laidout 2> /dev/null
   

   Also, if you make any changes to the include lines of source files, make sure to run make depends. This will update dependencies for the next time you compile.

Installing different versions at the same time

It is quite ok to install different versions of Laidout at the same time. The ~/.config/laidout/ directory keeps all the config information in subdirectories based on the version. The same applies for installed binaries and other resources that get put in prefix/share/laidout. This way, you do not risk clobbering or corrupting files from other versions.

You can change the version number manually by specifying it when you run ./configure with something like:

./configure --version=0.097-different

You should try to preserve the main version number (which is 0.096 in this example), or it might confuse Laidout at some point.

Though you can have different versions coexist, there is not currently an automatic way to convert resources from older laidout versions to newer ones. This is on my long to-do list, but is a low priority. If this is a problem, let me know!

If you build the deb package, you currently can only have one version at a time by default. To change that, you would have to tinker with debian/control. If this is something you need, please let me know, and I can make instructions for that.

Compiling on Mac OS X with homebrew

1. Install dependencies

    brew install coreutils
    brew unlink coreutils
    brew install harfbuzz graphicsmagick imlib2 openssl@1.1 sqlite gegl mesa-glu ftgl xinput cups
    brew install XQuartz
   

2. Configure

    export PKG_CONFIG_PATH=/usr/local/opt/openssl@1.1/lib/pkgconfig/
    ./configure --prefix=./install --relocatable  --extra-cppflags "-std=c++11 `pkg-config --cflags openssl`" --pkg-config-path "/usr/local/opt/openssl@1.1/lib/pkgconfig/" --extra-ldflags "`pkg-config --libs imlib2 openssl freetype2 sqlite3 imlib2 cairo x11 fontconfig GraphicsMagick++ xft xrender`"
   

3. Build

    make
    make install
   

Compiling on Windows

Sorry, you're out of luck at the moment. If this is important to you, and you don't want to figure it out yourself, feel free to subsidize a windows port with copious amounts of money.

Contributing and source code documentation

There is a lot of source code documentation available via doxygen, just type:

make docs

or if you want all documentation for the Laxkit and Laidout in one place, then make sure you have a link to the Laxkit source in the top Laidout directory, and do:

make alldocs

This will dump it all out to docs/html. In particular, you will have a rapidly expanding todo list. If you want to contribute, that is a good place to start. There is also a different sort of very lengthy low level task list here.

A down and dirty way to become aquainted with the source code is to download the Laxkit to the top laidout directory (if it is not there already), and change the following lines in the Doxyfile-with-laxkit to say YES rather than NO:

SOURCE_BROWSER         = YES
EXTRACT_ALL            = YES

Then from the docs directory, run doxygen Doxyfile-with-laxkit (or do make alldocs from top directory), which will generate a clickable source tree accessible from your favorite web browser.

By the way, all the code assumes tabs are 4 characters wide. (in vim, :set tabstop=4)

Also check out the dev page on the Laidout website: https://laidout.org/dev.html

License

Unless otherwise specified within particular files or folders, everything in Laidout is distributed under the GPL Version 3 license, and any contributions to the repo should be compatible with this license.