Tubaina is a textbook generator which receives a simple markup language syntax and outputs Xhtml and Latex.
- August 07, 2012 A lot of bugs fixed and new features added since last update of this changelog, here are some of them:
- it's possible to define boolean variables (in a similar way as C ifdef) to be avaiable at ftl templates with the option -e <var1> <var2>...
- new output option (-kindle) added to generate html output focused on building ebooks such as .epub or .mobi formats.
- a book may be splitted in multiple parts simply by adding [part <title>] tag at the beginning of a chapter.
- a new tag to render code published at gist: [gist <gist-id>]
- September 15, 2011 Dropped support for one section per page, HTML. Instead, the -html option will generate an experimental one-page textbook (in which we're working :) ).
- April 28, 2011 Support to syntax highlighting using Pygments (in many many languages).
- October 24, 2010 Discontinuation of Maven as a build tool. Gradle is the new choice.
- Aug 17, 2009 New output format --htmlflat (HTML output with one page per chapter).
- Aug 6, 2009 Support for more than one chapter per afc file has been dropped. Please split your chapters in multiple files.
This project is built using Gradle (0.9rc1+). In order for it to behave like an Eclipse project you'll need to have Gradle installed (instructions to be found at: http://www.gradle.org/installation.html) and then run:
$ cd path/to/tubaina $ gradle eclipse
You need pygments to run the tests, you can install it through easy_install (you should be able to install easy_install with your SO package manager):
$ easy_install Pygments==1.5
In order to build the distribution version do:
$ cd path/to/tubaina $ gradle clean build zip
This will run the tests and, among other stuff, build a *.zip file with Tubaina's jar and all necessary libraries under
There's a Docker image that you can use to easilly install all dependencies of Tubaina.
If you want to build the latest version you can build your own image using this Dockerfile by running:
docker build -t csokol/tubaina src/docker/tubaina
If you don't want to build from latest sources, you can use the docker image available at DockerHub by running
docker pull csokol/tubaina
After installing the image, independently of building from sources of downloading from DockerHub, you can run
docker run -t -i csokol/tubaina java -jar /opt/tubaina/tubaina-1.8-SNAPSHOT.jar to execute tubaina jar.