gardener, Interface administrators, Administrators
1,542
edits
Changes
Jump to navigation
Jump to search
{{todo|also installation instructions for stand===Installation Instructions===''by Ville Voipio on the mailing list, 2006-01-alone since it19''s not very intuitive; also explain how to choose which ConTeX to execute in case there is also MikTeX ot TeX Live installed; explain the best way for updating}}
* https://xemtex.groups.foundry.supelec.fr/ == Installing Perl and Ruby ==
== For newbies Assuming that you already have Adobe Reader (if not, you can get it [like Word (exhttp://www.adobe.com/products/acrobat/readstep2.html here]; you don't need it to compile your documents, but at least to see the results)users, there is still some software still worth mentioning. * [http://www.pstoedit.net/pstoedit/ PStoEdit] for Windows is only needed in order to be able to use some advanced features such as those mentioned in [[manual:mmakempy.pdf|METAPOST outlines]]* [[LilyPond]]* [[Font Tools]] ==* ... ?
{{todo|Explain the difference between GUI/text = Choosing a [[Text editor/compiler; people often ask me: "ConTeXt - oh, you mean that program with a blue screen and colourful fonts?"}}]] & compiling =
See also: [[Text editor]]{{todo|Someone should write how to install SciTE & ConTeXt support for it without installing the stand-alone ConTeXt.}}
{{todo|Someone should write how to install Scite & ConTeXt support for it without installing the stand-alone ConTeXt.}}=== For gurus (like (La)TeX users or programmers) ===
=== For gurus [like (La)TeX users or programmers] === You probably already have your favourite [[text Text editor]] (or at least you know what we're talking about) and you may skip this. If not, take a look at the [[Text editor]] page to help you choose one.
= Other useful software =
Assuming that you already have Adobe Reader (if not, you can get it [http://www.adobe.com/products/acrobat/readstep2.html here]; you don't need it to compile your documents, but at least to see the results), there is still some software still worth mentioning.
== PStoEDIT ==
pstoedit for windows can be downloaded from http://www.pstoedit.net/pstoedit/
Only needed in order to be able to use some advanced features such as those mentioned in [[manual:mmakempy.pdf|METAPOST outlines]]
== See also ... ==
* [[LilyPond]]
* [[Font Tools]]
* ... ?
installation instructions for standalone distribution by Ville Voipio; some more changes
In order to be able to run ConTeXt under Windows, you will need the following:
* a stand-alone ConTeXt distribution or any other TeX distribution (such as MikTeX, TeX Live, ... )
* Perl, Ruby and GhostScript(Perl and Ruby are script languages, GS is a PostScript and PDF interpreter)* some text [[Text editor]]
* PDF viewer (Adobe Reader, GSview or any other)
Good reasons for choosing the stand-alone distribution are:
* if you don't need LaTeX* if you always want to have the very latest ConTeXt distribution
* ''... write some more''
Here is a step by step of how it should go (i.e. what I did with success): # Get Perl and install it. I use [http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl ActivePerl] (or [http://www.activestate.com/Products/ActivePerl/?mp= 1])# Get Ruby and install it. I used [http://rubyinstaller.rubyforge.org Ruby Installer]. (see note below)# Check that Perl and Ruby work. Go to the command prompt (Start -> Run... "cmd") and execute the two commands: <texcode>ruby --version<br>perl --version</texcode>These should give some information on Ruby and Perl. It really does not matter what they say, as long as the interpreters are found.# Download [mswincontext.zip]# Unzip the contents under <tt>c:\temp</tt>. You should get <tt>c:\temp\isoimage</tt>. (see note below)# Create a new folder <tt>c:\context</tt>. (see note below)# Copy everything under c:\temp\isoimage into c:\context. There should be one folder (/usr) and a few files.# Open the folder <tt>c:\context</tt> and double-click <tt>cdemo.bat</tt>.# 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. 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:\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 to choose which ConTeX to execute in case there is also MikTeX ot TeX Live installed; explain the best way for updating}} == MikTeX or ProTeXt ==
* http://www.miktex.org/
* http://www.tug.org/protext/ (MikTeX based distribution, includes TeXnicCenter, GhostScript and WinEdt)
MikTeX is probably the easiest and most recommended solution for newbies or for those who have already been using LaTeX and don't want to install anything else. MikTeX is very user-friendly, updating is very easy.
* ''MikTeX Options -> Roots -> [select one] -> Refresh FNDB''
''(Don't forget to run the <b>'''MikTeX Update Wizard</b> ''' regularly!)''
=== Additional settings ===
Some default "security settings" (not really relevant for you unless you run it on a server) may cause you troubles, esp. when using [[MetaFun]]. Do the following:
* In <code>[MikTeX PATH]\tex\context\user\cont-sys.tex</code> uncomment the following lines:
<texcode>
may help you solving some problems.
== TeX Live or XEmTeX ==
* http://www.tug.org/texlive/
* https://xemtex.groups.foundry.supelec.fr/ (TeX Live based distribution including Perl, Emacs and GhostScript)
[http://www.tug.org/texlive/doc/texlive-en/live.html#x1-200006 Installation instructions] are part of the documentation.
{{todo|can someone with any experience write something about it?}}
== XEmTeX =Required and Useful Tools =
* http://www.activestate.com/Products/ActivePerl/
* http://www.ruby-lang.orgor http://rubyinstaller.rubyforge.org
You need the two scripting languages in other operating systems as well, but installing them under Windows may be a bit less intuitive for a newbie than under Linux.
''(Installing ruby is optional under Windows, but nevertheless recommended. Some scripts need ruby, although it may happen that you will never use those scripts.)''
== Installing GhostScript ==
* http://www.cs.wisc.edu/~ghost/
You have to download GhostScript (filename '''<code>gs851w32.exe</code>''' or a similar one) and preferrably GSview as well ('''<code>gsv47w32.exe</code>''' or similar). Be sure to include the executables (folder where gswin32.exe is located) into the PATH variable.
= Choosing a text editor & compiling = Other useful software ==
== For newbies (like Word (ex)users) == {{todo|Explain the difference between GUI/text editor/compiler/PDF document; people often ask me: "ConTeXt - oh, you mean that program with a blue screen and colourful fonts?"}} * '''SciteSciTE''' or '''[http://www.winedt.com WinEdt]''' or Textpad may be a good choice for a newbie.
WinEdt has a rich graphical user-interface, but more support for LaTeX than for ConTeXt.
ConTeXt support for Scite SciTE was written by Hans Hagen (the ConTeXt developer himself) and also includes recognition and auto-completion(?) of most frequent ConTeXt commands.
''(You need to install WinEdt AFTER the installtion of MikTeX, ghostscript GhostScript and Acroreader Adobe Reader for Windows.)''
* [[Vim]] or [http://www.emacswiki.org/cgi-bin/wiki Emacs] may be a good choice if you're willing to invest some time into learning them - it may be worth the effort.
Some text editors support automatic compiling:
* F?? in SciteSciTE
* ?? in WinEdt
* see [[Vim#Makefile|makefile]] for Vim
[[Category:Installation]]
