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

From Wiki
Jump to navigation Jump to search
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{note | This is still work in progress}}
+
{{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.
+
This instruction was written 2019 April 13 and is intended to install ConTeXt standalone distribution (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).
 
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).
  
==Install ConTeXt==
+
==Chapter 1: Detect Windows 32 or 64 bit 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/ 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===
 
===Step 1: Download and unzip the installer===
Line 14: Line 18:
 
Open Command promt. Do this by using Cortana: Search for cmd.exe. Right click on the search result and select "run as admin".
 
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\
 
Command prompt should be in C:\Users\MyUserName\
Type in cd.. -> Enter -> cd.. -> Enter
+
 
Now you are at C:\
+
Type in "cd.." -> Enter
Type in cd context
+
 
 +
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
 
You are now at C:\context
  
 
Tpe in <tt>first-setup.bat</tt> -> Enter.
 
Tpe in <tt>first-setup.bat</tt> -> Enter.
  
This should print out much output and take a while (5 mins).
+
This should print out much output and take a while (maybe 5 mins).
 +
 
 
Check if there is a folder C:\context\tex
 
Check if there is a folder C:\context\tex
 +
 
If no such folder has been created, this step failed. (It failed for me using <tt>C:\Programme\context</tt> and I resolved it by using <tt>C:\context\</tt>
 
If no such folder has been created, this step failed. (It failed for me using <tt>C:\Programme\context</tt> and I resolved it by using <tt>C:\context\</tt>
  
Line 28: Line 40:
 
===Step 3: Add ConTeXt to Windows search path===
 
===Step 3: Add ConTeXt to Windows search path===
  
You will have to go to the system settings of your Windows and add you will have to add <tt>C:\context\tex\texmf-win64\bin</tt> (or <tt>C:\context\tex\texmf-mswin\bin</tt> for using <tt>context-setup-mswin.zip</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.
+
(Please also note [https://superuser.com/questions/284342/what-are-path-and-other-environment-variables-and-how-can-i-set-or-use-them])
 +
 
 +
You will have to go to the system settings of your Windows and add <tt>C:\context\tex\texmf-win64\bin</tt> (or <tt>C:\context\tex\texmf-mswin\bin</tt> for using <tt>context-setup-mswin.zip</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 "global variables".
  
 
Do this by:
 
Do this by:
Right click on "Dieser PC" or "this PC" and select "Eigenschaften/Settings".
+
Right click on "This Computer" and select "Settings".
Then on the left side, click on "erweiterte Systemeinstellungen/extended Settings".
+
Then on the left side, click on "change my environment variables" or something like "Extended Settings".
  
In the small popup "Systemeigenschaften/System settings" select the slider "Erweitert/extended".
+
In the small popup "System settings" select the slider "extended".
Select the button "Umgebungsvariablen/environment variables".
+
Select the button "Environment variables".
  
 
Select PATH, lick on button "edit" and ad a new row with <tt>C:\context\tex\texmf-win64\bin</tt> (or <tt>C:\context\tex\texmf-mswin\bin</tt> for using <tt>context-setup-mswin.zip</tt>)
 
Select PATH, lick on button "edit" and ad a new row with <tt>C:\context\tex\texmf-win64\bin</tt> (or <tt>C:\context\tex\texmf-mswin\bin</tt> for using <tt>context-setup-mswin.zip</tt>)
Line 48: Line 62:
 
This step is an alternative to run setuptex.bat which is located in C:\context\tex\
 
This step is an alternative to run setuptex.bat which is located in C:\context\tex\
  
 +
==Chapter 3: Test ConTeXt==
  
==Install SciTe==
+
Now you are ready to test ConTeXt. Start a simple text editor (like 'editor', Notepad++, NOT MS WORD)
  
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.)
+
<pre>
 +
\starttext
  
===Step 1: Get SciTe===
+
Hello, world!
  
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".)
+
\stoptext
 +
</pre>
  
 +
Save the document as <tt>C:\context\helloworld.tex</tt>.
  
===Step 2: Fetch and install lexer add-in===
+
Open command prompt and go to c:\context (as we did at 'Install ConTeXt' - Step 2)
 +
type in
 +
<pre>
 +
context helloworld.tex
 +
</pre>
  
See also https://foicica.com/scintillua/manual.html
+
Open the file explorer and browse to <tt>C:\context\</tt>.
 +
Check if there is a helloworld.pdf. Open it to check its content.
  
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).
+
And that's it, basically. If you got your pdf and love to write using this editor, you can continue this way.
 +
Still I'd recommend using TeXworks.
  
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.
+
==Chapter 4: Install TeXworks==
Move the 'lexers' directory to the root of your SciTE installation.
 
  
Also leave the SciTe program folder open. You'll need it next!
+
Now you have ConTeXt. To complement it, i.e. to easily write and compile ConTeXt files, install the TeXworks editor.
  
==Adjust SciTe to work with ConTeXt==
+
===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.
  
=== Copy setup files ===
+
During installation, I recommend to register (only) ".tex" files to the application. Disable the other ones.
  
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.
+
==Step 2: Ready, steady, test!==
 +
Start TeXWorks.
  
=== Import settings into SciTe ===
+
In the dropdown, select "ConTeXt (LuaTex)"
  
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
+
Now you are ready to go.
 +
 
 +
Type in:
  
 
<pre>
 
<pre>
import lexers/lpeg
+
\starttext
import scite-context-user
+
 
 +
Hello, world!
 +
 
 +
\stoptext
 
</pre>
 
</pre>
  
and save the file.
+
Save the document as <tt>helloworld.tex</tt>.
  
Close/restart SciTe.
+
Now click on the green button to build your file.
  
==Ready, steady, test!==
+
After there are some lines of compiler output, a pdf file should open and you should see your "hello world".
  
Now you are ready to go. Start SciTE and open a ConTeXt document (if you have any) or try with a simple "Hello world":
+
=Other ConTeXt distributions=
 +
{{note | This part needs to be checked if it is still up-to-date in 2019 }}
  
<pre>
+
As a Windows user, you can choose between the following installation alternatives:
\starttext
 
  
Hello, world!
+
* ConTeXt standalone distribution
  
\stoptext
+
* MikTeX
</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.
+
* Texlive
  
[[File:helloworld.png|600px]]
+
* W32TeX
  
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:
+
=Literature=
 +
[http://meeting.contextgarden.net/2008/talks/2008-08-21-willi-aditya-beginners/Tutorial-text.pdf Aditya Mahajan, Willi Egger: Beginners Tutorial ConTeXt. (PDF; 371 kB) 20. August 2008]
  
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.
+
[http://pmrb.free.fr/contextref.pdf Hans Hagen, Taco Hoekwater: ConTeXt Reference Manual. (PDF; 2,04 MB) 27. September 2013]

Revision as of 07:10, 26 April 2019


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 standalone distribution (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 32 or 64 bit 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.

And that's it, basically. If you got your pdf and love to write using this editor, you can continue this way. Still I'd recommend using TeXworks.


Chapter 4: Install TeXworks

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.

Step 2: 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".

Other ConTeXt distributions


NOTE: This part needs to be checked if it is still up-to-date in 2019

As a Windows user, you can choose between the following installation alternatives:

  • ConTeXt standalone distribution
  • MikTeX
  • Texlive
  • W32TeX


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