From Wiki
Jump to navigation Jump to search

Here are instructions for ConTeXt installation on Ubuntu and its derivatives [K/X/L]ubuntu.

Precompiled / Packaged Nightly Builds From PPA

Adam Reviczky was most generous to provide us with an Ubuntu PPA (Personal Package Archive) that contains precompiled Ubuntu packages for both ConTeXt and LuaTeX nightlies. Instructions for your version of Ubuntu are available for ConTeXt and LuaTeX.

With Ubuntu packages – should work with Ubuntu 16.04 and above

Note that Ubuntu's packaged version of ConTeXt is quite old (circa 2015), so a better option is the ConTeXt Standalone.

TeX Live and ConTeXt have been part of Ubuntu's main repositories since Ubuntu 7.10, so you can simply

 apt-get install context

to install ConTeXt and its dependencies (LuaTeX is part of the texlive-binaries package).

The dependencies pull in various PDF utilities which you will probably find useful, including pdfcrop.

If you would like to use the TeXworks GUI-based TeX editing environment usually included with TeX Live CDs, it is available via

 apt-get install texworks

and will appear under Applications, Science & Math.

See also:

Adding the system fonts

The standard Ubuntu LuaTeX package does not scan any of your installed system fonts. Therefore you will want to set up the OSFONTDIR environment variable to point to all the font paths. For example:

  export OSFONTDIR=~/.fonts:/usr/share/fonts:/usr/share/texmf/fonts/opentype/:/opt/libreoffice/basis3.3/share/fonts/

Once you have done that, run

   mtxrun --script fonts --reload

If you have an error do this

   luatools --generate

to scan all the font directories. Then run

   mtxrun --script fonts --list --all --pattern=*

to list all the fonts LuaTeX now knows about. Finally, run

   context --reload

to make sure ConTeXt's font cache is up to date.

If you are using TeXworks, you need to make sure that OSFONTDIR is set in the environment TeXworks runs in, because ConTeXt may decide it needs to rescan fonts.

With ConTeXt Standalone – should work with all Ubuntu versions

Example of setting up ConTeXt Standalone:

 sudo mkdir /usr/local/context
 sudo chown yourusername /usr/local/context
 cd /usr/local/context
 wget http://minimals.contextgarden.net/setup/first-setup.sh
 sh first-setup.sh
 vi ~/.bashrc

Add these three lines:

 export OSFONTDIR=~/.fonts:/usr/share/fonts                                                      
 export TEXROOT=/usr/local/context/tex                                         
 export PATH=/usr/local/context/tex/texmf-linux-64/bin:/usr/local/context/bin:$PATH

Note that the order of items in the PATH is significant. If you put /usr/local/context/bin in the path first, you will get an error at run time.

Also, remember that you have to source ~/.bashrc after changing it, in order to have the changes take effect in your current shell. (Either that, or start a new shell.)

Installing third party modules in ConTeXt Standalone

See here: Installing third party modules

Updating ConTeXt Standalone

The update procedure is similar to the normal procedure. If you installed the ConTeXt Standalone with the commands from above, you can update to a new (beta) version like this:

 cd /usr/local/context
 wget http://minimals.contextgarden.net/setup/first-setup.sh
 ./first-setup.sh --keep