Changes

Jump to navigation Jump to search
527 bytes added ,  16:01, 20 November 2012
m
{{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]]
* a TeX distribution
** [[ConTeXt Minimals]]
** [[TeX-live]]
** [[MikTeX]]
* some scripting languages: ruby, perl, GhostScript
If this was too many options to your taste, try the [[Simple Windows Installation]] page instead.
You first need to choose a TeX distribution. Options are:
* [[ConTeXt Minimals]]
* [[TeX-live]]
* [[MikTeX]]
 
== ConTeXt Minimals ==
 
[[ConTeXt Minimals]] | http://minimals.contextgarden.net/
== [[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) == [[MikTeX]] 2.7 | http://www.miktex.org
* great tool for people typsetting in LaTeX* updating packages is easy, (font) <b>packages are downloaded automatically</b>* very user friendly* ConTeXt is often outdated, but currently '''broken'''** (it's possible to do some tweaking to make it work)* no = [[LuaTeXConTeXt Standalone]] available yet* binaries incompatible with Minimals and [[TeX Live]]TexWorks =
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 gurus (like (La)TeX users or programmers) == These may be a good choice if assumes 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   = Tools = Ruby is absolutely required (unless you plan to use [[MK IV]] exclusively), Perl and GS are highly recommended, the rest is optionalnot already using a LaTeX distribution like MikTeX.
# 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]
# Run <code>first-setup.bat</code> from the command line. By default, this will download the beta version. If you want the stable version, add <code>--context=current</code>
# It is probably a good idea to make sure ConTeXt is visible from the PATH. In Windows 7, you should go to System > Advanced > Environment Variables and add <code>C:\context\tex\texmf-mswin\bin</code> to your user PATH, assuming you put your ConTeXt folder in <code>C:\</code>. This will allow you to run ConTeXt from the command line anywhere, using <code>context filename.tex</code>.
# Install the [http://www.tug.org/texworks/ TexWorks] standalone 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.
# Now populate the screen with ConTeXt code, select ConTeXt and press Typeset. A PDF screen should pop up with the document.
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.
 
== 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]]
= Special Notes =
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]]

Navigation menu