Difference between revisions of "User talk:Koenich"

From Wiki
Jump to navigation Jump to search
m
 
(91 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
Hi guys,
+
= Preamble =
  
−
since I am a student with little time, yet a passionate ConTeXt user, I'd love to contribute to ConTeXt's reputation on the wiki (and with a german beginner's guide document, which is private until finished).
+
Here is the place to get everything that is important to get started with ''ConTeXt'' on ''MS Windows'' operating system.
−
So I'd like to use this space here for my ideas on creation of wiki posts. This all is work in progress...
 
  
 +
Thanks to especially ''Donald Knuth'', ''Hans Hagen'', ''Taco Hoekwater'' and too many other coders and users to mention here!
  
 +
= Introduction =
  
−
== ConTeXt (beta 2017/02/19) with Textadept (9.3) ==
+
[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].
−
=Intstallation & ConTeXt Integration in Windows (as of 2017/03)=
 
  
−
* Install (i.e. download, extract and update) '''ConTeXt''' (mkiv)
+
= Setup ConTeXt =
−
** work in progress
 
−
* Add ConTeXt's executables folder to Windows PATH
 
−
** work in progress
 
−
* [https://foicica.com/textadept/download/textadept_LATEST.win32.zip Download] and extract [https://foicica.com/textadept/ '''Textadept'''] to a folder of your choice.
 
−
* Edit Textadept's ''init.lua''
 
−
** '''Note''' that there are two ''init.lua'' of certain importancy:
 
−
*** one is located in Textadept's program folder: don't edit this one, as you will lose your changes when you update Textadept
 
−
*** second is created by Textadept when you start it for the first time and it's located at '''SYSDRIVE:\users\USERNAME\.textadept\init.lua'''
 
−
* add the following line to the blank init.lua:
 
−
** textadept.run.compile_commands.tex = 'mtxrun --autogenerate --script context --autopdf --purge --synctex=-1 "%f"'
 
−
*** '''Note''' that it's only a single line, so you might need to re-format it when you copy and paste it from here into your document. Also '''note''' that your ''mtxrun.exe'' has to be in the Windows PATH (see above) in order to work, otherwise you have to add the full path to mtxrun. For example:
 
−
**** textadept.run.compile_commands.tex = 'C:/CTX/tex/texmf-win64/bin/mtxrun --autogenerate --script context --autopdf --purge --synctex=-1 "%f"'
 
−
***** '''Note''' that you have to use slash ( / ) instead of backslash ( \ ) in the file path, since Lua (same as ConTeXt) interprets a \ as the beginning of a command, while for Windows is doesn't make a change.
 
−
* restart Textadept and open or create a ConTeXt test document:
 
−
** \starttext hello world! \stoptext
 
−
* use Textadept's '''Tools''' -> '''Compile''' to build a PDF with the options added to the line
 
−
* That's it, you're done. 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 recommenden for this.
 
  
−
* further options that can be added to your '''user/init.lua
+
== Download & Install ConTeXt ==
−
** As of v9 (at least) Textadept seems to have an own ConTeXt lexer. So you can add the following lines to your ''init.lua'' to let Textadept choose it when you open a ''.tex'' document.
+
 
−
*** textadept.file_types.extensions.tex = 'context'
+
Installation and update of ConTeXt work the same way. If you only want to update ConTeXt, you can go to point 3.
−
**** if you plan to use ConTeXt mkiv alone, or use another ending to seperate ConTeXt from LaTeX documents, for example ''.ctx'':
+
 
−
*** textadept.file_types.extensions.ctx = 'context'
+
1. Download [http://standalone.contextgarden.net/setup/ ConTeXt].
 +
* [https://distribution.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip]
 +
 
 +
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 <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.
 +
 
 +
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 <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>_
 +
 
 +
== 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 <code>Right-click</code>ing 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 (<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"