Changes

= Installation and use on Unix -like platforms (Linux/MacMacOS X/FreeBSD/Solaris) = == Shortest instructions == These are valid for MacOS X and probably most Linuxes; we expect you to running the ''bash'' shell; more information on that see within "Installation". Open a new shell window (Terminal on OSX). You're in your home folder (<code>~</code>) now.  Type the boxed sections. End every line with [Return]. Leave out the <code>$</code>, that's your shell prompt! Create the context folder and change into it:  $ mkdir context $ cd context Download <code>first-setup.sh</code>:  $ curl -o first-setup.sh http://minimals.contextgarden.net/setup/first-setup.sh Make it executable:  $ chmod a+x first-setup.sh Run it and go make tea:  $ sh ./first-setup.sh Run the ''path setup'':  $ ./tex/setuptex ConTeXt should work now (i.e. at this moment in this shell window); you need to run the path setup with every new shell (i.e. Terminal) window; to automate that, you can add the <tt>setuptex</tt> command to your "profile", that's a script that gets called with every new shell window.  $ cd $ echo "sh ~/context/tex/setuptex" >> .bash_profile That's it.

(If you followed the above "shortest instructions", you don't need to proceed here!) Select a folder where you want to install ConTeXt. For a single user installation, you can use your <code>$HOME/context</code> directory.  For a multi-user installation, in Linux you can use<code>/opt/context</code>; in Mac on MacOS X you can use <code>/Applications/ConTeXt</code> (You should '''not''' do that if you don't know what you do!) Note that, at present, while ''using'' MKIVMkIV, you need to have write permissions<ref>Actually, you only need write permission for <code>$TEXMFCACHE</code>.</ref> in the installation directory. So, if you are installing the minimals in <code>/opt/context</code> or <code>/Applications/ConTeXt</code>, run

In order to install the minimals, open a terminal, go to the installation directory (<code>cd ~/context</code>) and download [http://minimals.contextgarden.net/setup/first-setup.sh first-setup.sh], and place it in your installation directory:  curl -o first-setup.sh http://minimals.contextgarden.net/setup/first-setup. sh  Then open a terminal, go run that script to download the installation directory, whole distribution and runmake formats:

== Integrating with an editor Exclusive usage ==

If The above method means that you run ConTeXt from an editor, you need always have to source type <code>source /installation-dir/tex/setuptex</code> in a terminal before you can use typeset. If you always use ConTeXt minimals and then open never use LaTeX or plain TeX provided by another TeX distribution, you can add the above intialization line to the startup script of your editor from the same terminalshell. For information about configuring [http:bash, this means <code>$HOME/.bashrc</code>; for zsh, this means <code>$HOME/smultron.sourceforge.netzshrc</ Smultron] and [http:code>; for (t)csh, this means <code>$HOME//www.uoregon.educshrc</~kochcode> or <code>$HOME/texshop.tcshrc</obtainingcode>.html TeXShop] (which are popular TeX editors on Mac) see[[ConTeXt MinimalsThen, <code>setuptex</Mac Installation]]code> will always be sourced in your terminal.

The above method means that Depending on how your editor intializes, you always have may still need to source it in order to run ConTeXt directly from your editor, In theory, it is sufficient to type add <code>source /installation-dir/tex/setuptextexmf-<platform>/bin</code> to your PATH in a terminal before you can order to use typesetthe minimals. If you always use ConTeXt minimals and never use LaTeX or plain TeX provided by another TeX distribution, you You can try to add the above intialization line this to the startup script of your shell. For bash, this means <code>$HOME/.bashrc</code>; for zsh, this means <code>$HOME/.zshrc</code>; for (t)csh, this means <code>$HOME/.cshrc</code> or <code>$HOME/.tcshrc</code>. Then, <code>setuptex</code> will always be sourced in paths that your terminaleditor searches.

Depending on how your editor intializes, you may still need to source it in order to run ConTeXt directly from your editor, In theory, it is sufficient to add <code>For information about configuring [http:/installation-dir/texsmultron.sourceforge.net/texmf-<platform>Smultron] and [http:/bin</code> to your path in order to use the minimalswww. You can try to add this to the paths that your editor searchesuoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Minimals/Mac Installation]]

to upgrade. See [[ConTeXt_Minimals#Installint_third_party_modulesInstalling_third_party_modules| Installing third party modules]] for details.

If you want to use ConTeXt minimals alongside MikTeX/TeXLive (needed if you also run LaTeX), the follow the command-line installation method. Otherwise, you can follow either the command line or GUI installation method.

Download [http://minimals.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] and unzip to a directy directory where you want to install ConTeXt. It is recommended that you choose a directory that does not have a space in its full pahtpath. Then open <code>cmd.exe</code>, go to the installation directory and run

{{note| The GUI installer asks if you want to set environmental variables globally. Click this only if you do '''not ''' use MikTeX or TeXLive and do '''not ''' plan to use LaTeX}}

== command-line method: uninstallation Uninstallation ==

If you used the GUI installer, you can use standard windows tools for uninstalationuninstallation.

* If you're behind firewall and rsync times out , you need to open port 873 for outgoing TCP connections.

= Installint Installing third party modules =