Skip to main content

The PreTeXt Guide

Section H.2 Installing from source

While the python3-louis system package appears to be updated frequently, if you need a more recent version of liblouis or simply feel a little more adventurous, you may wish to install liblouis directly from source following these instructions:
  • Download the liblouis-X.YY.0.tar.gz archive from the downloads page. Releases are tracked at the GitHub release page. The liblouisutdml package is not necessary.
  • tar -xvf liblouis-X.YY.0.tar.gz into a scratch directory like /tmp.
  • Switch to being root (sudo) and cd into the directory created by the extraction.
  • In your terminal run
    # ./configure --enable-ucs4
    # make
    # make install
    
    The “ucs4” flag enables 32-bit Unicode support, which is necessary for running tests later.
  • Read /tmp/liblouis-X.YY.0/python/README.md and perform two steps, still as root, from within the directory structure in /tmp: install the bindings into your Python distribution and run the Python tests. Instructions for setting up a Python virtual environment are also available in that file.
  • I do not do anything special to clean-up afterwards, and of course, my /tmp goes away on the next reboot. I also do not do anything special when installing the next version, I just follow the same procedure as a fresh install.