Difference between revisions of "Windows 10 64 bit Installation 2019"

From ConTeXt wiki
Line 88: Line 88:
 
==Chapter 4: Install SciTe==
 
==Chapter 4: 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.)
+
Now you have ConTeXt. To complement it, i.e. to easily write and compile ConTeXt files, install the TeXworks editor.
  
===Step 1: Get SciTe===
+
===Step 1: Get TeXworks===
 +
Browse to [http://www.tug.org/texworks/ http://www.tug.org/texworks/]
 +
and download the exe file and execute it to install TeXworks.
  
There's a SciTe included in your ConTeXt Suite, but you'll get less hassle with user rights and such if you use [https://www.ebswift.com/scite-text-editor-installer.html Windows installer for SciTe]. Keep accepting everything it suggests and you'll get a very standard Windows program installed without any hassle. I recommend not using the 'context menu' during setup (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".)
+
During installation, I recommend to register (only) ".tex" files to the application. Disable the other ones.
  
 +
==Ready, steady, test!==
 +
Start TeXWorks.
  
===Step 2: Fetch and install lexer add-in===
+
In the dropdown, select "ConTeXt (LuaTex)"
 
 
See also https://foicica.com/scintillua/manual.html
 
 
 
The up-to-date ConTeXt version uses ''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>scintillua375-1</tt>). Insite the temp folder, look for a folder called 'lexers'.
 
 
 
Locate your SciTE installation, typically C:\Program Files\SciTE\ for Windows for Linux.
 
Move the 'lexers' directory to the root of your SciTE installation.
 
 
 
Also leave the SciTe program folder open. You'll need it next!
 
 
 
==Chapter 5: Adjust SciTe to work with ConTeXt==
 
 
 
=== Copy setup files ===
 
 
 
Go to <tt>C:\context\tex\tex\texmf-context\context\data\scite\context\lexers</tt>. Copy everything from this folder to your SciTe program lexers 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 ===
+
Now you are ready to go.
  
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
+
Type in:
 
 
<pre>
 
import lexers/lpeg
 
import scite-context-user
 
</pre>
 
 
 
and save the 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>
 
<pre>
Line 139: Line 113:
 
</pre>
 
</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.  
+
Save the document as <tt>helloworld.tex</tt>.
 
 
[[File:helloworld.png|600px]]
 
 
 
Now press F4 or menu/tools/build to build your file.
 
I get the error message:
 
<pre>
 
>texexec --pdf Test.tex
 
>Exit code: 1
 
</pre>
 
I expected to read:
 
<pre>
 
>context --pdf Test.tex
 
</pre>
 
  
Anyway. Other manuals write this, maybe it works for you:
+
Now click on the green button to build your file.
  
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.
+
After there are some lines of compiler output, a pdf file should open and you should see your "hello world".
  
 
==Literature==
 
==Literature==

Revision as of 18:50, 19 April 2019


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

This instruction was written 2019 April 13 and is intended to install Context (Mark IV). My intent is to deliver a up-to-date manual that every noob can use, and not to refer to old versions (e.g. from 2011).

Chapter 1: Detect Windows Version

At fist, get to know if I’m Running 32-bit or 64-bit Windows. Please follow https://www.howtogeek.com/howto/21726/how-do-i-know-if-im-running-32-bit-or-64-bit-windows-answers/ or other tutorials.

Chapter 2: Install ConTeXt

Step 1: Download and unzip the installer

For a 32 bit installation, download context-setup-mswin.zip onto your computer. For a 64 bit installation, download context-setup-win64.zip onto your computer. It contains a folder called context, unzip/extract that folder to C:\, so the result is C:\context\.


Step 2: Use installer to get the ConTeXt Suite

Open Command promt. Do this by using Cortana: Search for cmd.exe. Right click on the search result and select "run as admin". Command prompt should be in C:\Users\MyUserName\

Type in "cd.." -> Enter

Once again type in "cd.." -> Enter

Now you should be at path "C:\". If not, repeat "cd.."

Type in "cd context"

You are now at C:\context

Tpe in first-setup.bat -> Enter.

This should print out much output and take a while (maybe 5 mins).

Check if there is a folder C:\context\tex

If no such folder has been created, this step failed. (It failed for me using C:\Programme\context and I resolved it by using C:\context\


Step 3: Add ConTeXt to Windows search path

(Please also note [1])

You will have to go to the system settings of your Windows and add C:\context\tex\texmf-win64\bin (or C:\context\tex\texmf-mswin\bin for using context-setup-mswin.zip) to the search path (environment variable path 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 "global variables".

Do this by: Right click on "This Computer" and select "Settings". Then on the left side, click on "change my environment variables" or something like "Extended Settings".

In the small popup "System settings" select the slider "extended". Select the button "Environment variables".

Select PATH, lick on button "edit" and ad a new row with C:\context\tex\texmf-win64\bin (or C:\context\tex\texmf-mswin\bin for using context-setup-mswin.zip)


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 C:\context\tex\texmf-win64\bin (or C:\context\tex\texmf-mswin\bin for using context-setup-mswin.zip) , your computer knows where to find ConTeXt.

This step is an alternative to run setuptex.bat which is located in C:\context\tex\

Chapter 3: Test ConTeXt

Now you are ready to test ConTeXt. Start a simple text editor (like 'editor', Notepad++, NOT MS WORD)

\starttext

Hello, world!

\stoptext

Save the document as C:\context\helloworld.tex.

Open command prompt and go to c:\context (as we did at 'Install ConTeXt' - Step 2) type in

context helloworld.tex

Open the file explorer and browse to C:\context\. Check if there is a helloworld.pdf. Open it to check its content.


Chapter 4: Install SciTe

Now you have ConTeXt. To complement it, i.e. to easily write and compile ConTeXt files, install the TeXworks editor.

Step 1: Get TeXworks

Browse to http://www.tug.org/texworks/ and download the exe file and execute it to install TeXworks.

During installation, I recommend to register (only) ".tex" files to the application. Disable the other ones.

Ready, steady, test!

Start TeXWorks.

In the dropdown, select "ConTeXt (LuaTex)"

Now you are ready to go.

Type in:

\starttext

Hello, world!

\stoptext

Save the document as helloworld.tex.

Now click on the green button to build your file.

After there are some lines of compiler output, a pdf file should open and you should see your "hello world".

Literature

Aditya Mahajan, Willi Egger: Beginners Tutorial ConTeXt. (PDF; 371 kB) 20. August 2008

Hans Hagen, Taco Hoekwater: ConTeXt Reference Manual. (PDF; 2,04 MB) 27. September 2013