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 work nearly 1.2. Use <code>textadept.exe</code> from the same. If you only want extracted folder to update ConTeXt you can start directly from point 3Textadept.

1. [http== Step 2://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 Tweak '''Textadept'need''' it.s settings ==

2'''Note''' that almost all changes to Textadept are saved in the file <code>init.lua</code>. Extract the archive to a location There is two of your choice.* You might want to change the name them, of the extracted directory to a shorter which you should edit only one as it will be the final location for ConTeXt.:

3* One of them is in the extracted Textadept main folder. Start It is '''not recommended''' to edit this file as your Windows command promptchanges will be lost when you update Textadept.Instead:* Use can When you start it by using Textadept for the key shortcut first time, a new folder <code>Windows-Key + RSYSDRIVE:\users\USERNAME\.textadept</code>, entering gets created. It also contains a file called <code>cmdinit.lua</code> . This is the file and pressing <code>ENTER</code>-keylocation where you should save all your Textadept settings.* Alternatively This way you can make a copy and use <code>Start</code> -> <code>Programs</code> -> <code>Accessories</code> -> <code>Command Pompt</code>it on several computers. When you open it for the first time it should be empty.

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

Method 1: Write a batch file:* Since at this point the installation -- Save and update of ConTeXt work the same, you should create a batch file. To do soreset Lua state:`F9`** 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' keys['f9' ] = function() --> '''Textfile''' to create such.** Write or paste the following line into the batch fileMac OSX users might prefer: first-setup -engine=luatex -modules=all** Save the batch file keys[OSX and name it something like <code>update.bat</code>.*** 'mf9'or 'Note''f9' that the document ending has to be <code>.bat</code> not <code>.txt</code> or anything else.]** Execute the batch file you just created by double-clicking on it. A Windows command prompt should pop up io.save_file()***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. reset()** Wait for the download / update to finish. After it is done, the command window should disappear by itself. The whole ConTeXt folder's size should be around 380 - 400 MB when everything worked fine. end

Method 2: Type the command by hand:* Another method of installing or updating ConTeXt is the following:** Use Windows Explorer to navigate to your ConTeXt directory.** Click in the upper white field the current location is displayed.** Enter Save <code>cmdinit.lua</code> and restart Textadept once. After doing so you can add changes to Textadept's configuration files and press <code>EnterF9</code>-key.** Now Windows command prompt should pop up with the correct location.* Otherwise do it the old fashioned way; by typing. Some DOS commands you might need:** <code>X:</code> change afterwards to drive X:** <code>dir</code> list the content of save and load the current directory** <code>cd DIRECTORY</code> change changes without having to directory with name DIRECTORY** <code>cd.restart Textadept.</code> change to superior directory** <code>cd\</code> change to root drive* Now your command prompt should look like this: X:\ConTeXt>_

5=== Step 2. Enter the following line1:* If you only want ConTeXt mkiv (highly '''recommended'''): first-setup -engineBind a PDF build command into Textadept ==luatex -modules=all

62. Wait until the download is complete1.1. Use Textadept to open your <code>init.lua</code> stored in <code>SYSDRIVE:\users\USER\.textadept\</code>.

== Step 2: Add ConTeXt's executables folder to Windows search PATH == work in progress == 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 == 1. Use your freshly installed Textadept to open Textadept's main configuration file called <code>init.lua</code>.* 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:* 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:

* 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 your ConTeXt executables folder has to use slash <code>/</code> instead of backslash <code>\</code> be in the file Windows search 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. 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.

== Optional2.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: Additional //www.sumatrapdfreader.org/free-pdf-reader.html '''TextadeptSumatra PDF''' tweaks ==] is highly recommended for this.

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

A lexer is a file that defines command highlightingand code folding keywords. Since Textadept comes with an own a ConTeXt lexer. In order to be able to use command highlighting and code folding when writing ConTeXt documents, it is a good idea you have to bind <code>*.tex</code> files those documents to Textadept's ConTeXt the lexer. To do so:

2.2.1. Add add the following lines 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. Restart 2.3. Open a ConTeXt document and check Textadept to reload <code>init's status bar in the lower right corner. It should say '''context'''.lua</code>If it says '''latex''' make sure it really is a ConTeXt file or repeat the procedure.

3. Open a ConTeXt document and check Textadept== Optional: Additional 's status bar in the lower right corner. It should say '''context'''. If it says '''latexTextadept''' make sure it really is a ConTeXt file or repeat the procedure.tweaks ==

in 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). * There are more settings which you can look up in Textadept's [https://foicica.com/textadept/manual.html#Themes online manual].

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

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.

* Then You can paste snippets into ConTeXt documents** either by typing the keyword that you can use defined within <code>snippets.context['KEYWORD']</code> and pressing <code>Tab</code>-key afterwards** or by using <code>Alt Ctrl + K</code> (by default on Windows machines) to choose from the list of snippets. No matter in which order you add them to your <code>init.lua</code>, they will show up sorted alphabetically.* '''Note''' that since this way you bound snippets to Textadept's ConTeXt lexer, when Textadept's status bar in the lower right corner has to say '''context''', otherwise use a ConTeXt document is opened in the active tabor see Step 2.2.

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

Note though, that if you plan to use Textadept without LaTeX with ConTeXt mkiv only (recommended), then you might not need the package mentioned above as it comes with literally only a hand full of ConTeXt snippets. Italso needs additional software to be installed (Textredux, ctags), so that it's almost more comfortable to create own ConTeXt snippets with the ease of Textadept (see above).