gardener, Interface administrators, Administrators
1,544
edits
Changes
Jump to navigation
Jump to search
m
In order to be able to run ConTeXt under Windows{{note | October 18, you will need the following2011:* a stand-alone ConTeXt distribution or any other TeX distribution (such as MikTeXThe contents of this page are partly obsolete. To start with, MK IV is warmly recommended nowadays, TeX Liveand the command used for various operations is no longer <code>texexec</code>, in MK IV it is (usually) <code>context</code>... )* PerlAt least try the other Windows installation pages, Ruby and GhostScript* some text editor* PDF viewer (Adobe Readerlinked to this page, GSview or any other)before following these instructions.}}
You have If this was too many options to bear in mind that ConTeXt is being developed reasonably fast (see your taste, try the [[Release NotesSimple Windows Installation]]), so it's recommended to update it regularypage instead.
* http://wwwYou have to bear in mind that ConTeXt is being developed reasonably fast (see [[Release Notes]]), so it's recommended to update it regulary.pragmaThe command ctxtools -ade-updateused to work OK, but is '''no more recommended'''.com/download-1All the three distributions mentioned here have their own way to update. We'll come back to that later (and move this section to a better place).htm
Good reasons for choosing the stand-alone distribution are:* you don't need LaTeX* you always want to have the very latest ConTeXt distribution* ''... write some more''= TeX Distributions =
{{todo|also installation instructions for stand-alone since it's not very intuitive; also explain how You first need to choose which ConTeX to execute in case there is also MikTeX ot a TeX Live installed; explain the best way for updating}}distribution. Options are:
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.== [[TeX Live]] ==
However, some more experienced users may not always * 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 happy with it:gigantic; but since 2008 one can install separate packages and update them* using fonts doesn't always work as expected (or at least different than in the stand-alone distribution)binaries are compatible with ConTeXt Standalone* ConTeXt format is usually recent, but not always the latestoutdated* * but it's difficult possible to change the source of update it manually** new ConTeXt core (for the sake of experimenting) and remake formats '''(if anyone doesn't agree here, please explain how you did it)'''update mechanism is being prepared
{{todo|write which "packages" from MikTeX ''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 needed to make great - compatible with [[TeX Live]] and used in [[ConTeXt work}}Standalone]].''
* http://wwwThis assumes you are not already using a LaTeX distribution like MikTeX.tug.org/texlive/
{{todo|can someone # 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 any experience write something about it?}}ConTeXt code, select ConTeXt and press Typeset. A PDF screen should pop up with the document.
== Installing Perl and Ruby ==
* http://www.activestate.com/Products/ActivePerl/* http://www.ruby-lang.org/== GhostScript ==
You can download ActivePerl [http://wwwHere is a step by step of how it should go (i.activestatee.com/Products/Download/Download.plex?id=ActivePerl here] and Ruby [httpwhat I did with success)://rubyinstaller.rubyforge.org/wiki/wiki.pl here].
After installing them (remember the folder where you've put them!) you have to check if both executables are included in the PATH# Install Perl and Ruby# Download [http://www. Open the command line (''Start'' pragma-> ''Run'' ade.nl/context/install/mswincontext.zip mswincontext. -zip], unzip it and move/rename the <code> type '''isoimage</code>cmdfolder to your favourite destination. The instructions to follow assume that you renamed <code>isoimage</code>''' or '''to <pre>c:\Programs\context</pre> There should be one folder (<code>commandusr</code>''') and check ifa few files in it. perl # Open the folder <code>c:\Programs\context</code> and double--versionclick <code>cdemo.bat</code>.and ruby --version# 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 OK, mail the list.
If windows complains {{todo|review these steps: join the information - notes about ''"Command not found"''ruby, Acrobat, go to the ''Control Panel'' -> ''System'' ... (<b>Can please someone with English version of Windows write the exact procedure how apply to add ruby & perl to PATH variable?</b>)all windows distributions.}}
== Installing GhostScript ==A few notes on the procedure above:* It is up to you to choose the location where you unzip the file in step #2, no magic there. Just that you know where the files are.* The actual location of the ConTeXt tree in step #2 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. [Seems to work with an August 2006 stand-alone distribution.]* After you have verified everything works in step #3, 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 #4.* A final note: to have it finally running you should build the formats first. To do so there is at least a way:
* http (assuming C://www\Programs\context) Start->Run->cmd cd C:\Programs\context cdemo.csbat Then close the SciTe window but remain in the cmd.wisc.edu/~ghost/* http Then, in one line: C://www\Programs\context\usr\local\context\tex\setuptex.ghostscript.com/bat C:\Programs\context\usr\local\context\tex texexec --make --all
If you already worked with (La)TeX before Then, you probably already have it installedclose the cmd, double-click in cdemo. Trybat gswin32 --versionand voila !
You have * Another way 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 do it could be to include the executables (folder where gswin32.exe is located) into the PATH variabletype: texexec --make --all directly in SciTe console.
{{todo|for those who come # 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 Word}}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:
== Other useful software ==<pre>call C:\Programs\context\usr\local\context\pragmatex.bat context filename.tex</pre>
Assuming that If you already have Adobe Reader (if notplace the <code>pragmatex</code> file in your ConTeXt directory, this will allow you can get to call ConTeXt from anywhere on your computer with one click. The disadvantage is that it [http://www.adobe.com/products/acrobat/readstep2.html here]; you don't need it s linked to compile your documents, but at least to see the results), there is still some software still worth mentioninga specific .tex file.
TODO# 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>
Only needed in order to be able to and save it as ConTeXtthis.bat. Now, you can use some advanced features such as those mentioned in [[manualit this way:mmakempy<pre>ConTeXtthis.bat anyfile.pdf|METAPOST outlines]]tex </pre>
=== See also Where anyfile.tex is your main ConTeXt source file.. ===This whole instruction works well whit TeXnicCenter
* [[LilyPond]]* [[Font Tools]]* ... ?{{Installation navbox}}
Text replacement - "pragma-ade.com" to "pragma-ade.nl"
== Which 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 choose? ==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]]
=== Stand-alone ConTeXt distribution =Updating ==
==[[ConTeXt Standalone]] = =* the official ConTeXt distribution* easy to keep up-to-date* includes (almost) everything that you need for ConTeXt* 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 ConTeXt Standalone installed parallel to [[TeX Live|TL]] or [[MikTeX ===]]
There are two ways to install it on Windows:* use GUI intaller by Vyatcheslav [http://wwwminimals.miktexcontextgarden.orgnet/setup/context-installer/] (sets environmental variables globally)* install from command-line (TODO: instructions)
=== TeX Live ==[[ConTeXt Standalone]] with TexWorks =
* http://www.cs.wisc.edu/~ghost/* http://www.ghostscript.com/ If you already worked with (La)TeX before, you probably already have it installed. Try gswin32 --version You need the two scripting languages in other operating systems have to download GhostScript (filename '''<code>gs851w32.exe</code>''' or a similar one) and preferrably GSview as well, but installing them under Windows may ('''<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=== {{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 a bit less intuitive for a newbie than under Linuxexecuted with autorun or something if one is not using another TeX distribution.}} ''by Ville Voipio on the mailing list, 2006-01-19'' (modified)
== Choosing a text editor & compiling =How to use the stand-alone distr. if you have MikTeX/TeX Live installed===
=== PStoEDIT Use the same .bat file to run ConTeXt with any .tex file===
[[Category:Installation]]
