Skip to content

Advanced book classes and packages for the SILE typesetting system: A path for making books from front cover to back cover.

License

Notifications You must be signed in to change notification settings

Omikhleia/resilient.sile

Repository files navigation

resilient.sile

license Luacheck Luarocks

This collection of classes and packages for the SILE typesetting system provides advanced classes, packages and tools for streamlining the production of high-quality books and documents.

It offers a wide range of features, including:

  • At its core, a challenging and interesting “styling” paradigm, allowing to configure many styling decisions with a consistent and unified approach, abstracting the complexity.
  • A “master document” format, for easily combining your content from multiple files into a consistent work.
  • A pretty strong “book” class, with:
    • A mind-bogling choice of sound page layouts — old-fashioned or modern,
    • Almost everything you may expect for such a class: parts, chapters, sections, subsections, subsubsections…
    • Highly configurable table of contents, headers, footers, footnotes and sectioning environments,
    • And other useful features, from cross-references to advanced captioned figure and table environments, and more…
    • A great parity with Markdown, including many Pandoc-like extensions, and with Djot
  • A lightweight “résumé” class, for you to produce a colorful and yet professional-looking curriculum vitæ.

Whether you a seasoned typist or a beginner, the re·sil·ient collection aims at making the process of creating beautiful books as simple as possible, from front cover to back cover, using a lightweight markup language for most of the content, if not all of it.

Installation

These packages require SILE v0.14 or upper (recommended: SILE v0.15.5 or upper).

Installation relies on the luarocks package manager. See its installation instructions on the LuaRocks website.

To install the latest version and all its dependencies (see below):

luarocks install resilient.sile

(Refer to the SILE manual for more detailed 3rd-party package installation information and configuration options.)

Usage

A complete PDF version of the documentation (but not necessarily always the latest) should be available HERE, or in our Calaméo bookshelf.

See also

This collection also imports several modules also provided separately, would you find them useful on their own:

When used with this collection, the Markdown packages and the fancy table of contents are leveraged with additional capabilities.

Historical note

This collection is the successor of “Omikhleia’s classes & packages for SILE”, fully redesigned for SILE v0.14 or upper, and provided as a separate installable module.

Besides all the changes from SILE v0.12 to v0.14, and its new package and class APIs, the redesign entails many more things, with breaking changes.It can be considered as a v2.x of the former solution.

It therefore comes under a new name (also used as a namespace here and there), resilient. The name is a pun on “SILE” (as, after all, the initial target was always on redoing a book class that would satisfy my requirements), but there is a bit more to it than that, which might become more visible when the collection expands.

License

All code is under the MIT License.

The documentation is under CC-BY-SA 2.0.

The examples (i.e. anythings in the “example” folder) 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.

About

Advanced book classes and packages for the SILE typesetting system: A path for making books from front cover to back cover.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages