Difference between revisions of "First-setup"

From Wiki
Jump to navigation Jump to search
(Make clear that --context=date only lets you choose a specific _stable_ version.)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{code|first-setup.sh}} or {{code|first-setup.bat}} is the script used to install and update ConTeXt. You can keep separate ConTeXt installations under separate directories, which is useful when, for example, you want to run both a stable and a. The script is a wrapper around {{code|mtxrun}} with  {{code|mtx-update.lua}} as a helper script, both in the {{code|bin}} directory directly under the installation root.
+
<!--
 +
Trying to get this title to display lowercase as 'first-setup'
 +
{{Lowercase title}} is not working, nor is invoking {{DISPLAYTITLE:...}} directly.
 +
Possibly enable $wgAllowDisplayTitle:
 +
http://www.mediawiki.org/wiki/Manual:$wgAllowDisplayTitle
 +
-->
 +
{{code|first-setup.sh}} or {{code|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 {{code|mtxrun}} with  {{code|mtx-update.lua}} as a helper script, both in the {{code|bin}} directory directly under the installation root.
  
To obtain the {{code|first-setup.sh}} script and/or update it:
+
To obtain the {{code|first-setup.sh}} script:
 
     cd /opt/context
 
     cd /opt/context
 
     rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh ./
 
     rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh ./
 
     # optional: make it executable.
 
     # optional: make it executable.
 
     # chmod +x first-setup.sh
 
     # 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:
 
To install or update ConTeXt:
Line 23: Line 31:
 
To update ConTeXt, retaining currently-installed modules:
 
To update ConTeXt, retaining currently-installed modules:
 
     sh ./first-setup.sh --keep
 
     sh ./first-setup.sh --keep
 +
 +
== See also ==
 +
 +
* [[Mtxrun|mtxrun]]
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 12:54, 8 December 2012

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