Changes

Jump to navigation Jump to search
469 bytes added ,  14:49, 20 January 2006
Added instructions how to enable simultaneous installation of stand-alone and MikTeX/TeX Live and changed the general instructions a bit; needs review!!!
===Installation Instructions===
 {{todo|I made an example how to use the stand-alone distr. isolated from an existing distro. I would like to "join" this somehow with the first section and move opening of <code>cdemo.bat</code> to something like <b>testing the installation</b>. Perhaps <tt>pragmatex.bat</tt> can be executed with autorun or something if one is not using another TeX distribution.}} ''by Ville Voipio on the mailing list, 2006-01-19''(modified)
Here is a step by step of how it should go (i.e. what I did with success):
# Get Install [[Windows Installation#Installing Perl and Ruby|Perl and install it. I use [http://www.activestate.com/Products/Download/Ruby]]# Download.plex?id=ActivePerl ActivePerl] (or [http://www.activestatepragma-ade.com/Productscontext/ActivePerl/?mp=1])# Get Ruby and install it. I used [http://rubyinstallermswincontext.rubyforgezip mswincontext.org Ruby Installerzip]. (see note below)# Check that Perl and Ruby work. Go to the command prompt (Start -> Run... "cmd") , unzip it and execute the two commands: <texcode>ruby --version<br>perl --version<move/texcode>These should give some information on Ruby and Perl. It really does not matter what they say, as long as rename the interpreters are found.# Download [mswincontext.zip]# Unzip the contents under <ttcode>c:\tempisoimage</ttcode>folder to your favourite destination. You should get The instructions to follow assume that you renamed <ttcode>c:\temp\isoimage</ttcode>. (see note below)# Create a new folder to <ttpre>c:\Programs\context</ttpre>. (see note below)# Copy everything under c:\temp\isoimage into c:\context. There should be one folder (<code>usr</usrcode>) and a few filesin it.# Open the folder <ttcode>c:\Programs\context</ttcode> and double-click <ttcode>cdemo.bat</ttcode>.
# Now you should see the editor SciTE open with a few files. Press F7 to compile one of the files.
If everything goes smoothly, you are done. If not, read these instructions again carefully. If you cannot get it work, mail the list.
 
{{todo|review this steps: change step numbers and join the information - notes about ruby, Acrobat, ... apply to all windows distributions.}}
A few notes on the procedure above:
 
* Perl and Ruby per se have nothing to do with ConTeXt, ConTeXt just needs them. So, if you have another Perl and Ruby (e.g. through cygwin), they are fine as long as they are in the system path. If you can get through step #3 without doing #1 and #2, fine.
* It is up to you to choose the location where you unzip the file in step #5, no magic there. Just that you know where the files are.
* The actual location of the ConTeXt in step #6 tree does not matter. I use <tt>c:\context</tt>, but you might use something else. However, I would not use anything with a space in the name (e.g. <tt>c:\Program Files\context</tt>), as that may confuse things. (Has anybody tried lately?)
* After you have verified everything works in step #9, you can toss <tt>cdemo.bat</tt> away and use <tt>cstart.bat</tt> to start everything. Make a link to it somewhere so that you can start the system by a shortcut or through the Start menu. ''Do not move the batch script anywhere,'' it has to be run in the root directory of the distribution (e.g. <tt>c:\Programs\context</tt>).
* Make sure you have something Acrobatish (any decent PDF viewer) installed, otherwise you won't see the results in step #9.
{{todo|explain how ===How to choose which ConTeX to execute in case there use the stand-alone distr. if you have MikTeX/TeX Live installed=== # Create a file <code>pragmatex.bat</code> (the name doesn't really matter) with this content: <pre>C:\Programs\context\usr\local\context\tex\setuptex.bat C:\Programs\context\usr\local\context\tex</pre> and make sure that this file is also visible by <code>PATH</code>.# You can safely continue using your old TeX distribution (MikTeX ot , TeX Live installed; , ...). If you want to invoke the stand-alone distribution, just execute <pre>pragmatex</pre> from the command-line and all the subsequent calls to <code>texexec</code> will use files from the stand-alone tree (you'll notice the difference in file names when running ConTeXt). ===Updating the installation=== {{todo|explain the best way for updating}}
== MikTeX or ProTeXt ==

Navigation menu