Complete Lojban Language Chunked
HTML CSS XSLT Ruby Shell Perl
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
chapters reorder words in the gloss of {jo'i} example Mar 25, 2018
conversion Moved some docs around. Dec 29, 2014
coverage Cleaning up FIXMEs. Jun 13, 2016
dtd Use local DTDs. Split out the non-appcache cleanup steps. Aug 27, 2016
epub I'll just quote from the changelog: Aug 27, 2016
media Prince PDF actually working; woo! Sep 22, 2014
official Rollup of many small changes. May 22, 2018
orig Docbook-specific branch Aug 31, 2011
scripts Unified diffs please, for vimdiff. May 22, 2018
xml Fixed up MathJax Jul 13, 2017
.gitignore A sourceforge mirror has gone. May 22, 2018
ACKNOWLEDGEMENTS Docbook-specific branch Aug 31, 2011
CHANGELOG Documentation update for the release process. Jul 14, 2017
Dockerfile Docker support. Tweaks to cll_build to work with said Docker support. Feb 20, 2017
Gemfile Gem updates. May 22, 2018
Gemfile.lock Gem updates. May 22, 2018
LICENSE Fixed #99 Sep 28, 2015
PRINCE-NOTES Notes update. Dec 29, 2014
README Another docs update, this one a bit more substantial. Feb 26, 2017
README-tags Cleaning up FIXMEs. Jun 13, 2016
README-updating.md Documentation update for the release process. Jul 14, 2017
README-urls Added backwards-compatible anchors and notes on same. Sep 28, 2015
TODO SO MUCH WORK from #21 Jun 20, 2015
VERSION Fixed #104 Sep 28, 2015
cll_build A sourceforge mirror has gone. May 22, 2018
docker_init.sh Accidentally made docker a hard requirement; oops. Fixed. Feb 26, 2017
run_docker.sh Docker support. Tweaks to cll_build to work with said Docker support. Feb 20, 2017

README

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
    https://calibre-ebook.com/download_linux )

    Xvfb and xvfb-run (fake X for calibre) or a running X server
    session -- MAYBE NOT ACTUALLY NEEDED