Skribilo User Manual — Introduction |
Skribilo is a document production toolkit and a programming language designed for implementing electronic documents1. It is mainly designed for the writing of technical documents such as the documentation of computer programs. With Skribilo these documents can be rendered using various tools and technologies. For instance, a Skribilo document can be compiled to an HTML file that suits Web browser, it can be compiled to a TeX file in order to produce a high-quality printed document, and so on.
This manual documents Skribilo version 0.10.0. Since it is based on Skribe's user manual, you might stumble upon documentation bits that are obsolete or inaccurate in the context of Skribilo, although work is being done to fix it.
Anyone needing to design web pages, PostScript/PDF files or Info documents can use Skribilo. In particular, there is no need for programming skills in order to use Skribilo. Skribilo can be used as any text description languages such as LaTeX, Lout or HTML.
There are three main reasons for using Skribilo:
Skribilo is based on Skribe, which was designed and implemented by Manuel Serrano and Érick Gallesio. Although it departs from it on some aspects, it shares the overall design and philosophy. Érick and Manuel described the main design decisions behind Skribe in a paper published in the 2005 Journal of Functional Programming (JFP) entitled Skribe: A Functional Authoring Language. Although parts of the paper are slightly outdated, it gives a very good idea of Skribilo's innards, and notably contains a description of the 3 stages of documentation ``evaluation''.