diff options
Diffstat (limited to 'doc/09_Themes.md')
| -rw-r--r-- | doc/09_Themes.md | 36 |
1 files changed, 17 insertions, 19 deletions
diff --git a/doc/09_Themes.md b/doc/09_Themes.md index 73f4c612..7ea1eec6 100644 --- a/doc/09_Themes.md +++ b/doc/09_Themes.md @@ -1,8 +1,8 @@ # Themes -Textadept's look and feel is customized with themes. The themes that come with -Textadept are "light", "dark", and "term". By default the "light" theme is used -for the GUI version and "term" for the terminal version. +Themes customize Textadept's look and feel. The editor's built-in themes are +"light", "dark", and "term". The GUI version uses "light" as its default and the +terminal version uses "term". <span style="display: block; clear: right;"></span> @@ -12,11 +12,11 @@ for the GUI version and "term" for the terminal version.  -Each theme is a single Lua file. It is recommended to put custom or downloaded -themes in your *~/.textadept/themes/* directory so they will not be overwritten -when you update Textadept. Also, themes in that directory override any themes in +Each theme is a single Lua file. Putting custom or downloaded themes in your +*~/.textadept/themes/* directory prevents you from overwriting them when you +update Textadept. Also, themes in that directory override any themes in Textadept's *themes/* directory. This means that if you have your own *light* -theme, it will be loaded instead of the one that comes with Textadept. +theme, Textadept loads that one instead of its own. Themes contain color definitions and definitions for how to highlight (or "style") syntactic elements like comments, strings, and keywords in programming @@ -24,19 +24,17 @@ languages. These [definitions][] apply universally to all programming language elements, resulting in a single, unified theme. Themes also set view-related editor properties like caret and selection colors. -In the terminal version of Textadept, colors are determined by your terminal -emulator's settings. The only colors recognized by Textadept are the standard -black, red, green, yellow, blue, magenta, cyan, white, and bold variants of -those colors. How your terminal chooses to display these colors is up to your -terminal settings. However, you can still customize which colors are used for -particular styles. +Note: The only colors that the terminal version of Textadept recognizes are the +standard black, red, green, yellow, blue, magenta, cyan, white, and bold +variants of those colors. Your terminal emulator's settings determine how to +display these standard colors. [definitions]: api/lexer.html#Styles.and.Styling ## Switch Themes -You can switch between or reload themes using `Ctrl+Shift+T` (`⌘⇧T` on Mac OSX | -none in curses). You can set that theme to be the default one by putting +Switch between or reload themes using `Ctrl+Shift+T` (`⌘⇧T` on Mac OSX | none in +curses). Set that theme to be the default one by putting gui.set_theme('name') @@ -48,8 +46,8 @@ somewhere in your [*~/.textadept/init.lua*][]. There is no way to theme GUI controls like text fields and buttons from within Textadept. Instead, use [GTK+ Resource files][]. The "GtkWindow" name is -"textadept". For example, styling all text fields with a "textadept-entry-style" -would be done like this: +"textadept". For example, style all text fields with a "textadept-entry-style" +like this: widget "textadept*GtkEntry*" style "textadept-entry-style" @@ -57,7 +55,7 @@ would be done like this: ## Getting Themes -For now, user-created themes are obtained from the [wiki][]. The classic "dark", -"light", and "scite" themes prior to version 4.3 have been moved there. +For now, the [wiki][] hosts third-party, user-created themes. The classic +"dark", "light", and "scite" themes prior to version 4.3 are there too. [wiki]: http://foicica.com/wiki/textadept |