Sources for test books, ready-to-compile with SILE.
I use them to check that re·sil·ient is working as expected; and to test new features and non-regression.
You are on your own checking that you have the right versions of the dependencies and a proper working installation:
-
SILE 0.15.5 or upper
See installation instructions on the SILE website.
-
See installation instructions on the LuaRocks website.
-
The re·sil·ient collection of classes & packages for SILE, a.k.a. resilient.sile.
luarocks install resilient.sile
Be sure to upgrade to the latest version (minimaly to 2.4 for best results).
-
Decent choice of fonts: Libertinus, EB Garamond, Zallman Caps, Lato.
Or see further down for a Docker image, if you prefer to be quickly bootstrapped without installing anything.
For any book in the repository, you can generate a PDF with the following command, run from the base folder of this repository:
sile -u inputters.silm book/book.silm
Where book/book.silm
is to be replaced by the path to the relevant document master file.
File | Description |
---|---|
dragon-de-brume-1/dragon-de-brume-5.silm | On some stars, flowers & places in Middle-earth, published volume. README. |
dragon-de-brume-2/dragon-de-brume-6.silm | On cartography, maps & locations in Middle-earth, published volume. README. |
dragon-de-brume-3/dragon-de-brume-hs.silm | A bibliography of Tolkien studies in French & English, published volume. README. |
File | Description |
---|---|
lovecraft/lovecraft.silm | A selection of short stories by H. P. Lovecraft, in French. READ. |
File | Description |
---|---|
lsg/lsg.silm | Bible Louis Segond 1910, in French. |
wulfila/wulfila.silm | Wulfila's Gothic Bible, in Gothic and English. README. |
If you have Docker installed, you can use the provided Docker file to build an image containing SILE, Luarocks, the re·sil·ient collection, other tools used by some of the modules, and a curated set of good fonts.
Everything is then ready for you to get quickly bootstrapped.
From the base folder of this repository, build an image:
docker build --progress plain . -f build/Dockerfile -t silex
Then create an alias, say resilient
, to run the image:
alias resilient='docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" silex'
And use it instead of sile
:
resilient -u inputters.silm book/book.silm
Be sure to rebuild the image from time to time, so that it is updated with the latest versions of the tools. This is assuming you know the basics of Docker, of course.
If you like this repository, please also star ⭐ resilient.sile, markdown.sile and obviously SILE too.
The books have varying licenses and some are used by courtesy of the authors.
Please check their respective license or ask, in case of doubts, for details and exact licensing terms.
By default, assume CC-BY-NC-SA 4.0 at best. The intent is that you can study the sources, and build them to produce your own PDF versions, but not use the latter without attribution and in commercial ways.
Extra clauses:
Distribution of these works or any derived works on websites such as Scribd is not allowed without our authorization. We consider it would be a violation of the Non-Commercial clause, due to the nature of their business model. Whether it stands legally or not, we explicitly forbid it.