Changes

= How to ConTeXt with = Step 1: Install '''Textadept (MS Windows) ''' ==(updated 2017/03)

== Step 1.1. [https://foicica.com/textadept/download/textadept_LATEST.win32.zip Download] and extract [https: Install / Update /foicica.com/textadept/ '''ConTeXtTextadept''' ==] to a folder of your choice.

Installation and update of ConTeXt work 1.2. Use <code>textadept.exe</code> from the same way. If you only want extracted folder to update ConTeXt you can start directly from point 3Textadept.

1. [http://standalone.contextgarden.net/setup/ Download] ConTeXt.* Windows x86 / 32 bit users: [http://standalone.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip]* Windows x64 / 64 bit users: [http://standalone.contextgarden.net/setup/context-setup-win64.zip context-setup-win64.zip]** Download the x64 / 64 bit version only when you are really sure, that you '''need''' it. 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  3. Method 1: Write a batch file Since at this point the installation and update of ConTeXt work the same way, the most effective solution is to create a batch file. To do so * use Windows Explorer to navigate to your ConTeXt directory. In there should be a file called <code>first-setup.bat</code>.* Use Windows Notepad or <code>Right-click</code> -> '''New''' -> '''Textfile''' to create such.* If you only want ConTeXt mkiv (highly '''recommended'''), add the following line to the new and empty textfile: first-setup -engine=luatex -modules=all* Save the file as a '''batch'''-file and name it something like <code>update.bat</code>.** '''Note''' that the document ending has to be <code>.bat</code> not <code>.txt</code> or anything else. You might have to rename the file ending by hand.* Execute the batch file you just created 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.** ConTeXt's folder's size should be around 380 - 400 MB when everything worked fine.  3. Method 2: Type the command by hand * 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 like this:** 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 DOS commands you might need:** <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>_* If you only want ConTeXt mkiv (highly '''recommended'''), enter the following line and press <code>Enter</code>-key: first-setup -engine=luatex -modules=all* Wait until the download / update is complete. Afterwards you can close the command prompt by entering <code>exit</code> and pressing <code>Enter</code>-key or by simply closing the window. == Step 2: 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. In that case skip this step and go to Step 3 respectively Step 4.1 directly. 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, but to make sure, that the folder was added, you should restart your machine. Optional: 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 restart your machine, make sure that you added the correct location or re-try the operation by starting from Step 2.1. == Step 3: Install '''Textadept''' == 1. [https://foicica.com/textadept/download/textadept_LATEST.win32.zip Download] and extract [https://foicica.com/textadept/ '''Textadept'''] to a folder of your choice. 2. Use <code>textadept.exe</code> from the extracted folder to start Textadept. == Step 4: Tweak '''Textadept''''s settings ==

Usually you have to restart Textadept after changing its configuration files. Robert Gieseke created a code though, which you can add to your <code>init.lua</code> to circumvent having to restart Textadept, whenever a change is made:

Save <code>init.lua</code> and restart Textadept once. After doing so you can add changes to Textadept's configuration files and press <code>F9</code>-key afterwards to save and reload load the changes without having to restart Textadept.

=== Step 42.1: Bind a PDF build command into Textadept ===

2.1.1. Use Textadept to open your <code>init.lua</code> stored in <code>SYSDRIVE:\users\USER\.textadept\</code>.

2.1.2. Add an execute command for ConTeXt to Textadept's menu:* If your ConTeXt executables folder is already in the Windows search Path:

* If for some reason you can't add the folder to PATH, for example on public machines, 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'''Important''': you have that your ConTeXt executables folder has to start `first-setup.bat` from the main ConTeXt directory every time you restart a machine, on which ConTeXt is not be in the Windows search path (see Step 1.3), otherwise you will get ''file not found''-errors, when trying to compile a ConTeXt document.* '''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 it doesn't make any difference.!

2.1.3. Restart Textadept to reload the modified <code>init.lua</code>.

2.1.4. Open or create a ConTeXt test document:

2.1.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.

2.1.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.

=== Step 42.2: Lexing (command highlighting & code folding) ===

2.2.1. add the following line to your <code>USER/.textadept/init.lua</code> and save it afterwards:

* If you plan to use LaTeX and ConTeXt, you should might want to use different file extensionsfor each format. For example <code>*.tex</code> for LaTeX and <code>*.cxd</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:

2.2.2. Restart Textadept to reload <code>init.lua</code>.

2.2.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.

ui.set_theme('dark', {font = 'Monospace', fontsize = 10}) -- Textadept v9 buffer:set_theme('dark', {font = 'Monospace', fontsize = 10}) -- Textadept v10in which the expression '''dark''' is the filename of the theme located in either in <code>Textadept\themes</code> or you can download and add new themes to <code>USER\.textadept\themes</code>(after you created or downloaded and added them; create the folder if as itusually won's not t be there yet). * Many ''base16'' themes for Textadept can be found at [https://github.com/rgieseke/textadept-themes Robert Gieseke's GitHub]. You can preview them [https://termux.com/add-on-styling-color-preview.html here] (partially).

* Many === Snippets ===Snippets are predefined code or text blocks. Using snippets can save a lot of time as you won''base16'' themes for Textadept can be found at [https:t have to retype often used commands and text passages. You add snippets to your <code>USER/.textadept/githubinit.com/rgiesekelua</textadept-themes Robert Gieseke's GitHub]code>. You can preview them [httpsIn Textadept snippets look like this://chriskempson snippets.github.io/base16/ herecontext['TRIGGERKEYWORD'] (partially).= 'PASTEDTEXT'

=== Snippets ===Snippets are predefined code or text blocks. Using To get an idea how writing snippets (for ConTeXt) works, you can save a lot of time as you won't have to retype often used commands copy and text passages. You add snippets paste the following list to your <code>USER/.textadept/init.lua</code>. In Textadept they look like this:

snippets.context['emph'] = '{\\em %<selected_text>%0}'-- emphasized text/math snippets.context['ital'] = '{\\it %<selected_text>%0}' -- italic text/math snippets.context['bold'] = '{\\bf %<selected_text>%0}'-- bold text/math snippets.context['boldit'] = '{\\bi %<selected_text>%0}' -- bold italic text/math snippets.context['start'] = '\\start%1\n\t%0\n\\stop%1' snippets.context['itemize'] = '\\startitemize[packed]\n\t\\startitem\n\t\t%<selected_text>%0\n\t\\stopitem\n\\stopitemize'-- start itemization snippets.context['item'] = '\\startitem\n\t%<selected_text>%0\n\\stopitem'

snippets.context['chapter'] = '\\startchapter[title={%1},marking{%1}]\n\t%0\n\\stopchapter' snippets.context['section'] = '\\startsection[title={%1},marking{%1}]\n\t%0\n\\stopsection' snippets.context['ssection'] = '\\startsubsection[title={%1},marking{%1}]\n\t%0\n\\stopsubsection' snippets.context['title'] = '\\starttitle[title={%1},marking{%1}]\n\t%0\n\\stoptitle' snippets.context['subject'] = '\\startsubject[title={%1},marking{%1}]\n\t%0\n\\stopsubject' snippets.context['ssubject'] = '\\startsubsubject[title={%1},marking{%1}]\n\t%0\n\\stopsubsubject'

* '''Note''' that a backslash <code>\</code> is created set by typing a double backslash <code>\\</code>.

**<code>\n</code> set a line break (new line)**<code>\t</code> set a tabulated**<code>%0</code> creates a primary input set the ''closing'' caret (placeholder) (the cursor will jump here first'''last''')**<code>%1</code> creates set one or multiple secondary input carets(<code>%1</code>, <code>%2</code>, <code>%3</code> and so on; you can also use the same integer multiple times: e.g. <code>\\start%1 ... \\stop%1</code>)**<code>%n<selected_text></code> creates this is where highlighted text will be pasted when enclosing it with a new line**snippet (e.g. <code>{\\bi %t<selected_text>%0}</code> creates a tab)

* After adding snippets, you have to restart Textadept firstor reset Lua state as described in Step 2.

 * '''Note''' that since this way you added bound snippets.'''context''', i.e. to Textadept's ConTeXt lexer, Textadept's status bar in the lower right corner has to say '''context''', otherwise use a ConTeXt document or see Step 42.2.

A ConTeXt module for textadept Textadept is being developed at [https://github.com/stephengaito/ta-context-latex ta-context-latex].