Changes
Jump to navigation
Jump to search
Simple Windows Installation (view source)
Revision as of 11:58, 8 September 2009
, 11:58, 8 September 2009How to install ConText Minimals with Scite on Windows XP or Vista so they work well together
''Note. Valid as of September 2009.''
This page gives instructions on how to easily install ConTeXt Minimals and the SciTe editor on your XP or Vista so that you can compile a document with a few mouse-clicks. If this is not what you want to do, see the [[Installation]] page instead.
== Step 1: Download all bits and pieces ==
* '''ConTeXt''': Vyatcheslav Yatskovsky's [http://minimals.contextgarden.net/setup/context-installer/ContextMinimalInstall.exe Windows installer] for the Minimals is the hassle-free alternative
* '''SciTE''' Editor: Go to Scintilla's [http://http://www.scintilla.org/SciTEDownload.html SciTE Download Page] and get [http://prdownloads.sourceforge.net/scintilla/wscite201.zip?download full download] in the "Windows executables" section. Make sure you get wscite.zip (''not'' scite.zip).
* '''Ruby''' (only needed for running pdftex, i.e. ConTeXt MKII): if you have files that need to be run in MKII/pdftex, [http://rubyinstaller.org/ download Ruby] (a scripting language, a bit like Perl); ''if you start from scratch, Ruby is not needed!''
Now you have all the files you need to successfully setup ConTeXt on your Windows computer. But do not drop the network connection yet! You will need internet to get the rest of ConTeXt while installing, which is why the Minimals Installer is so small itself.
== Step 2: Install ==
* Start ConTeXt installation by double-clicking on the downloaded installer .exe file.
** before or during installation you can refer to instruction [http://meeting.contextgarden.net/2008/talks/2008-08-21-vyatcheslav-win-installer/windows_installer.pdf slides]
** take note of where your ConTeXt gets installed, you'll need to find those files for configuration
** install the '''stable''' ConTeXt; you don't want your first tries to stumble on buggy beta code
** when the ConTeXt installer has finished, you can move away from the network if needed.
* Next, unzip SciTE to the location of your choice
* If you need Ruby, install it by double-clicking the downloaded installer file. ''Do not install SciTE via Ruby installer'' (even thought it'll offer that), the One True SciTE is the one you get from Scintilla
Now all the components of a working system are installed: ConTeXt Minimals and SciTE for ConTeXt MKIV (only), ConTeXt Minimals, SciTE and Ruby for ConTeXt MKIV and MKII.
== Step 3: Configure ==
# In your ConTeXt files (default name of the main folder is <tt>contextminimal</tt>) locate <tt>scite-ctx.lua</tt>. Copy this file to your recently unzipped SciTE folder (by default called <tt>wscite</tt>).
# Again in your ConTeXt files, locate <tt>scite-ctx.properties</tt> and <tt>context.properties</tt>. Copy these files to your ''personal profile folder''; in XP that's usually <tt>C:\Documents and Settings\''yourusername''\</tt> (or the equivalent in your language), in Vista <tt>C:\Users\''yourusername''</tt>.
# Now open SciTE by double-clicking on the SciTE icon. You still need to tell it where to look for the ConTeXt related settings. For this, go to the ''Options'' menu and click on ''Open User Options File''. You should get a blank page. Now type into the file
<pre>
import scite-ctx
import context
</pre>
# Save the file and close SciTE.
This page gives instructions on how to easily install ConTeXt Minimals and the SciTe editor on your XP or Vista so that you can compile a document with a few mouse-clicks. If this is not what you want to do, see the [[Installation]] page instead.
== Step 1: Download all bits and pieces ==
* '''ConTeXt''': Vyatcheslav Yatskovsky's [http://minimals.contextgarden.net/setup/context-installer/ContextMinimalInstall.exe Windows installer] for the Minimals is the hassle-free alternative
* '''SciTE''' Editor: Go to Scintilla's [http://http://www.scintilla.org/SciTEDownload.html SciTE Download Page] and get [http://prdownloads.sourceforge.net/scintilla/wscite201.zip?download full download] in the "Windows executables" section. Make sure you get wscite.zip (''not'' scite.zip).
* '''Ruby''' (only needed for running pdftex, i.e. ConTeXt MKII): if you have files that need to be run in MKII/pdftex, [http://rubyinstaller.org/ download Ruby] (a scripting language, a bit like Perl); ''if you start from scratch, Ruby is not needed!''
Now you have all the files you need to successfully setup ConTeXt on your Windows computer. But do not drop the network connection yet! You will need internet to get the rest of ConTeXt while installing, which is why the Minimals Installer is so small itself.
== Step 2: Install ==
* Start ConTeXt installation by double-clicking on the downloaded installer .exe file.
** before or during installation you can refer to instruction [http://meeting.contextgarden.net/2008/talks/2008-08-21-vyatcheslav-win-installer/windows_installer.pdf slides]
** take note of where your ConTeXt gets installed, you'll need to find those files for configuration
** install the '''stable''' ConTeXt; you don't want your first tries to stumble on buggy beta code
** when the ConTeXt installer has finished, you can move away from the network if needed.
* Next, unzip SciTE to the location of your choice
* If you need Ruby, install it by double-clicking the downloaded installer file. ''Do not install SciTE via Ruby installer'' (even thought it'll offer that), the One True SciTE is the one you get from Scintilla
Now all the components of a working system are installed: ConTeXt Minimals and SciTE for ConTeXt MKIV (only), ConTeXt Minimals, SciTE and Ruby for ConTeXt MKIV and MKII.
== Step 3: Configure ==
# In your ConTeXt files (default name of the main folder is <tt>contextminimal</tt>) locate <tt>scite-ctx.lua</tt>. Copy this file to your recently unzipped SciTE folder (by default called <tt>wscite</tt>).
# Again in your ConTeXt files, locate <tt>scite-ctx.properties</tt> and <tt>context.properties</tt>. Copy these files to your ''personal profile folder''; in XP that's usually <tt>C:\Documents and Settings\''yourusername''\</tt> (or the equivalent in your language), in Vista <tt>C:\Users\''yourusername''</tt>.
# Now open SciTE by double-clicking on the SciTE icon. You still need to tell it where to look for the ConTeXt related settings. For this, go to the ''Options'' menu and click on ''Open User Options File''. You should get a blank page. Now type into the file
<pre>
import scite-ctx
import context
</pre>
# Save the file and close SciTE.
