Changes

=3rd party projectsConTeXt with Textadept (MS Windows) =(updated 2017/12)

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

Note though, that if you plan to use 1.1. [https://foicica.com/textadept/download/textadept_LATEST.win32.zip Download] and extract [https://foicica.com/textadept/ '''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. It's almost more comfortable ''] to create own ConTeXt snippets with the ease a folder of Textadept (see below)your choice.

= How 1.2. Use <code>textadept.exe</code> from the extracted folder to ConTeXt with start Textadept =MS Windows machines; updated 2017/03.

== Step 12: Install Tweak '''ConTeXtTextadept''' 's settings ==

work '''Note''' that almost all changes to Textadept are saved in progressthe file <code>init.lua</code>. There is two of them, of which you should edit only one:

== Step 2* One of them is in the extracted Textadept main folder. It is '''not recommended''' to edit this file as your changes will be lost when you update Textadept. Instead: Add ConTeXt's executables * When you start Textadept for the first time, a new folder to Windows search PATH == <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 3 -- Save and reset Lua state: Install `F9` keys['f9'] = function() -- Mac OSX users might prefer: keys[OSX and 'Textadeptmf9'or 'f9' ==] io.save_file() reset() end

1Save <code>init. [https:lua<//foicica.com/textadept/download/textadept_LATEST.win32.zip Download] code> and extract [https://foicicarestart Textadept once.com/textadept/ '''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 a folder of your choicerestart Textadept.

=== Step 2. Use <code>textadept.exe</code> from the extracted folder to start '''1: Bind a 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 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:

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

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). * 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 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>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>%tinit.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=

* After adding snippets, you have to restart A ConTeXt module for Textadept firstis being developed at [https://github.com/stephengaito/ta-context-latex ta-context-latex].

* Then Note though, that if you can plan to use <code>Alt + K</code> Textadept 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, when a ctags), so that it's almost more comfortable to create own ConTeXt document is opened in snippets with the active tabease of Textadept (see above).