First-setup

From Wiki
Jump to navigation Jump to search

first-setup.sh or first-setup.bat is the script used to install and update ConTeXt. You can keep separate ConTeXt installations under separate directories; this is useful if you want a stable version for your important projects, and like to use the latest features in your small projects, for example. The script is a wrapper around mtxrun with mtx-update.lua as a helper script, both in the bin directory directly under the installation root.

To obtain the first-setup.sh script:

   cd /opt/context
   rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh ./
   # optional: make it executable.
   # chmod +x first-setup.sh

The script self-updates when you run it, so you don't need to worry about that.

To install or update ConTeXt:

   sh ./first-setup.sh   # defaults to --context=beta
   sh ./first-setup.sh --context=beta      # latest beta
   sh ./first-setup.sh --context=current   # current stable version
   sh ./first-setup.sh --context=date      # a specific *stable* version

To install only Mark IV:

   sh ./first-setup.sh --engine=luatex

To install a module, multiple modules, or all modules:

   sh ./first-setup.sh --modules="t-letter"
   sh ./first-setup.sh --modules="t-letter,t-mathsets"
   sh ./first-setup.sh --modules=all

To update ConTeXt, retaining currently-installed modules:

   sh ./first-setup.sh --keep

See also