1,964
edits
Changes
Jump to navigation
Jump to search
m
* your favorite [[Text Editors|text editor]] and [[PDF Viewers|PDF viewer]]
* [[ConTeXt Minimals]]
* [[TeX-live]]
* [[MikTeX]] ('''broken''')
== ConTeXt Minimals ==
[[ConTeXt Minimals]] | http://minimals.contextgarden.net/
See also = [[Text EditorsConTeXt Standalone]].with TexWorks =
== For newbies (This assumes you are not already using a LaTeX distribution like Word (ex)users) ==MikTeX.
* '''# You do not need to install Ruby first unless you want to run MkII.# Download the ConTeXt Standalone [http://scintillaminimals.sourceforgecontextgarden.net/SciTEsetup/context-setup-mswin.html SciTEzip here]''': nicely integrated with Minimals; support written by Hans Hagen # 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 commandsis visible from the PATH.* '''[httpIn 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:\</notepad-pluscode>.sourceforgeThis will allow you to run ConTeXt from the command line anywhere, using <code>context filename.nettex</uk/sitecode>.htm Notepad++]'''* '''# Install the [http://www.winedttug.com WinEdtorg/texworks/ TexWorks]''': rich graphical user-interface, but more support for LaTeX than for ConTeXtstandalone and accept the default options upon installation.* '''[http:# Go to Preferences > Typesetting and add the directory where <code>context.exe<//wwwcode> is located.textpadIt is the same one you added to your PATH.com/ Textpad]'''* '''[http:## 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</wwwcode> and you are done.# Now populate the screen with ConTeXt code, select ConTeXt and press Typeset.toolscenterA PDF screen should pop up with the document.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 [[ConTeXt MinimalsText Editors|text editor]]** and [[TeX-live#PDF Viewer|PDF viewer]]** If this was too many options to your taste, try the [[MikTeXSimple Windows Installation]] ('''broken!!!''')* some scripting languages: ruby, perl, GhostScriptpage 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 [[Minimals]].'' == MikTeX (broken) == [[MikTeXConTeXt Standalone]] 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 [[LuaTeX]] available yet* binaries incompatible with Minimals and [[TeX Live]] See also* http://www.tug.org/protext/: MikTeX-based distribution, includes TeXnicCenter, GhostScript and WinEdt = Text Editor =
== 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]]
