gardener, Interface administrators, Administrators
1,546
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
* Go to miktex options''Another distribution worth mentioning is [http://www.fsci.fuk.kindai. select miktex TeX formatsac. choose any one format contjp/kakuto/win32-nl, contptex/web2c75-uke.html W32TeX] that came to our attention when Akira (its author) was the first one to manage to compile [[XeTeX]] for Windows, cont-de and cont-enstill provides the very latest Windows binaries for [[XeTeX]], [[LuaTeX]], [[pdfTeX]], [[MetaPost]], . uncheck the exclude. press build. The format file will be generated Distribution is a bit specific, but his binaries are great - compatible with [[TeX Live]] and ready for compilationused in [[ConTeXt Standalone]].''
{{todo|write which "packages" from MikTeX are needed to make = [[ConTeXt work}}Standalone]] with TexWorks =
=== TeX Live ===This assumes you are not 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/texlivetexworks/ 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.
{{todo|can someone with any experience write something about it?}}
You need the two scripting languages in other operating systems as wellIf you already worked with (La)TeX before, but installing them under Windows may be a bit less intuitive for a newbie than under Linuxyou probably already have it installed.Try gswin32 --version
After installing them (remember the folder where you've put them!) you have to check if both executables are included in the PATH. Open the command line (''Start'' -> ''Run'' ... -> type '''<code>cmd</code>''' or '''<code>command</code>''') and check if= Special Notes = perl --versionand ruby --versionwork OK.===Installation Instructions===
If windows complains about ''"Command not found"'', go {{todo|I made an example how to use the ''Control Panel'' stand-> ''System'' -> ''Advanced'' -> click on the ''alone distr. isolated from an existing distro. I would like to "Environment variablesjoin"'' this somehow with the first section and choose '''path''' in ''"system variables"''move opening of <code>cdemo. Type in bat</code> to something like <b>testing the path (einstallation</b>.gPerhaps <tt>pragmatex. D\Program Files\Perl\bin\;) where the ruby and perl *.exe files are installed. Generally, the installation bat</tt> can be executed with autorun or something if one is automatic. you may not need the above methodusing another TeX distribution.}}
== Installing GhostScript ==''by Ville Voipio on the mailing list, 2006-01-19'' (modified)
* http://www.csHere is a step by step of how it should go (i.wisce.edu/~ghost/* httpwhat I did with success)://www.ghostscript.com/
If # Install Perl and Ruby# Download [http://www.pragma-ade.nl/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 already worked with renamed <code>isoimage</code> to <pre>c:\Programs\context</pre> There should be one folder (La<code>usr</code>)TeX before, you probably already have and a few files in it installed. Try gswin32 --version You have to download GhostScript (filename '''# Open the folder <code>gs851w32.exec:\Programs\context</code>''' or a similar one) and preferrably GSview as well ('''double-click <code>gsv47w32cdemo.exebat</code>''' or similar). Be sure # Now you should see the editor SciTE open with a few files. Press F7 to include compile one of the executables (folder where gswin32files.If everything goes smoothly, you are done. If not, read these instructions again carefully.exe is located) into If you cannot get it work, mail the PATH variablelist.
== Choosing a text editor & compiling =={{todo|review these steps: join the information - notes about ruby, Acrobat, ... apply to all windows distributions.}}
=== For newbies 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. [like Word 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 (exany decent PDF viewer)users] ===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:
''' (TODOassuming C: Explain the difference between GUI/text editor/compiler; people often ask me\Programs\context) Start->Run->cmd cd C: "ConTeXt - oh, you mean that program with a blue screen and colourful fonts?")'''\Programs\context cdemo.bat
* '''Scite''' or '''[http://www.winedt.com WinEdt]''' may be a good choice for a newbie Then close the SciTe window but remain in the cmd.
WinEdt has a rich graphical user-interface Then, but more support for LaTeX than for ConTeXt.in one line:ConTeXt support for Scite was written by Hans Hagen (ConTeXt developer himself) and also includes recognition and auto-completion(?) of most frequent ConTeXt commands C:\Programs\context\usr\local\context\tex\setuptex.bat C:\Programs\context\usr\local\context\tex
''(You need to install WinEdt AFTER the installtion of MikTeX, ghostscript and Acroreader for Windows.)'' texexec --make --all
See also: [[Text editor]] Then, close the cmd, double-click in cdemo.bat and voila !
{{todo|Someone should write how * Another way to install Scite & ConTeXt support for do it without installing the standcould be to type: texexec --make --alone ConTeXtall directly in SciTe console.}}
You probably already have your favourite [[text editor]] # Create a file <code>pragmatex.bat</code> (or at least you know what wethe name doesn're talking aboutt really matter) with this content: <pre>C:\Programs\context\usr\local\context\tex\setuptex.bat C:\Programs\context\usr\local\context\tex</pre> and you may skip make sure that thisfile is visible by <code>PATH</code>. If not# You can safely continue using your old TeX distribution (MikTeX, TeX Live, take a look at the [[Text editor]] page to help you choose one.* [[Vim]] or [http://www.emacswiki.org). If you want to invoke the stand-alone distribution, just execute <pre>pragmatex</cgipre> from the command-binline and all the subsequent calls to <code>texexec</wiki Emacs] may be a good choice if code> will use files from the stand-alone tree (you're willing ll notice the difference in file names when running ConTeXt).# To avoid the need to invest some open a new prompt each time into learning them - it may be worth you want to run ConTeXt, create another .bat file in your .tex file's folder with the effort.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.
pstoedit # You can use the .bat file above for windows can be downloaded from httpany .tex file you have.Just do the following modification:<pre>call C://www\Programs\context\usr\local\context\pragmatex.pstoedit.net/pstoeditbat 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)
== Installing Perl and Ruby GhostScript ==
* http://www.activestatecs.com/Productswisc.edu/ActivePerl~ghost/* http://www.ruby-langghostscript.orgcom/
You can have to download ActivePerl [http://www.activestateGhostScript (filename '''<code>gs851w32.comexe</Products/Download/Downloadcode>''' or a similar one) and preferrably GSview as well ('''<code>gsv47w32.plex?id=ActivePerl here] and Ruby [http:exe<//rubyinstallercode>''' or similar).rubyforge.org/wiki/wikiBe sure to include the executables (folder where gswin32.pl here]exe is located) into the PATH variable.
=== For gurus [like (La)How to use the stand-alone distr. if you have MikTeX/TeX users or programmers] Live installed===
=== PStoEDIT Use the same .bat file to run ConTeXt with any .tex file===
[[Category:Installation]]
