# lojban/cll

Complete Lojban Language Chunked
HTML CSS XSLT Ruby Shell Perl
Switch branches/tags
Nothing to show
Latest commit 5bda273 May 22, 2018
 Failed to load latest commit information. chapters Mar 25, 2018 conversion Dec 29, 2014 coverage Jun 13, 2016 dtd Aug 27, 2016 epub Aug 27, 2016 media Sep 22, 2014 official May 22, 2018 orig Aug 31, 2011 scripts May 22, 2018 xml Jul 13, 2017 .gitignore May 22, 2018 ACKNOWLEDGEMENTS Aug 31, 2011 CHANGELOG Jul 14, 2017 Dockerfile Feb 20, 2017 Gemfile May 22, 2018 Gemfile.lock May 22, 2018 LICENSE Sep 28, 2015 PRINCE-NOTES Dec 29, 2014 README Feb 26, 2017 README-tags Jun 13, 2016 README-updating.md Jul 14, 2017 README-urls Sep 28, 2015 TODO Jun 20, 2015 VERSION Sep 28, 2015 cll_build May 22, 2018 docker_init.sh Feb 26, 2017 run_docker.sh Feb 20, 2017

TO USE DOCKER:

Instead of ./cll_build below, use the same commands with:

./run_docker.sh

Note that it expects to need sudo to run docker commands; if that
causes a problem for you let me (rlpowell) know and we'll figure out
a fix, but needing sudo for docker is pretty common.

You don't *need* to use docker, but if you don't you'll have to put
together all the requirements yourself, and they'll need to match
versions, and so on.  I really strongly suggest using the Docker
version.

- ---

To make all the versions do:

./cll_build

The final results will end up under the build/ directory, scattered
about in various places.  If you would like the final outputs only
to be copied to another directory, you can use the -a option, so for example:

./cll_build -a output/

would put all the outputs in the output/ directory, whereas

./cll_build -a ~/public_html/cll_build/

would put them in your personal webspace.

Running a complete build takes quite a while (like probably at least
an hour).  To do it for just one chapter for faster testing:

./cll_build -t chapters/05.xml

This does the whole book but is also much faster:

./cll_build -t

There are many possible sub-targets as well, which are specified
with -T, such as:

./cll_build -t -T pdf

You can get a complete list of targets via:

./cll_build -h

Requirements
------------

Getting this all working is actually a pretty huge undertaking;
you're almost certainly better off asking Robin Lee Powell for an
account on the appropriate server.

General/HTML
------------

xsltproc

xmlto

Normal linux tools probably like tar.  You definitely need wget,
in particular.

The actual docbook packages (i.e. the docbook 5.0 XSLT stuff)

Ruby

All the Ruby gems mentioned in Gemfile; in fact the normal way to
do this sort of thing is:

$gem install bundler$ bundle install

and that should get all the dependencies for you (although I
(rlpowell) don't do it that way myself, so this is untested by me
and you might have to do "bundle exec ..." with your build
commands or something; regardless, there's only like 3 gem
dependencies).

PDF Generation
--------------

prince ( http://www.princexml.com/ )

MOBI / EPUB
-----------

ebook-convert (from calibre, but the yum package doesn't really
work; use the binary install at