Difference between revisions of "User talk:Koenich"

From Wiki
Jump to navigation Jump to search
(more and more complete)
 
(86 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
All of my wiki.contextgarden.net work in progress
+
= Preamble =
  
−
= ConTeXt mkiv with Textadept v9.3 (updated 2017/03) =
+
Here is the place to get everything that is important to get started with ''ConTeXt'' on ''MS Windows'' operating system.
  
−
== Step 1: Install '''ConTeXt''' ==
+
Thanks to especially ''Donald Knuth'', ''Hans Hagen'', ''Taco Hoekwater'' and too many other coders and users to mention here!
  
−
work in progress
+
= Introduction =
  
−
== Step 2: Add ConTeXt's executables folder to Windows search PATH ==
+
[http://wiki.contextgarden.net ConTeXt] (pronounced '''ConTehht''' as derived from Dutch) is a [http://en.wikipedia.org/wiki/TeX TeX] macro package created and maintained by [http://www.pragma-ade.com Pragma ADE].
  
−
work in progress
+
= Setup ConTeXt =
  
−
== Step 3: Install '''Textadept''' ==
+
== Download & Install ConTeXt ==
  
−
# [https://foicica.com/textadept/download/textadept_LATEST.win32.zip Download] and extract [https://foicica.com/textadept/ '''Textadept'''] to a folder of your choice.
+
Installation and update of ConTeXt work the same way. If you only want to update ConTeXt, you can go to point 3.
−
# Use <code>textadept.exe</code> from the extracted folder to start '''Textadept'''.
 
  
−
== Step 4: Tweak '''Textadept''''s settings ==
+
1. Download [http://standalone.contextgarden.net/setup/ ConTeXt].
 +
* [https://distribution.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip]
  
−
1. Use your freshly installed Textadept to open Textadept's main configuration file called <code>init.lua</code>.
+
2. Extract the archive to a location of your choice.
−
* After extraction of the downloaded Textadept archive there is a file called <code>init.lua</code> in the main program folder. It is '''not recommended''' to edit this file as your changes will be lost when you update Textadept. Instead:
+
* You might want to change the name of the extracted directory to a shorter one as it will be the final location for ConTeXt.
−
* When you start Textadept for the first time a new folder  <code>SYSDRIVE:\users\USERNAME\.textadept</code> gets created. It also contains the file called <code>init.lua</code>. It's the file and location where you should save all your Textadept settings. This way you can make a copy and use it on several computers. When you open it for the first time it should be empty.
 
−
2. Add an execute command for ConTeXt to Textadept's menu:
 
−
* If your ConTeXt executables folder is already in the Windows search PATH:
 
−
  textadept.run.compile_commands.tex = 'mtxrun --autogenerate --script context --autopdf --purge --synctex=-1 "%f"'
 
−
* If for some reason you can't add the folder to PATH you have to add the full path to your ConTeXt executables. For example:
 
−
  textadept.run.compile_commands.tex = 'C:/ctx/tex/texmf-mswin/bin/mtxrun --autogenerate --script context --autopdf --purge --synctex=-1 "%f"'
 
−
* '''Note''' that you have to use slash <code>/</code> instead of backslash <code>\</code> in the file path, since Lua (same as ConTeXt) interprets a <code>\</code> as the beginning of a command, while for Windows is doesn't make a difference.
 
−
3. Restart Textadept to reload the modified <code>init.lua</code>.
 
  
−
4. Open or create a ConTeXt test document:
+
3. Install / Update ConTeXt
−
  \starttext hello world! \stoptext
 
−
5. Use Textadept's '''Tools''' -> '''Compile''' to build a PDF with the options added to <code>init.lua</code>. A message buffer with compilation status will open in a seperate tab.
 
  
−
6. When you have a popular PDF reader installed already, it should pop up at the end of the process and show the created PDF output. [https://www.sumatrapdfreader.org/free-pdf-reader.html '''Sumatra PDF'''] is highly recommended for this.
+
* Use Windows Explorer to navigate to your ConTeXt directory. In there should be a file called <code>install.bat</code>.
 +
* Execute by double-clicking on it. A command prompt window should pop up.
 +
** If it appears for only a few seconds, chances are high that the download server is down. In that case you might want to re-try the procedure at some other time.
 +
* Wait for the download / update to finish. After it is done, the command window should disappear by itself.
  
−
== Optional: Additional '''Textadept''' tweaks ==
+
Alternatively, from the command prompt:
  
−
=== Lexing ===
+
* Use Windows Explorer to navigate to your ConTeXt directory.
 +
** Click into the upper white field where the current location is displayed.
 +
** Enter <code>cmd</code> and press <code>Enter</code>-key.
 +
** Now Windows command prompt should pop up with the correct location.
 +
* Otherwise, you can start your Windows command prompt
 +
** by using the key shortcut <code>Windows-key + R</code>, entering <code>cmd</code> and pressing <code>Enter</code>-key.
 +
** Alternatively, you can use <code>Start</code> -> <code>Programs</code> -> <code>Accessories</code> -> <code>Command Pompt</code>.
 +
* Some important ''MS DOS'' commands:
 +
** <code>dir</code> list the content of the current directory
 +
** <code>cd DIRECTORY</code> change to directory with name DIRECTORY
 +
** <code>cd..</code> change to superior directory
 +
** <code>cd\</code> change to drive root
 +
** <code>X:</code> change to drive X:
 +
** also possible: <code>cd directory\subdirectory\subsubdir...</code>
 +
* In the end your command prompt should look like this:
 +
  X:\ConTeXt>_
  
−
Textadept comes with an own ConTeXt lexer. A lexer is a file that defines command highlighting. So it's a good idea to bind <code>*.tex</code> and/or <code>*.ctx</code> files to Textadept's ConTeXt lexer. To do so:
+
== Add ConTeXt's executables folder to Windows search Path ==
−
1. Add the following lines to your <code>USER/.textadept/init.lua</code>:
 
−
  textadept.file_types.extensions.tex = 'context'
 
−
* If you plan to use LaTeX and ConTeXt, you should use different file extensions. For example <code>*.tex</code> for LaTeX and <code>*.ctx</code> for ConTeXt documents. In that case you only have to bind your new ConTeXt extension to Textadept's ConTeXt lexer, since <code>.tex</code> files are automatically recognized as LaTeX documents:
 
−
  textadept.file_types.extensions.ctx = 'context'
 
−
2. Restart Textadept to reload <code>init.lua</code>
 
  
−
3. Open a ConTeXt document and check Textadept's status bar in the lower right corner. It should say '''context'''. If it says '''latex''' make sure it really is a ConTeXt file or repeat the procedure.
+
'''Note''': you will need admin rights for this. On public machines for example you most probably won't be able to add ConTeXt to that machine's path.
  
−
=== Themes & editor font changes ===
+
1. Open Windows' '''System''' dialog
−
* You can change the theme, font and font size of Textadept with the following line
+
* either by <code>Right-click</code>ing on '''This PC''' / '''My Computer''' on your Desktop and then clicking on '''Properties'''
−
  ui.set_theme('dark', {font = 'Monospace', fontsize = 10})
+
* or by clicking '''Start''' -> '''Settings''' -> '''About''' -> '''System Info'''
−
in which the expression '''dark''' is the filename of the theme located either in Textadept\themes or you can download and add new themes to USER\.textadept\themes
+
* or on older Windows Machines by going to '''Control Panel''' -> '''System'''.
−
(create the folder if it's not there yet).
+
 
−
There are more settings which you can look up in Textadept's [https://foicica.com/textadept/manual.html#Themes online manual].
+
2. Click on '''Advanced System Settings''' ("System Properties").
 +
 
 +
3. Click on '''Advanced'''-Tab.
 +
 
 +
4. Click on '''Environment Variables...'''.
 +
 
 +
5. Choose where to add ConTeXt's executables folder to:
 +
*Either to '''User variables for USER''' for the current user only
 +
*or to '''System variables''' for all users.
 +
 
 +
6. Double-click on the respective variable called ''Path''.
 +
 
 +
7. Add your ConTeXt executables to Windows path.
 +
* '''Note''' that the position, to where you add the location is sorted by importancy. The most important directories will be searched first. This might be taken into account when using ConTeXt together with MiKTeX for example. It's safest to place ConTeXt's path at the very beginning.
 +
* In '''User''' Path variable you might need to add the location and seperate it from the existing ones by using a semikolon (<code>;</code>).
 +
* In '''System''' Path variable you probably only have to add a new line.
 +
 
 +
The location should look like this:
 +
 
 +
* Win x86 / 32 bit:
 +
  X:\ConTeXt\tex\texmf-mswin\bin
 +
* Win x64 / 64 bit:
 +
  X:\ConTeXt\tex\texmf-win64\bin
 +
 
 +
8. Save your changes. Usually no restart or re-login is needed after this operation.
 +
 
 +
Opt 1. You can test whether it worked by starting your Command prompt and entering the following line, while being in a directory other than the one you just added.
 +
 
 +
  context -version
 +
 
 +
* A message with ConTeXt's version number should apear.
 +
* If a message like '''context' is not recognized as an internal or external command...'' appears, you should make sure that you added the correct location of ConTeXt's executables (context.exe) path to Windows' search path.
 +
 
 +
= Text Editors =
 +
== ''CudaText'' ==
 +
See my article here [[CudaText]].

Latest revision as of 06:52, 10 September 2023

Preamble

Here is the place to get everything that is important to get started with ConTeXt on MS Windows operating system.

Thanks to especially Donald Knuth, Hans Hagen, Taco Hoekwater and too many other coders and users to mention here!

Introduction

ConTeXt (pronounced ConTehht as derived from Dutch) is a TeX macro package created and maintained by Pragma ADE.

Setup ConTeXt

Download & Install ConTeXt

Installation and update of ConTeXt work the same way. If you only want to update ConTeXt, you can go to point 3.

1. Download ConTeXt.

2. Extract the archive to a location of your choice.

  • You might want to change the name of the extracted directory to a shorter one as it will be the final location for ConTeXt.

3. Install / Update ConTeXt

  • Use Windows Explorer to navigate to your ConTeXt directory. In there should be a file called install.bat.
  • Execute by double-clicking on it. A command prompt window should pop up.
    • If it appears for only a few seconds, chances are high that the download server is down. In that case you might want to re-try the procedure at some other time.
  • Wait for the download / update to finish. After it is done, the command window should disappear by itself.

Alternatively, from the command prompt:

  • Use Windows Explorer to navigate to your ConTeXt directory.
    • Click into the upper white field where the current location is displayed.
    • Enter cmd and press Enter-key.
    • Now Windows command prompt should pop up with the correct location.
  • Otherwise, you can start your Windows command prompt
    • by using the key shortcut Windows-key + R, entering cmd and pressing Enter-key.
    • Alternatively, you can use Start -> Programs -> Accessories -> Command Pompt.
  • Some important MS DOS commands:
    • dir list the content of the current directory
    • cd DIRECTORY change to directory with name DIRECTORY
    • cd.. change to superior directory
    • cd\ change to drive root
    • X: change to drive X:
    • also possible: cd directory\subdirectory\subsubdir...
  • In the end your command prompt should look like this:
 X:\ConTeXt>_

Add ConTeXt's executables folder to Windows search Path

Note: you will need admin rights for this. On public machines for example you most probably won't be able to add ConTeXt to that machine's path.

1. Open Windows' System dialog

  • either by Right-clicking on This PC / My Computer on your Desktop and then clicking on Properties
  • or by clicking Start -> Settings -> About -> System Info
  • or on older Windows Machines by going to Control Panel -> System.

2. Click on Advanced System Settings ("System Properties").

3. Click on Advanced-Tab.

4. Click on Environment Variables....

5. Choose where to add ConTeXt's executables folder to:

  • Either to User variables for USER for the current user only
  • or to System variables for all users.

6. Double-click on the respective variable called Path.

7. Add your ConTeXt executables to Windows path.

  • Note that the position, to where you add the location is sorted by importancy. The most important directories will be searched first. This might be taken into account when using ConTeXt together with MiKTeX for example. It's safest to place ConTeXt's path at the very beginning.
  • In User Path variable you might need to add the location and seperate it from the existing ones by using a semikolon (;).
  • In System Path variable you probably only have to add a new line.

The location should look like this:

  • Win x86 / 32 bit:
 X:\ConTeXt\tex\texmf-mswin\bin
  • Win x64 / 64 bit:
 X:\ConTeXt\tex\texmf-win64\bin

8. Save your changes. Usually no restart or re-login is needed after this operation.

Opt 1. You can test whether it worked by starting your Command prompt and entering the following line, while being in a directory other than the one you just added. 

 context -version
  • A message with ConTeXt's version number should apear.
  • If a message like 'context' is not recognized as an internal or external command... appears, you should make sure that you added the correct location of ConTeXt's executables (context.exe) path to Windows' search path.

Text Editors

CudaText

See my article here CudaText.

Retrieved from "https://wiki.contextgarden.net/index.php?title=User_talk:Koenich&oldid=34024"