Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Book production engine
Python Perl Shell JavaScript
branch: master
Failed to load latest commit information.
bin fixes to soffice process logic, increase timeout to 20 s
bookland Correctly parse command line options
htdocs hide form fields related to lulu.com when inapplicable
objavi reorder the form fields related to lulu.com
perl move perl to its own place
templates update license information
tests Clean-ups leading from shift to separate htdocs directory
wikibooks2epub [Jan Gerber] fix unicode filenames in wikibooks2epub (from https://co…
.gitignore ignore test generated pdfs
CHANGES update CHANGES file
COPYING update license information
COPYING.GPL-2 update license information
INSTALL Clean-ups leading from shift to separate htdocs directory
README update license information
README.pdfnup add a modified pdfnup, with --paperwidth and --paperheight options
README.twiki Clean up Documentation: README is less crufty, TODO is gone
_espri-test move epub.py into objavi and test to _espri_test
apache-config-example-publish-domain Support for publishing html to stable urls (possibly on other domains)
apache-config-objavi2 update license information
digits.txt mapping language names to number systems
libobjavi.qs update license information
moz-print.js profile settings for command line print with mozilla
pdfnup.diff add a modified pdfnup, with --paperwidth and --paperheight options
rsync.sh make it easier to switch rsync to production server in emergencys
setup.sh Rename font-list.py to look like a pdf, because that is what it
wk_objavi.qs update license information

README

Objavi2: another FLOSS Manuals publishing system
================================================

Introduction
============

FLOSS Manuals books are written and stored as HTML, but are usually
converted to PDF, epub, or ODF for distribution or printing.  Programs
which perform this task are called objavi (pronounced "ob-Yah-vee"),
after the Croatian word "objavi!" meaning "publish!".

The previous objavi, Objavi beta, could produce very good PDF
documents using Latin text, but did not cope well with other scripts,
and could not produce other output.  Objavi 2 was originally written
just to provide fully internationalised PDFs, but it has since been
adapted to produce other formats.

Objavi 2 is free software, distributed under the version 3 or greater
of the GNU Affero General Public License.  The source can be viewed at

 http://booki-dev.flossmanuals.net/git?p=objavi2.git
 (or, alternatively, http://repo.or.cz/w/objavi2.git)

which also contains instructions for cloning the git repository.  If
you want a source tarball without worrying about git, try this link:

 http://repo.or.cz/w/objavi2.git?a=snapshot;h=HEAD;sf=tgz

It is primarily written in Python, with a substantial amount of
QSAScript (an ECMAscript variant) and some Javascript, HTML, and CSS.

The development of Objavi2 was supported by Internews.  It was
extended to produce epub documents with support from the Internet
Archive.


The objavi process
==================

Objavi2 starts with a "booki-zip", as defined in the file
"booki-zip-standard/txt".  This might be sourced from a Booki
instance, or from Twiki via the booki-twiki-gateway script, or perhaps
form an epub imported via Espri.

PDF Output
~~~~~~~~~~
If a PDF is required, the HTML is concatenated, various extra bits are
inserted, and the wkhtmltopdf program rederes it using WebKit.

At this point the PDF has no page numbers, no gutters, no table of
contents, and is using a too big paper size.  In order to write a
table of contents, an outline of the PDF is extracted and laid out as
html.  The table of contents thus generated is combined with other
preliminary pages and another PDF is created.

If a book PDF is required, Pdfedit is used to crop the pages down to
size and to shift them alternately left and right, creating a gutter
for the spine of the book.  Then pdfedit is used again to add page
numbers to both PDFs, with lowercase roman numbers being used for the
preliminary pages.

Finally the two PDFs are combined using pdftk and, optionally, spun
180 degrees so they appear upside down.  If a right-to-left book is
printed like this on a left-to-right printer, the binding will be on
the correct side.

Pdfedit and wkhtmltopdf both require an X server to run, for which
Xvfb is used.

For newspaper format, the page size is set to the column width, and
pdfnup is used to arrange the columns on another page.

OpenOffice output
~~~~~~~~~~~~~~~~~
ODF output was introduced with Objavi 2.1.  This uses an Open Office
instance controlled by pyuno.

Epub output
~~~~~~~~~~~
The html in the booki-zip is manipulated into xhtml using lxml, and
the structural information and metadata is converted into epub form.


Future plans
============

See http://booki-dev.flossmanuals.net/report

Installation
============

See the INSTALL file.  Apologies for its inadequacy.
Something went wrong with that request. Please try again.