Changes

{{todo|almost everything on this page is obsolete and should be removed; it is stil true that [http://www.miktex.org MikTeX ] is a magnificent apart from inability and very user-friendly Windows distribution for TeX, but for various historical reasons, mainly due to update lack of LuaTeX, ConTeXt and there are has been broken in MikTeX for a long time. Unless you have some issuesancient MikTeX with ancient ConTeXt lying around, but this article needs a complete rewrite}}ConTeXt will only work with '''MikTeX 2.9''' (or later; at the time of writing no newer version exists) that includes LuaTeX 0.70.1.

This page deals with some MikTeX 2.7 specifics about .. will become available once ConTeXtstarts working ...

= Installing ConTeXt = Problems ==

Manual installation As of ConTeXt end of June 2011 MikTeX is currently possible, but still (or again) non-functional... '''This section should will hopefully be removed as fixed soon as possible. (you can already replace the version of ConTeXt in MikTeX should be finally fixed!''' == Do not forget == Before porforming the steps written belowby your own), '''update MikTeX packages'''. === Things to check === Just a few things that you might want to check before proceeding ... * texmfstart doesn't exist Chowever some problems with ConTeXt MKIV will remain:\>texmfstart 'texmfstart' is not recognized as an internal or external command, operable program or batch file.* texexec misbehaves C:\>texexec texexec: The Windows command script file could not ConTeXt MKIV will never be found.''(texexec.exe has been present on this computer in <code>C:\Program Files\MiKTeX 2.7\miktex\bin</code>, but I don't know if that's because it was an old installation or because it's always there.)''* ruby is installed: you get C:\>ruby up-to-version ruby 1.8.6 (2007date and will hardly ever be hot-09-24 patchlevel 111) [i386-mswin32]instead of C:\>ruby 'ruby' is not recognized as an internal or external command, operable program or batch filefixed.* perl is installed (if you want to use mptopdf) == Install ConTeXt base files == Two slightly different ways to install ConTeXt in MikTeX are described below. Choose either of them (but not both; they are equivalent)only updates binaries every now and then. === Option 1: Installing into existing MikTeX architecture === ==== Download Since ConTeXt ==== * download [http://www.pragma-ade.com/context/current/cont-tmf.zip cont-tmf.zip] from http://www.pragma-ade.com/download-1.htm and unzip it into <code>C:\Program Files\MikTeX 2.7</code>MKIV strongly depends on LuaTeX version, so that you get: C:\Program Files\MiKTeX 2.7\bibtex C:\Program Files\MiKTeX 2.7\context C:\Program Files\MiKTeX 2.7\doc C:\Program Files\MiKTeX 2.7\... C:\Program Files\MiKTeX 2.7\web2cbut not C:\Program Files\MiKTeX 2.7\cont-tmf\bibtex\... ==== Add ConTeXt binaries ==== * Copy <code>texexec.bat</code> (and any other script that you might cannot be using, like <code>mptopdf.bat</code>) from C:\Program Files\MiKTeX 2.7\scripts\context\stubs\mswininto C:\Program Files\MiKTeX 2.7\miktex\bin * Delete C:\Program Files\MiKTeX 2.7\miktex\bin\texexec.exe C:\Program Files\MiKTeX 2.7\miktex\bin\mptopdf.exeupdated arbitrarily and any other <code>foo.exe</code> belonging to ConTeXt that has been replaced by <code>foo.bat</code> in the previous step. * Create a file <code>C:\Program Files\MiKTeX 2.7\miktex\bin\texmfstart.bat</code> updates may become out-of-sync with the following content: @echo off ruby "C:\Program Files\MiKTeX 2currently included LuaTeX version.7\scripts\context\ruby\texmfstartIf that happens, ConTeXt stops working.rb" %* === Option 2: Installing separately === ==== Download ConTeXt ==== * Create a new folder CMikTeX now ships for two architectures:\Program Files\ConTeXt * download [http://www.pragma32-ade.com/context/current/contbit and 64-tmfbit.zip contIf LuaTeX gets out-tmf.zip] from http://www.pragmaof-ade.com/download-1.htm and unzip into that foldersync on those two, so that you get: C:\Program Files\ConTeXt\bibtex C:\Program Files\ConTeXt\context C:\Program Files\ConTeXt\doc C:\Program Files\ConTeXt\.will necessary be broken on at least on of them.. C:\Program Files\ConTeXt\web2c ==== Set up a new tree in MikTeX ==== * Open Start Menu -> MikTeX 2Hans likes to reimplement every bit and piece of standard TeX installations (like kpathsea, texmf.7 -> Settings * In tab <code>Roots</code>cnf, choose <code>Add ...</code> button and add <code>C). This has two major consequences:\Program Files\ConTeXt</code> as a new path * In tab <code>General</code>, click on <code>Refresh FNDB</code> * Click <code>OK</code> ==== Add ConTeXt binaries to PATH ==== * Go to Control Panel -> System -> Advanced -> Environment Variables * Find <code>PATH</code> in <code>System Variables</code> and <code>Edit</code> it. Add ConTeXt stub path in front Author of the one for MikTeX, may not always be aware of modifications and might implement requirements for example replace: C:\Program Files\MiKTeX 2.7\miktex\bin;these features with C:\Program Files\ConTeXt\scripts\context\stubs\mswin;C:\Program Files\MiKTeX 2delay.7\miktex\bin;''(You could just as well copy all In the bat files you need from there to some other place in PATH. For most people copying texexec.bat is almost enough. The important thing is to either delete or shield texexec.exe from MikTeX.)'' * Open a new command line and make sure that you now get C:\>texexec 'texmfstart' is not recognized as an internal or external command, operable program or batch file. * Create a new file <code>texmfstart.bat</code> anywhere in your PATH, for example in C:\Program Files\meantime ConTeXt\scripts\context\stubs\mswin\texmfstartmight become broken.batwith the following content: @echo off ruby "C:\Program Files\ConTeXt\scripts\context\ruby\texmfstart.rb" %* * Check that you now get the correct response from command line C:\>texexec TeXExec | version 6.2.0 - 1997-2006 - PRAGMA ADE/POD TeXExec | --check check versions TeXExec | --figures generate overview Download of figures TeXExec | ... TeXExec | --help --all shows all switches == Make formats == * Go to packages on request doesn''Start Menu -> MikTeX 2.7 -> Settings -> Formats -> New ...'' {||-| '''Format key:'''| t work with ConTeXt | ''(could be anything)''|-| '''Format name:'''| cont-en| ''(could be anything)''|-| '''Compiler:'''| pdftex|-| '''Input file name:'''| cont-enMKIV.tex|-| '''Description:'''| The feature is hooked into kpathsea, ConTeXt format| doesn't use kpathsea, but doesn'(could be anything)''|-| (uncheck)| Exclude t provide any alternative for this format ..either.||} * Choose For all of the newly created format reasons already mentioned, the number of ConTeXt users on MikTeX is very small which means less testing and <code>Build</code> it.* For mptopdf uncheck the box for excluding as wellmore problems.