kaobook

A LaTeX class for books, reports or theses.

Acknowledgements

This class is based on the work of Ken Arroyo Ohori for his doctoral thesis. The main ideas behind the layout can be found in this blog post.

The Tufte-LaTeX class has also been a source of ideas about the layout.

Finally my gratitude goes also to Vel for his patience and his invaluable suggestions about the design.

Description

The salient features of the class are as follows.

• Wide margin to house captions, small figures or tables, and textual notes.

• Mini table of contents in the margin at the start of each chapter.

• Easily-customisable chapter headings.

• Flexible citations with references both in the margin and in the bibliography at the end.

• Powered by KOMA-Script.

• Many commands have been redefined to ease the life of the user.

A better description can be found at LaTeX Templates. If you think that a PDF is worth a thousand words, have a look at this.

Repository Schema

The main class file is kaobook.cls, which is used for books. There is another class file for articles, namely kaoartcl.cls, and in the future there may be classes for handouts, reports and theses. The commands common to all classes are in the kao.def file, while the class files contain only the class-specific commands.

There are two template files for the two supported classes, and each has its own bibliography file. Further examples are listed in the examples directory. The book that documents the class is an example itself, but the pdf is linked in the root of the repository so that it will be found easier.

The styles directory contains additional packages that are used by the class, but in principle they are independent of it (even though in practice it is still not so).

Usage

The class is documented and exemplified in the example_and_documentation.pdf file. To actually use it you can either clone the Git Hub repository or, much more easily, find the template at LaTeX Templates.

The easiest way to start using the class is to open the book template or the article template and edit them.

Contributing

Do you like the design, but you found a bug? Is there something you would have done differently? Any contribution is welcome! Moreover, even if you'd rather not tamper with the code it is not forbidden to send me the documents you compiled using the kaobook class.

Since the content of this repository is published at LaTeX Templates, if you wish to contribute by changing the code you must follow the style guidelines of the site: extensive commenting and clear separation of the code into nicely formatted blocks.

License

This repository contains two independent works. On the one hand, the kaobook class, consisting of kaobook.cls, kaoartcl.cls, and kao.def files plus all of the files listed in the styles directory; on the other hand, the examples in the examples directory.

The first work is licensed under the Linux Project Public License, so if you want to modify and/or distribute the *.cls and *.sty files pertaining to this work you have to complain with the terms of the license. However, if you just want to use the class to compile your documents you need not worry about the license.

The second work is released into the public domain with a Creative Commons Zero License.

Read MANIFEST.md for the details.