Difference between revisions of "Windows Installation: ConTeXt Suite with SciTe"

From Wiki
Jump to navigation Jump to search
(Ctx installation commands added.)
m (Scite Se)
Line 24: Line 24:
  
 
   first-setup.bat --context=current --modules=all
 
   first-setup.bat --context=current --modules=all
 +
 +
Tip: You'll need to run <code>first-setup.bat</code> 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!).
  
 
===Step 3: Add texmf to path===
 
===Step 3: Add texmf to path===
Line 40: Line 42:
  
 
Then extract/unzip the contents of the lexer zip into a temporary directory. You get a directory <code>scintillua''xxx-n''</code> (e.g. <code>scintillua229-1</code>). Go to that directory and copy everything in it to your SciTe folder.
 
Then extract/unzip the contents of the lexer zip into a temporary directory. You get a directory <code>scintillua''xxx-n''</code> (e.g. <code>scintillua229-1</code>). 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==
 
==Adjust SciTe to work with ConTeXt==
 +
 +
=== Copy setup files ===
 +
 +
Go to <code>''yourcontextfolder''/tex/texmf-context/data/scite</code> (e.g. <code>C:\context\tex\texmf-context\context\data\scite</code>). 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 <code>import scite-context-user</code> 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.

Revision as of 09:18, 18 October 2011


NOTE: You will need admin rights to your Windows to manage the installation process. If you don't have that, get somebody who does.

Download ConTeXt

Step 1: Get the installer

Download context-setup-mswin.zip onto your computer. It contains a folder called context, 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 C:\context on her Windows computers (both XP, Vista and W7).

Step 2: Get the ConTeXt Suite

Now go to your ConTeXt folder (e.g. C:\context). Run file first-setup (= first-setup.bat). 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 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 first-setup.bat 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!).

Step 3: Add texmf to path

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 Windows installer for SciTe. Keep accepting everything it suggests and you'll get a very standard Windows program installed without any hassle.

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 Download the add-in zip (just get the top-most file of those listed).

Then extract/unzip the contents of the lexer zip into a temporary directory. You get a directory scintilluaxxx-n (e.g. scintillua229-1). 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 yourcontextfolder/tex/texmf-context/data/scite (e.g. C:\context\tex\texmf-context\context\data\scite). 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 Options menu and choose Open Global Options File. 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.