Simon’s Improved Layout Engine
SILE is a typesetting system; its job is to produce beautiful printed documents. Conceptually, SILE is similar to TeX—from which it borrows some concepts and even syntax and algorithms—but the similarities end there. Rather than being a derivative of the TeX family SILE is a new typesetting and layout engine written from the ground up using modern technologies and borrowing some ideas from graphical systems such as InDesign.
First, have a look at the usage examples gallery. SILE allows you to:
Produce complex document layouts using frames.
Easily extend the typesetting system in a high-level programming language (Lua).
Directly process XML to PDF without the use of XSL stylesheets.
Typeset text on a grid.
A formula is available for Homebrew that can install either stable or head versions. For the latest prebuilt stable release:
$ brew install sile
Or to build and install from the latest git commit:
$ brew install sile --HEAD
$ brew tap homebrew/cask-fonts $ brew install --cask font-gentium-plus
Arch Linux packages are available in the AUR that can be built manually or with an AUR helper (e.g.
yay -S sile). Use sile for the latest stable release or sile-git to build from the latest git commit. Pre-built packages that may be directly installed with
pacman -S sileare available in @alerque’s package repository.
An official PPA is available with precompiled packages for Ubuntu.
$ sudo add-apt-repository ppa:sile-typesetter/sile $ sudo apt-get update $ sudo apt-get install sile
Void Linux packages are available in the default package manager.
There is no installer yet (track the status in issue #410), but prebuilt Windows binaries generated by the Azure build pipeline may be downloaded by selecting a build, opening the Windows job, selecting the artifact link from the final stage, and using the download button next to the sile folder. For tips on to how to build it yourself from source using CMake and Visual Studio, see issue #567.
Users of WSL (Windows Subsytem for Linux) may use the package manager of their choice depending on the system installed, including the respective Arch Linux or Ubuntu packages, Linux Brew, source, or Nix.
Docker images are available as siletypesetter/sile. Released versions are tagged to match (e.g.
v0.10.0), the latest release will be tagged
latest, and a
mastertag is also available with the freshest development build. In order to be useful you need to tell the Docker run command a way to reach your source documents (and hence also to give it a place to write the output) as well as tell it who you are on the host machine so the output generated inside the container can be created with the expected ownership properties. You may find it easiest to run with an alias like this:
$ alias sile='docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" siletypesetter/sile:latest' $ sile input.sil
One notable issue with using SILE from a Docker container is that it will not have access to your system's fonts by default. You can map a folder of fonts (any tree usable by fontconfig) into the container. This could be your system's default font directory, your user one, a project specific folder, or anything of your choosing. You can see where fonts are found on your system using
fc-list. The path of your choosing from the host system should be passed as a volume mounted on
/fontsinside the container like this:
$ docker run -it --volume "/usr/share/fonts:/fonts" --volume "$(pwd):/data" --user "$(id -u):$(id -g)" siletypesetter/sile:latest
Nix packages are available and can ben installed on several platforms.
SILE is written in the Lua programming language, so you will need a working Lua installation on your system (Lua 5.1, 5.2, 5.3, 5.4, and LuaJIT (2.0, 2.1, or OpenResty) are fully supported). It also relies on external libraries to access fonts and write PDF files. Its preferred combination of libraries is Harfbuzz and libtexpdf, a PDF creation library extracted from TeX. Harfbuzz (minimum version 1.1.3) should be available from your operating system's package manager. For Harfbuzz to work you will also need fontconfig installed. SILE also requires the ICU libraries for Unicode handling.
On macOS, ICU can be installed via Homebrew:
$ brew install icu4c
After that, you might need to set environment variables. If you try to
brew linkand you get a series of messages including something like these two lines, you will need to run that export line to correctly set your path:
For pkg-config to find icu4c you may need to set: export PKG_CONFIG_PATH="/usr/local/opt/icu4c/lib/pkgconfig"
luarocks install --deps-only sile-dev-1.rockspec). By default all the required Lua libraries will be downloaded and bundled alongside the SILE the instalation. If you downloaded a source tarball these dependencies are included, if you are using a git clone of the source repository the build system will require
luarocksto fetch them during build. Note that OpenSSL development headers will be required for one of the Lua modules to compile¹. If your system has all the required packages already you may add
./configurecommand to avoid bundling them.
¹ OpenSSL development headers are required to build luasec, please make sure they are setup BEFORE trying to build SILE! If you use your system's Luarocks packages this will be done for you, otherwise make sure you can compile luasec. You can try just this step in isolation before building SILE using
luarocks --tree=/tmp install luasec.
If you are building from a a git clone, start by running the script to setup your environment (if you are using the source tarball this is unnecessary):
Once your dependencies are installed, run:
$ ./configure $ make install
This will place the SILE libraries and executable in a sensible location.
On some systems you may also need to run:
$ sudo ldconfig
… before trying to execute
sileto make the system aware of the newly installed libraries.
There are actually many ways to run SILE remotely as part of a CI work flow. Because packages are available for many platforms, one way would be to just use your platforms native package installation system to pull them into whatever CI runner environment you already use. Another way is to pull in the prebuilt Docker container and run that.
As a case study, here is how a workflow could be setup in GitHub Actions:
name: SILE on: [push, pull_request] jobs: sile: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/[email protected] - name: The SILE Typesetter uses: sile-typesetter/[email protected] with: args: my-document.sil
Add to your repository as
.github/workflows/sile.yaml. This work flow assumes your project has a source file
my-document.siland will leave behind a
my-document.pdf. Note the comments in the section about Docker regarding version tags.
Since SILE v0.9.5, the default font has been Gentium Plus which is freely available from SIL’s site. It is not required that you install it, but if this font is not installed on your system, you won't be able to use the examples without modification. (Previously we used Gentium Basic, but that's getting harder to get hold of.)
If all goes well you should be able to compile one of the sample documents like this:
$ sile examples/book.sil SILE v0.10.10 (Lua 5.4)                               
You should now have
examples/book.pdfready for review.
Please read the full SILE manual for more information about what SILE is and how it can help you. There are example documents (source and PDF) in the examples/ directory. There's also an FAQ available.
SILE is distributed under the MIT licence.