github.com/aretext/aretext@v1.3.0/docs/config-reference.md (about) 1 Configuration Reference 2 ======================= 3 4 This document lists every configuration option in aretext. 5 6 | Attribute | Type | Description | 7 |-----------------|------------------|---------------------------------------------------------------------------------------------------------------------------------------------| 8 | syntaxLanguage | enum | Language used for syntax highlighting. Must be a valid [syntax language](#syntax-languages). | 9 | tabSize | integer | Maximum number of cells occupied by a tab. Must be greater than zero. | 10 | tabExpand | boolean | If true, replace inserted tabs with the equivalent number of spaces. | 11 | showTabs | boolean | If true, display tabs in the document. | 12 | showSpaces | boolean | If true, display spaces in the document. | 13 | autoIndent | boolean | If true, indent new lines to match indentation of the previous line. | 14 | showLineNumbers | boolean | If true, display line numbers. | 15 | lineNumberMode | enum | Control how line numbers are displayed. Either "absolute" or "relative" to the cursor. | 16 | lineWrap | enum | Control soft line wrapping behavior. Either "character" for breaking at any character boundary or "word" to break only at word boundaries. | 17 | menuCommands | array of objects | Additional menu items that can run arbitrary shell commands. See [Menu Command Object](#menu-command-object) below for the expected fields. | 18 | hideDirectories | array of strings | Glob patterns matching directories to hide from file search. Patterns are matched against the absolute path to the directory. | 19 | styles | dict | Styles control how UI elements are displayed. See [Styles](#styles) below for details. | 20 21 Syntax Languages 22 ---------------- 23 24 | Value | Description | 25 |--------------|------------------------------------------------------------------------------------------| 26 | bash | [bash](https://www.gnu.org/software/bash/manual/bash.html) | 27 | c | [C](http://www.gnu.org/software/gnu-c-manual/gnu-c-manual.html) | 28 | criticmarkup | [CriticMarkup](https://github.com/CriticMarkup/CriticMarkup-toolkit) | 29 | gitcommit | Format for editing a git commit | 30 | gitrebase | Format for git interactive rebase | 31 | go | [Go](https://golang.org/ref/spec) | 32 | gotemplate | [Go template](https://pkg.go.dev/text/template) | 33 | json | [JSON](https://www.json.org/json-en.html) | 34 | makefile | [Makefile](https://www.gnu.org/software/make/manual/make.html) | 35 | markdown | [Markdown](https://commonmark.org/) | 36 | p4 | [p4](https://p4.org) | 37 | plaintext | Do not apply any syntax highlighting. | 38 | protobuf | [Protocol Buffers Version 3](https://developers.google.com/protocol-buffers/docs/proto3) | 39 | python | [Python](https://docs.python.org/3/reference/) | 40 | rust | [Rust](https://doc.rust-lang.org/stable/reference/) | 41 | todotxt | [todo.txt](https://github.com/todotxt/todo.txt) | 42 | xml | [xml](https://www.w3.org/TR/2006/REC-xml11-20060816/) | 43 | yaml | [YAML](https://yaml.org/spec/) | 44 45 Menu Command Object 46 ------------------- 47 48 | Attribute | Type | Description | 49 |-----------|--------|----------------------------------------------------------------------------------------------------------------------------------| 50 | name | string | Displayed name of the menu item. | 51 | shellCmd | string | Shell command to execute when the menu item is selected. | 52 | mode | enum | Either "silent", "terminal", "insert", or "fileLocations". See [Custom Menu Commands](custom-menu-commands.md) for more details. | 53 | save | bool | If true, attempt to save the document before executing the command. | 54 55 Styles 56 ------ 57 58 The `styles` configuration is an object with keys: 59 60 - `lineNum`: the line numbers displayed in the left margin of the document. 61 - `tokenOperator`: an operator token recognized by the syntax language. 62 - `tokenKeyword`: a keyword token recognized by the syntax language. 63 - `tokenNumber`: a number token recognized by the syntax language. 64 - `tokenString`: a string token recognized by the syntax language. 65 - `tokenComment`: a comment token recognized by the syntax language. 66 - `tokenCustom1` through `tokenCustom16`: language-specific tokens recognized by the syntax language. 67 68 Each style object supports the following (optional) attributes: 69 70 | Attribute | Type | Description | 71 |-----------------|--------|------------------------------| 72 | color | string | Foreground (text) color. | 73 | backgroundColor | string | Background color. | 74 | bold | bool | Set bold attribute. | 75 | italic | bool | Set italic attribute. | 76 | underline | bool | Set underline attribute. | 77 | strikethrough | bool | Set strikethrough attribute. | 78 79 Colors can be either [a W3C color keyword](https://www.w3.org/wiki/CSS/Properties/color/keywords) or a hexadecimal RGB code. For example, both `red` and `#ff0000` represent the color red. 80 81 When using named colors, the terminal emulator may override the displayed color. For example, the [solarized dark theme in Alacritty](https://github.com/eendroroy/alacritty-theme/blob/06c3920d35dbbe3de35183b0512f9406041d681b/themes/solarized_dark.yaml) overrides the color `red` to a specific hex code. If you want to ignore the terminal emulator palette, specify colors using hexadecimal RGB codes instead of named colors. 82 83 Not all terminal emulators support every style attribute (bold, italic, etc.). If styles are displayed incorrectly, try changing the value of the `$TERM` environment variable. If you are using tmux, try [`set -g default-terminal "tmux"`](https://github.com/tmux/tmux/wiki/FAQ#i-dont-see-italics-or-italics-and-reverse-are-the-wrong-way-round).