Skip to content

Latest commit

 

History

History
83 lines (55 loc) · 5.61 KB

README.md

File metadata and controls

83 lines (55 loc) · 5.61 KB

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.

Demonstration

Do you want to see what you can do with this collection? In addition to the nice “User Guide” documentation (see just below), there’s a whole repository of books and show-cases: Awesome SILE books.

Documentation

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

Did we say complete? Well, we lied a bit. For Markdown and Djot input, there is also a dedicated booklet, available HERE — or, again, in our Calaméo bookshelf.

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.)

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.