gardener, Interface administrators, Administrators
1,542
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
=== Packages ''Another distribution worth mentioning is [http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/web2c75-e.html W32TeX] that you need ===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 [[ConTeXt Standalone]].''
Try running texexec --versionIn most cases MikTeX should install the required package for = [[ConTeXt automatically (if not installed yet). It's additionally recommended to download [http://www.pragma-ade.com/context/current/cont-win.zip cont-win.zipStandalone] and to copy <code>texmfstart.exe</code> from the zip file into <code>[MikTeX PATH]\miktex\bin</code>.with TexWorks =
=== After This assumes you install or change something ===are not already using a LaTeX distribution like MikTeX.
* ''MikTeX Options # 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> General first-setup.bat</code> File name database from the command line. By default, this will download the beta version. If you want the stable version, add <code>--context=current</code> Refresh Now''* ''MikTeX Options # 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> General -. This will allow you to run ConTeXt from the command line anywhere, using <code> Format Files -context filename.tex</code> Update Now''.# Install the [http://www.tug.org/texworks/ TexWorks] standalone and accept the default options upon installation.* ''MikTeX Options -# Go to Preferences > Typesetting and add the directory where <code> Roots -context.exe</code> [select 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> Refresh FNDB''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.
''(Don't forget to run the <b>MikTeX Update Wizard</b> regularly!)''
== For newbies [like Word ''by Ville Voipio on the mailing list, 2006-01-19'' (exmodified)users] ==
{{todo|Explain the difference between GUI/text editor/compiler; people often ask meHere is a step by step of how it should go (i.e. what I did with success): "ConTeXt - oh, you mean that program with a blue screen and colourful fonts?"}}
* '''Scite''' or '''# Install Perl and Ruby# Download [http://www.winedtpragma-ade.com WinEdtnl/context/install/mswincontext.zip mswincontext.zip]''' or Textpad may , 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 good choice for few files in it.# Open the folder <code>c:\Programs\context</code> and double-click <code>cdemo.bat</code>.# Now you should see the editor SciTE open with a newbiefew 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, mail the list.
WinEdt has a rich graphical user{{todo|review these steps: join the information -interfacenotes about ruby, but more support for LaTeX than for ConTeXtAcrobat, ...ConTeXt support for Scite was written by Hans Hagen (ConTeXt developer himself) and also includes recognition and auto-completion(?) of most frequent ConTeXt commandsapply to all windows distributions.}}
See also (assuming C: [[Text editor]]\Programs\context) Start->Run->cmd cd C:\Programs\context cdemo.bat
{{todo|Someone should write how to install Scite & ConTeXt support for it without installing Then close the stand-alone ConTeXtSciTe window but remain in the cmd.}}
=== For gurus [like (La)TeX users or programmers] === Then, in one line: C:\Programs\context\usr\local\context\tex\setuptex.bat C:\Programs\context\usr\local\context\tex
You probably already have your favourite [[text editor]] (or at least you know what we're talking about) and you may skip this. If not, take a look at the [[Text editor]] page to help you choose one.* [[Vim]] or [http://www.emacswiki.org/cgi texexec -bin/wiki Emacs] may be a good choice if you're willing to invest some time into learning them - it may be worth the effort.make --all
== Compiling == Then, close the cmd, double-click in cdemo.bat and voila !
After you've done * Another way to do it could be to type: texexec --make --all that, you can finally use your favourite editor to write your [[First Document|first document]]directly in SciTe console.
To compile it, open ===How to use the command line again (Start stand-> Run alone distr... -> type '''cmd''' or '''command''') and run texexec yourfilenameif you have MikTeX/TeX Live installed===
Some text editors support automatic compiling# 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>.* F?? # 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 Scitefile 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 WinEdt* see [[Vim#Makefile|makefile]] for Vimyour .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.
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 ==
== MikTeX [[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)
==GhostScript = Additional settings === Some default "security settings" (not really relevant for you unless you run it on a server) may cause you troubles, esp. when using MetaFun. Do the following:* In <code>[MikTeX PATH]\tex\context\user\cont-sys.tex</code> uncomment the following lines:<texcode>\runMPgraphicstrue\runMPTEXgraphicstrue</texcode>* In case the file doesn't exist yet, copy the file <code>cont-sys.rme</code> (in the same folder) to <code>cont-sys.tex</code> first. <code>cont-sys.rme</code> may change every now and then, so check for major changes from time to time and update your <code>cont-sys.tex</code> accordingly.* Create a file <code>[localtexmf PATH]\miktex\config\miktex.ini</code> and add the following line to it: write18=enable''(Because of some unknown reason, <code>write18=enable</code> in <code>[localtexmf PATH]\miktex\config\miktex.ini</code> may be ignored on some computers. In that case make the change in <code>[MikTeX PATH]\miktex\config\miktex.ini</code>, but you may have to repeat this step every time you update MikTeX packages.)'' (<code>[MikTeX PATH]</code> and <code>[localtexmf PATH]</code> are chosen during the installation. If you don't know what they are, take a look at ''MikTeX Options -> Roots'') == TeX Live == * http://www.tug.org/texlive/ {{todo|can someone with any experience write something about it?}} == XEmTeX == * https://xemtex.groups.foundry.supelec.fr/ = Installing Perl and Ruby = * http://www.activestate.com/Products/ActivePerl/* http://www.ruby-lang.org/ You need the two scripting languages in other operating systems as well, but installing them under Windows may be a bit less intuitive for a newbie than under Linux. 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]. 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 perl --versionand ruby --versionwork OK. If windows complains about ''"Command not found"'', go to the ''Control Panel'' -> ''System'' -> ''Advanced'' -> click on the ''"Environment variables"'' and choose '''path''' in ''"system variables"''. Type in the path (e.g. D\Program Files\Perl\bin\;) where the ruby and perl *.exe files are installed. Generally, the installation is automatic. you may not need the above method. ''(Installing ruby is optional under Windows, but nevertheless recommended. Some scripts need ruby, although it may happen that you will never use those scripts.)'' = Installing GhostScript =
* http://www.cs.wisc.edu/~ghost/
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.
= Choosing a text editor & compiling 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 executed with autorun or something if one is not using another TeX distribution.}}
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,''(You need it has to install WinEdt AFTER be run in the installtion root directory of MikTeX, ghostscript and Acroreader for Windowsthe 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:
== PStoEDIT =Use the same .bat file to run ConTeXt with any .tex file===
[[Category:Installation]]
