102
edits
Changes
Jump to navigation
Jump to search
m
==Download ConTeXt=={{note | You will need admin rights to your Windows to manage the installation process. If you don't have that, get somebody who does.}}
===Step 1: Get These instructions apply to ConTeXt versions from September 19, 2011. If you have used the installer===ConTeXt-SciTe combo earlier, remove all .properties files from your user folder and check that your SciTe is version 2.26 or newer (the newest version, at the time of writing 2.29, is recommended).
Windows Installation: ConTeXt Suite with SciTe (view source)
Revision as of 12:05, 6 June 2014
, 12:05, 6 June 2014The file path to SciTe files was incomplete, I updated it.
==Install ConTeXt== ===Step 1: Download and unzip the installer===Download [http://standalone.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] onto your computer. It contains a folder called <tt>context</tt>, '''unzip/extract that folder into the location where you want your final ConTeXt installation'''. It is recommended not to use folders with space in their name.Mari usually puts hers directly onto the main hard disk, i.e. C, so ConTeXt is normally located at <tt>C:\context</tt> on her Windows computers (both XP, Vista and W7). ===Step 2: Download Use installer to get the ConTeXt Suite=== Now go to your ConTeXt folder (e.g. <code>C:\context</code>). Run file <tt>first-setup</tt> (= <tt>first-setup.bat</tt>).If you just want the latest version of ConTeXt without any frills, you can just double-click the file name and it'll do the rest.If you want to install third-party modules like SimpleSlides, or if you prefer to install the most recent stable version of ConTeXt, you'll have to use Command Prompt. By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use first-setup.bat --context=current By default, the suite does ''not'' install [[Modules | modules]] and other third party content. If you want the modules e.g. [modules:simpleslides simpleslides] (and have the bandwidth for extra download) you can use first-setup.bat --modules=all Of course you can use both options at the same time first-setup.bat --context=current --modules=all Tip: You'll need to run <tt>first-setup.bat</tt> also to update your ConTeXt and/or to add modules afterwards. One way of making this easier is to copy the Command Prompt shortcut to the ConTeXt folder (e.g. from startup menu). Then right-click the icon, choose Properties and replace the text on the Start In line with your ConTeXt folder location (e.g. C:\context). When you double-click this shortcut, the Command Prompt starts directly in the correct folder and you don't have to remember any file paths (and you can even copy-paste the commands from this wiki page to the command line!). <div id="SearchPath"></div>===Step 3: Add ConTeXtto Windows search path=== You will have to go to the system settings of your Windows and add you will have to add <tt>C:\''yourcontextfolder''\tex\texmf-mswin\bin</tt> (eg <tt>c:\context\tex\texmf-mswin\bin</tt>)to the search path (environment variable <tt>path</tt> under advanced system properties). If you are the only user on the computer needing ConTeXt, you can put it under user variables, otherwise add it to the existing search path listing. After you've added the path to system settings, you have to reboot the computer. You can check that the path is there by opening command prompt and typing path If the resulting listing contains the address of your <tt>tex/texmf-mswin/bin</tt> directory, your computer knows where to find ConTeXt.
==Install SciTe==
Now you have ConTeXt. To complement it, i.e. to easily write and compile ConTeXt files, install the SciTe editor. It is a nifty open source editor that, with some adjustments, will be able to highlight ConTeXt code and run ConTeXt from inside the editor. (And it is pretty useful for e.g. html and php editing, too.)
===Step 1: Get SciTe===
There's a SciTe included in your ConTeXt Suite, but you'll get less hassle with user rights and such if you use Troy Simpson's [http://opensource.ebswift.com/SciTEInstaller/ Windows installer for SciTe]. Keep accepting everything it suggests and you'll get a very standard Windows program installed without any hassle. It also installs a so called context menu, i.e. you can right-click any text file (html, php, tex, txt) and give command "Edit with SciTe in New Tab" or "Edit with SciTe in New Window".
===Step 2: Fetch and install lexer add-in===
The ConTeXt versions dated September 20, 2011, or later use ''external lexers'' and for that you have to [http://foicica.com/scintillua/download Download the lexer add-in zip] (just get the top-most file of those listed in the download directory).
Then extract/unzip the contents of the lexer zip into a temporary directory. You get a directory <tt>scintillua''xxx-n''</tt> (e.g. <tt>scintillua229-1</tt>). Go to that directory and copy everything in it to your SciTe folder.
Leave the SciTe program folder open, you'll need next!
==Adjust SciTe to work with ConTeXt==
=== Copy setup files ===
Go to <tt>''yourcontextfolder''/tex/texmf-context/context/data/scite/context</tt> (e.g. <tt>C:\context\tex\texmf-context\context\data\scite\context</tt>). Copy everything from this folder to your SciTe program folder. If you only plan to use SciTe for ConTeXt, you can replace all files. If you want to keep all the existing functionality, copy the subfolder contents by hand, but make sure you get everything.
=== Import settings into SciTe ===
Open SciTe. Go to the <code>Options</code> menu and choose <code>Open Global Options File</code>. Scroll all the way to then end of the file and write
import scite-context-user
and save the file (you may have to fiddle with the file rights to get this done). If you are the only ConTeXt user on that computer, you can also put the import command into the User Options File.
Close/restart SciTe.
==Ready, steady, test!==
Now you are ready to go. Start SciTE and open a ConTeXt document (if you have any) or try with a simple "Hello world":
<pre>
\starttext
Hello, world!
\stoptext
</pre>
Save the document as <tt>''something''.tex</tt>, e.g. helloworld.tex. The syntax highlighting should come on and show the ConTeXt codes differently than the text itself.
[[File:helloworld.png|600px]]
Now press Ctrl+F12 to process your file and auto-open the resulting pdf in your default pdf reader (most often Adobe Acrobat Reader). The first run will take a while, but if things starts happening, you probably have working ConTeXt.
If you just get a one-line complaint about <tt>mtxrun</tt> not being found, go back to [[#SearchPath|Step 3 of ConTeXt installation]] and check you don't have any typos in the search path address. Then reboot and retry.
{{Installation navbox}}
