Changes

Jump to navigation Jump to search
200 bytes removed ,  07:52, 28 September 2011
no edit summary
< [[Installation]] | [[ConTeXt Standalone/FAQ|Standalone/FAQ]] | '''[[ConTeXt Standalone/Tree|Standalone/Tree]]''' | [[ConTeXt Standalone/Structure|Standalone/Structure]] | [[ConTeXt Standalone/Implementation|Standalone/Implementation]] | [[ConTeXt Standalone/TODO|Standalone/TODO]] | [[ConTeXt Standalone/Contents|Standalone/Contents]] | [[ConTeXt Standalone/TeX Live|Standalone/TeX Live]] >
The '''ConTeXt StandaloneSuite''' is a complete, up-to-date ConTeXt distribution which can be upgraded efficiently. It can be used to install either the stable or the beta version of ConTeXt. It can also be used in parallel with existing TeX installations such as MikTeX, TeXLive, or older minimal installation. It is aimed towards ConTeXt users, so it does not include LaTeX specific packages and binaries.
{{Note | ConTeXt develops at a fast pace, and sometimes beta releases have serious bugs. ConTeXt standalone suit allows you to test the latest ConTeXt release without having to worry if an upgrade will mess an critical project. You can have two (or multiple) parallel ConTeXt Standalonessuits, and freeze one for your critical projects, and use the other one for experimenting.}}
ConTeXt is also included in TeXlive. The ConTeXt Standalone distribution suit is updated continuously, whereas ConTeXt in TeXlive is updated less often. In particular, <code>luatex</code> and <code>metapost</code> are under active development and their binaries are updated frequently. ConTeXt follows these developments, indeed often drives development. As the binaries included in the TeXlive distribution are only updated yearly, ConTeXt on TeXlive will necessarily be less current than the ConTeXt Standalone distributionsuit. (ConTeXt on TeXlive can be kept somewhat more current using the http://tlcontrib.metatex.org repository.) The ConTeXt Standalone distribution suit is self-contained and can happily coexist alongside another installed TeX distribution.
{{TOClimit|limit=1}}
== Dependencies ==
* [http://www.ruby-lang.org Ruby] 1.8 or newer (used for MKII)
* Rsync (The windows binary of rsync is distributed within the standalonesuit)
== Disc space required ==
ConTeXt macro files are small (less than 10MB), but the standalone suit comes with various free fonts which considerably increase the size of the distribution to around 200MB).
== Installation tree ==
This takes a long time, so go have a coffee.
By default, the standalone suit installs ConTeXt beta. If you want the stable version of ConTeXt, you can use
sh ./first-setup.sh --context=current
By default, the standalone suit does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use
sh ./first-setup.sh --modules=all
* on MacOS X you can use <code>/Applications/ConTeXt</code>
Note that, at present, while ''using'' MkIV, you need to have write permissions<ref>Actually, you only need write permission for <code>$TEXMFCACHE</code>.</ref> in the installation directory.<ref>This effectively means that only one user will be able to generate the formats</ref> So, if you are installing the standalone suit in <code>/opt/context</code> or <code>/Applications/ConTeXt</code>, run
chown `whoami` -R /opt/context
(<code>`whoami`</code> outputs your user name, you can type that directly, of course.)
In order to install the standalonesuit, open a terminal, go to the installation directory and download [http://minimals.contextgarden.net/setup/first-setup.sh first-setup.sh]:
$ rsync -av rsync://contextgarden.net/minimals/setup/first-setup.sh .
This takes a long time, so go have a coffee.
By default, the standalone suit installs ConTeXt beta. If you want the stable version of ConTeXt, you can use
sh ./first-setup.sh --context=current
By default, the standalone suit does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use
sh ./first-setup.sh --modules=all
== Usage ==
ConTeXt Standalone suit works in a non-interfering manner because it does not put anything in your <code>$PATH</code> and does not set any system variables. This in turn means that in order to use it, you need to do some initialization. An intialization script called <code>setuptex</code> is provided in <code>installation-dir/tex/</code>.
If you run context from a terminal, source <code>setuptex</code> before running ConTeXt. This depends on the shell that you are using.
== Exclusive usage ==
The above method means that you always have to type <code>source /installation-dir/tex/setuptex</code> in a terminal before you can use typeset. If you always use ConTeXt standalone suit and never use LaTeX or plain TeX provided by another TeX distribution, you can add the above intialization line 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 your terminal.
== Integrating with an editor ==
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>/installation-dir/tex/texmf-<platform>/bin</code> to your PATH in order to use the standalonesuit. You can try to add this to the paths that your editor searches.
For information about configuring [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Standalone/Mac Installation]]. If you don't mind investing a bit of money (abt eur 50), [http://macromates.com/ TextMate] with (the not yet officially released) [[ConTeXt Bundle for TextMate]] is an easy-to-install option.
== Updating ==
For updating the ConTeXt standalonesuit,
first update <code>first-setup.sh</code>, then run it. You could
also create an alias or a little script “ctx-update”
== Uninstalling ==
ConTeXt standalone suit does not touch anything outside its installation folder. So to uninstall it, you can simply remove the installation folder.
== Remaking formats ==
= Installation and use on Windows =
If you want to use ConTeXt standalone suit alongside MikTeX/TeXLive (needed if you also run LaTeX), follow the command-line installation method. Otherwise, you can follow either the command line or GUI installation method.
== Installation ==
This takes a long time, so go have a coffee.
By default, the standalone suit installs ConTeXt beta. If you want the stable version of ConTeXt, you can use
first-setup.bat --context=current
By default, the standalone suit does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use
first-setup.bat --modules=all
installation-dir\tex\setuptex.bat
on cmd.exe before you run ConTeXt. To avoid always having to type this, you can create a shortcut to cmd.exe and edit the command line to read (assuming you installed the standalone suit in <code>C:\Programs</code>; otherwise replace <code>C:\Programs\</code> with your installation directory)
C:\WINDOWS\System32\cmd.exe /k C:\Programs\context\tex\setuptex.bat
=== Use ConTeXt with Cygwin ===
After installing the ConTeXt standalonesuit, you can run it under Cygwin. With Cygwin, you may use gmake and other Unix tools for your automated workflow.
# Run <code>setuptex.bat</code> in DOS command prompt
== Updating ==
If you used the command line method, just run <code>first-setup.bat</code> again to update the standalonesuit. If you have third party modules installed, you should use
first-setup.bat --keep
to upgrade. See [[ConTeXt_Standalone#Installing_third_party_modules| Installing third party modules]] for details.
== Uninstallation ==
If you used the command-line installer, you can just delete the installation directory to uninstall the standalonesuit.
If you used the GUI installer, you can use standard windows tools for uninstallation.
= Installing third party modules =
The ConTeXt Standalone suit only comes with Taco's [[Bibliography|t-bib]] module. If you want to install [http://modules.contextgarden.net/ a new module], say Wolfgang's [[Letter|t-letter]] module, you can use
first-setup.sh --modules="t-letter"
47

edits

Navigation menu