Module installation

[Wolfgang Schuster <schuster.wolfgang@googlemail.com>]

Installation of modules
=======================


Basics
––––––

The installation of extra files in TeX (called modules in ConTeXt) can  
be hard
for people how are new in TeX or aren't interested in TeX programming  
themselve.

According to the TDS (TeX directory structure) and the ConTeXt  
developers user
written files reside under the path

     $TEXMF/tex/context/third/<modulename>/<files>

in the private TeX directory ($TEXMF), private directories can have  
the names

     • texmf-local
     • texmf-extra
     • texmf-project

but there existence depend on the TeX distribution and texmf-local is  
the most
common one.


Installation by hand
––––––––––––––––––––

When you want to install a new module which is available as file only  
create
the subdirectories in the way described above and place the file  
there, for
modules which are available as zip files with precreated  
subdorectories you
can unzip the archive in the top-level directory (e.g. texmf-local/)  
and all
files are on the correct place.

After the files are placed at the right place you have to update TeX's  
database
to let it know where it can find the files, this is done for MkII with

     mktexlsr (command name depends on the TeX distribution)

and for MkIV with

     context --generate


ConTeXt minimals
––––––––––––––––

Users of the ConTeXt minimals dont't have to download the module files  
and unzip
them in the local directory because they can use the 'first-setup' for  
this.

To install for example the simpleslides modules you write

     first-setup.sh --extras="t-simpleslides"

To install more modules at the same time write

     first-setup.sh --extras="t-simpleslides,t-french"

The complete list of availables modules in minimals is:

     • f-urwgaramond
     • f-urwgothic
     • t-account
     • t-algorithmic
     • t-bib
     • t-bnf
     • t-chromato
     • t-cmscbf
     • t-cmttbf
     • t-construction-plan
     • t-degrade
     • t-fixme
     • t-french
     • t-games
     • t-gnuplot
     • t-layout
     • t-letter
     • t-lettrine
     • t-lilypond
     • t-mathsets
     • t-simplefonts
     • t-simpleslides
     • t-taspresent
     • t-tikz
     • t-typearea
     • t-typescripts
     • t-vim


TeX Live
––––––––

# description required

The following modules are available:

     • context-account
     • context-bnf
     • context-chromato
     • context-construction-plan
     • context-degrade
     • context-french
     • context-games
     • context-gnuplot
     • context-letter
     • context-lettrine
     • context-lilypond
     • context-mathsets
     • context-simpleslides
     • context-taspresent
     • context-typearea
     • context-vim

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________