Changes

Jump to navigation Jump to search
m
{{Installation navbox}}
''Note. Valid as of September 2009. All instructions tested on newly installed Windows Vista mid-October 2009 and it worked. Without Ruby.''
This page gives instructions on how to easily install ConTeXt Minimals Standalone 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 Standalone is the a hassle-free alternative* '''SciTE''' Editor: Go The easiest way is to Scintillaget Troy Simpson's [http://http://wwwopensource.scintillaebswift.orgcom/SciTEDownload.html SciTE Download Page] and get [http:SciTEInstaller//prdownloads.sourceforge.net/scintilla/wscite201.zip?download full downloadWindows installer for SciTe] 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!''* ('''Acrobat Reader''' or other PDF viewer: if you don't have Adobe Acrobat Reader or any other pdf viewer on your computer, download the [http://www.adobe.com/products/acrobat/readstep2.html Acrobat Reader installer], too)
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 Standalone Installer is so small itself.
Now {{note| As of June 2011, The GUI installer still seems to be broken (at least in 64-bit Windows7), so you may have all to [[ConTeXt_Standalone#Command_line_method| install the files standalone from the command line]]. In that case you need will have to add <tt>C:\''yourcontextfolder''\tex\texmf-mswin\bin</tt> to successfully setup ConTeXt on your Windows computer. But do not drop the network connection yet! You will need internet search path (remember to get reboot the rest of computer after this, before you attempt to use your ConTeXt while installing, which is why the Minimals Installer is so small itselfwith SciTE).}}
 == Step 2: Install ConTeXt and SciTE ==
* Start ConTeXt installation by double-clicking on the downloaded installer .exe file.
* 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 Standalone and SciTE for ConTeXt MKIV (only), ConTeXt MinimalsStandalone, SciTE and Ruby for ConTeXt MKIV and MKII. 
== Step 3: Configure for full cooperation ==
# 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 SciTe program folder (by if you used the Windows installer, the default called <tt>wscite</tt>location is under Program Files).# 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 and Windows7 <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
</pre>
Remember to save the file to save these settings. Then close SciTE.
 
== Step 4: Using ConTeXt ==
Open SciTE. Open a ConTeXt document (if you have any) or try with a simple "Hello world":
<pre>
\starttext
== Additional configuration ==Hello, world!
=== Using fixed-width font in SciTE ===\stoptext</pre>
The default font in SciTE is a variableIf you feel courageous, first switch encoding via the File menu to UTF-width sansserif 8 (Arial or similar). If if you prefer haven't forced your SciTE to use a fixed-width font while codingdo it) and do it in Finnish (just cut and paste from below, the minimal distribution comes with a neat Latin Modern font for this purpose. You can find the font at if your keyboard doesn''\yourcontextmainfolder''\texmf-context\fonts\truetype\hoekwater\lm\lmtypewriter10-regular.ttft do diacritics):
The only thing you need to do is to install the font as you'd install any TrueType font in your Windows. If you SciTE is otherwise correctly setup (i.e. step 3 is done), it'll automatically start using the new font. <pre>\starttext
Päivää, maailma!
=== Forcing SciTE to use UTF-8 as default encoding ===\stoptext</pre>
If Or, if you plan to use SciTE only for ConTeXt or if all your files are in UTF-8 anywayreally adventurous, first make sure you can make are using UTF-8 as , then try to paste the following Russian text into your default encoding. Especially if SciTE (cut-and-paste may give you start "from scratch", a few challenges so this is recommended!may or may not work):
To change the encoding setting, open SciTE and go to ''Options'' and there to ''Open Global Properties''. Find ''Internationalisation'' in the settings file:<pre># Internationalisation# Japanese input code page 932 and ShiftJIS character set 128#code.page=932#character.set=128# Unicode#code.page=65001code.page=0#character.set=204</pre>\starttext
Now '''uncomment <tt>#code.page=65001</tt>''' (i.e. remove the hash sign) and '''comment <tt>code.page=0</tt>''' (i.e. add a hash in front of the line. Now your internationalisation settings should look like this:привет мир<pre># Internationalisation# Japanese input code page 932 and ShiftJIS character set 128#code.page=932#character.set=128# Unicodecode.page=65001#code.page=0#character.set=204\stoptext
</pre>
  Now save you have a simple ConTeXt document. Save it (file type/extension is <tt>tex</tt>), then press Ctrl+1 (or go to ''Tools'' and then ''Process TeX file''), sit back and watch. If everything was done right, first you'll have a lot of text on the settings fileright side of your SciTE screen, close itthen an empty pdf reader opens, then close SciTEit takes a bit more time and finally you end up with a one-page pdf that has a page number on top and the text a bit below. When If you restart SciTEtried Russian and only get the page number, UTFyou have a font problem -8 should be backtrack a bit and try English or Finnish first... Now you are ready to dive into the world of ConTeXt! '''For tips on how to configure SciTe to suit your ConTeXting needs, see the default encoding[[Scite#Configuring_SciTe_with_ConTeXt_on_Windows| Scite page]].''' {{Installation navbox}}

Navigation menu