Changes

=3rd party projectsConTeXt with Textadept (MS Windows) =(updated 2017/12) == Step 1: Install '''Textadept''' ==

A ConTeXt module for 1.1. [https://foicica.com/textadept is being developed at /download/textadept_LATEST.win32.zip Download] and extract [https://githubfoicica.com/stephengaitotextadept/ta-context-latex ta-context-latex'''Textadept''']to a folder of your choice.

Note though, that if you plan to use Textadept without LaTeX with ConTeXt mkiv only (recommended), then you might not need 1.2. Use <code>textadept.exe</code> from the package mentioned above as it comes with literally only a hand full of ConTeXt snippets. It's almost more comfortable extracted folder to create own ConTeXt snippets with the ease of start Textadept (see below).

= How to ConTeXt with = Step 2: Tweak '''Textadept (updated 2017/03) ''''s settings ==

== Step 1: Install '''ConTeXtNote''' ==that almost all changes to Textadept are saved in the file <code>init.lua</code>. There is two of them, of which you should edit only one:

work * One of them is in progressthe extracted Textadept main 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 a file called <code>init.lua</code>. This is 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.

== Step 2Usually 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: Add ConTeXt's executables folder to Windows search PATH ==

== Step 3: Install ''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 load the changes without having to restart Textadept''' ==.

# [https://foicica.com/textadept/download/textadept_LATEST.win32=== Step 2.zip Download] and extract [https1://foicica.com/textadept/ '''Textadept'''] to Bind a folder of your choice.# Use <code>textadept.exe</code> from the extracted folder to start '''PDF build command into Textadept'''.===

== Step 42.1.1. Use Textadept to open your <code>init.lua</code> stored in <code>SYSDRIVE: Tweak '''Textadept''''s settings ==\users\USER\.textadept\</code>.

2.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 is doesn't make a difference! 2.1.3. Restart Textadept to reload the modified <code>init.lua</code>.

2.1.4. Open or create a ConTeXt test document: \starttext hello world! \stoptext5. Use Textadept's '''Tools''' -> '''Compile''' * You will have to build a PDF with save the options added to <code>init.lua</code>. A message buffer file with compilation status an appropriate ending first, after that it will open in a seperate tabbe recognized as ConTeXt format file automatically.

62. When you have a popular PDF reader installed already, it should pop up at the end of the process and show the created PDF output1. [https://www5.sumatrapdfreader.org/freeUse Textadept's '''Tools''' -pdf-reader.html > '''Sumatra PDFCompile'''] is highly recommended for thisto build a PDF with the options added to <code>init.lua</code>. A message buffer with compilation status will open in a seperate tab.

== 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) ===

Textadept comes with an own ConTeXt lexer. A lexer is a file that defines command highlightingand code folding keywords. So it's Textadept comes with a good idea ConTeXt lexer. In order to be able to bind <code>*.tex</code> use command highlighting and/or <code>*.ctx</code> files folding when writing ConTeXt documents, you have to bind 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>*.ctxcxd</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 cxd = 'context'** When linking files within ConTeXt documents without adding an extension though, ConTeXt will expect those files to have the ending <code>*.tex</code>, i.e. you will have to work with filenames and extensions when using a format other than <code>*.tex</code>, which on the other hand should not be seen as a disadvantage. 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.

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 ==

* You can change the theme, font and font size of Textadept with the following line

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, again, 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 start here: 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 is created as you would type it in ConTeXt: typing a double backslash <code>\\</code> prints is set by typing a single 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 or a single input set the ''closing'' caret(placeholder) (the cursor will jump here '''last''')**<code>%1</code> creates a secondary set one or multiple input caretcarets (<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 linesnippet (e.g. <code>{\\bi %<selected_text>%0}</code>) * After adding snippets, you have to restart Textadept or reset Lua state as described in Step 2. * You can paste snippets into ConTeXt documents** either by typing the keyword that you defined within <code>snippets.context['KEYWORD']</code> and pressing <code>Tab</code>-key afterwards**or by using <code>%tCtrl + 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> creates , they will show up sorted alphabetically.* '''Note''' that since this way you bound snippets to Textadept's ConTeXt lexer, Textadept's status bar in the lower right corner has to say '''context''', otherwise use a tabConTeXt document or see Step 2.2. * Read more about snippets in Textadept's [https://foicica.com/textadept/api.html#textadept.snippets manual]. =3rd party projects= A ConTeXt module for Textadept is being developed at [https://github.com/stephengaito/ta-context-latex ta-context-latex].

* After you added snippetsNote though, that if you have plan to restart use Textadept first.* Then you can use <code>Alt + K</code> without LaTeX with ConTeXt mkiv only (by default on Windows machinesrecommended) to choose from , then you might not need the list package mentioned above as it comes with literally only a hand full of ConTeXt snippets. It also needs additional software to be installed (Textredux, ctags), when a so that it's almost more comfortable to create own ConTeXt documents is opensnippets with the ease of Textadept (see above).