1,964
edits
Changes
Jump to navigation
Jump to search
m
* a TeX distribution
** [[ConTeXt Minimals]]
** [[TeX-live]]
** [[MikTeX]] ('''broken!!!''')
* some scripting languages: ruby, perl, GhostScript
NB. If this was too many options to your taste, try the [[Simple Windows Installation]] page instead.
* [[ConTeXt Minimals]]
* [[TeX-live]]
* [[MikTeX]] ('''broken''')
== ConTeXt Minimals ==
[[ConTeXt Minimals]] | http://minimals.contextgarden.net/
[[This assumes you are not already using a LaTeX distribution like MikTeX]] 2.7 | http://www.miktex.org
* great tool for people typsetting in LaTeX# You do not need to install Ruby first unless you want to run MkII.# Download the ConTeXt Standalone [http://minimals.contextgarden.net/setup/context-setup-mswin.zip here]* updating packages is easy# Run <code>first-setup.bat</code> from the command line. By default, this will download the beta version. If you want the stable version, (font) add <bcode>packages are downloaded automatically--context=current</bcode>* very user friendly* # It is probably a good idea to make sure ConTeXt is often outdatedvisible from the PATH. In Windows 7, but currently '''broken'''** (it's possible you should go to System > Advanced > Environment Variables and add <code>C:\context\tex\texmf-mswin\bin</code> to do some tweaking your user PATH, assuming you put your ConTeXt folder in <code>C:\</code>. This will allow you to make it work)run ConTeXt from the command line anywhere, using <code>context filename.tex</code>.* no # Install the [[LuaTeXhttp://www.tug.org/texworks/ TexWorks]] available yetstandalone and accept the default options upon installation.# Go to Preferences > Typesetting and add the directory where <code>context.exe</code> is located. It is the same one you added to your PATH.## Next, under Processing Tools, create a new one and call it anything you want. In the Progream field, enter the path of <code>context.exe</code>, the same as above. In the Arguments section, add <code>$fullname</code> and you are done.* binaries incompatible # Now populate the screen with Minimals ConTeXt code, select ConTeXt and [[TeX Live]]press Typeset. A PDF screen should pop up with the document.
See also
* http://www.tug.org/protext/: MikTeX-based distribution, includes TeXnicCenter, GhostScript and WinEdt
= ConTeXt Minimals with TexWorks =
Install ConTeXt MkIV with the GUI installer and accept the default options upon installation. This will install Context in folder c:\contextminimal
Install TexWorks and accept the default options upon installation. Goto EDIT>PREFERENCES>EDITOR>SYNTAX COLORING: SELECT CONTEXT>TYPESETTING>DEFAULT>SELECT CONTEXT>PROCESSING TOOLS: CONTEXT>EDIT>PROGRAM: context.cmd and ARGUMENTS: only $fullname>OK>OK
Now populate the screen with ConTeXt code, select ConTeXt and press Typeset. A PDF screen should pup up with the document.
= Text Editor =
See also [[Text Editors]] and [[Text Editors/Windows]].
== For newbies (like Word (ex)users) ==
* [[Scite]]: nicely integrated with Minimals; support written by Hans Hagen ConTeXt commands.
* [[Notepad++]]: easily configurable editor with lots of features. ConTeXt support available.
* '''[http://www.winedt.com WinEdt]''': rich graphical user-interface, but more support for LaTeX than for ConTeXt
* '''[http://www.textpad.com/ Textpad]'''
* '''[http://www.texniccenter.org/ TeXnicCenter]'''
== For gurus (like (La)TeX users or programmers) ==
These may be a good choice if you're willing to invest some time into learning them (may be worth the effort):
* [[Vim]]
* [http://www.emacswiki.org/cgi-bin/wiki Emacs]
== Compiling ==
After you've done all that, you can finally use your favourite editor to write your [[First Document|first document]].
To compile it, open the command line again (Start -> Run ... -> type '''cmd''' or '''command''') and run
texexec yourfilename
= PDF Viewer=
== Adobe Reader ==
* you can get it [http://www.adobe.com/products/acrobat/readstep2.html here]
= Tools =
Ruby is absolutely required (unless you plan to use [[MK IV]] exclusively), Perl and GS are highly recommended, the rest is optional.
== Ruby and Perl ==
* http://www.activestate.com/Products/ActivePerl/
* http://www.ruby-lang.org or http://rubyinstaller.rubyforge.org
You can download ActivePerl [http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl here] and Ruby [http://rubyinstaller.rubyforge.org/wiki/wiki.pl here] (automatic installation) or [http://ftp.ruby-lang.org/pub/ruby/binaries/mswin32/ here] (you need to extract files from zip and add ruby to PATH).
After installing check if these work OK:
perl --version
ruby --version
== Other useful software ==
There is still some software 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]]
* [http://gnuwin32.sourceforge.net/packages/unzip.htm unzip]
* [[LilyPond]]
* [[Font Tools]]
* ... ?
== Older versions of Windows ==
The stand-alone distribution only works for newer versions of Windows that have cmd.exe instead of command.com as command interpreter. Running it on Windows 98 (or earlier) is also possible, but needs some tweaking (hardcoding the paths in .bat script). If you really need that and can't make it work alone, try to ask Taco.
== TODO - needs revision ==
{{Installation navbox}}
{{note | October 18, 2011: The contents of this page are partly obsolete. To start with, MK IV is warmly recommended nowadays, and the command used for various operations is no longer <code>texexec</code>, in MK IV it is (usually) <code>context</code>. At least try the other Windows installation pages, linked to this page, before following these instructions.}}
== Requirements ==
In order to be able to run ConTeXt under Windows, you will need:
* a TeX distribution
* some scripting languages: Ruby is absolutely required (unless you plan to use MK IV exclusively), Perl and GhostScript are highly recommended, the rest is optional.
* your favorite [[Text Editors|text editor]] and [[#PDF Viewer|PDF viewer]]
If this was too many options to your taste, try the [[Simple Windows Installation]] page instead.
== Updating ==
You first need to choose a TeX distribution. Options are:
== [[ConTeXt Standalone]] ==
* the official ConTeXt distribution
* easy to keep up-to-date
* no LaTeX
** if you don't need it, that's a rather small & convenient way to use ConTeXt
** if you need it, you can have minimals ConTeXt Standalone installed parallel to [[TeX Live|TL]] or [[MikTeX]]
There are two ways to install it on Windows:
* install from command-line (TODO: instructions)
== TeX Live == [[TeX Live]] 2008 | http://www.tug.org/texlive/==
* reference distribution for (La)TeX for all platforms
* released once per year and sent to members of TeX user groups on DVDs
* used to be gigantic; but since 2008 one can install separate packages and update them
* binaries are compatible with MinimalsConTeXt Standalone
* ConTeXt is outdated
** but it's possible to update it manually
** new ConTeXt update mechanism is being prepared
''Another distribution worth mentioning is [http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/web2c75-e.html W32TeX] that came to our attention when Akira (its author) was the first one to manage to compile [[XeTeX]] for Windows, and still provides the very latest Windows binaries for [[XeTeX]], [[LuaTeX]], [[pdfTeX]], [[MetaPost]], ... Distribution is a bit specific, but his binaries are great - compatible with [[TeX Live]] and used in [[MinimalsConTeXt Standalone]].''
== MikTeX (broken) =[[ConTeXt Standalone]] with TexWorks =
== GhostScript ==
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.
= Special Notes =
===Installation Instructions===
Here is a step by step of how it should go (i.e. what I did with success):
# Install [[Windows Installation#Installing Perl and Ruby|Perl and Ruby]]
# Download [http://www.pragma-ade.com/context/install/mswincontext.zip mswincontext.zip], unzip it and move/rename the <code>isoimage</code> folder to your favourite destination. The instructions to follow assume that you renamed <code>isoimage</code> to <pre>c:\Programs\context</pre> There should be one folder (<code>usr</code>) and a few files in it.
# Open the folder <code>c:\Programs\context</code> and double-click <code>cdemo.bat</code>.
# 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 visible by <code>PATH</code>.
# You can safely continue using your old TeX distribution (MikTeX, TeX Live, ...). 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).
# To avoid the need to open a new prompt each time you want to run ConTeXt, create another .bat file in your .tex file's folder with the following content:
<pre>call C:\Programs\context\usr\local\context\pragmatex.bat
context filename.tex</pre>
If you place the <code>pragmatex</code> file in your ConTeXt directory, this will allow you to call ConTeXt from anywhere on your computer with one click. The disadvantage is that it's linked to a specific .tex file.
===Use the same .bat file to run ConTeXt with any .tex file===
# You can use the .bat file above for any .tex file you have.
Just do the following modification:
<pre>call C:\Programs\context\usr\local\context\pragmatex.bat
context %1</pre>
and save it as ConTeXtthis.bat. Now, you can use it this way:
<pre>ConTeXtthis.bat anyfile.tex </pre>
Where anyfile.tex is your main ConTeXt source file. This whole instruction works well whit TeXnicCenter
{{Installation navbox}}
[[Category:Installation]]
