Omikhleia / awesome-sile-books

Sources for test books ready-to-compile with SILE
Other
12 stars 0 forks source link
books sile

awesome-sile-books

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.

Check the pre-requisites

You are on your own checking that you have the right versions of the dependencies and a proper working installation:

Or see further down for a Docker image, if you prefer to be quickly bootstrapped without installing anything.

Generate nice PDF of the books

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.

Published books

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.

Showcase booklets

File Description
lovecraft/lovecraft.silm A selection of short stories by H. P. Lovecraft, in French. READ.

Advanced experiments

File Description
lsg/lsg.silm Bible Louis Segond 1910, in French.
wulfila/wulfila.silm Wulfila's Gothic Bible, in Gothic and English. README.

Or with a ready-to-go Docker image

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.

Show your appreciation

If you like this repository, please also star ⭐ resilient.sile, markdown.sile and obviously SILE too.

License

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.