From 9dc8ce16a1efc6482db6f1d5456d42958e79a06c Mon Sep 17 00:00:00 2001 From: mitchell <70453897+667e-11@users.noreply.github.com> Date: Wed, 12 Sep 2012 11:24:11 -0400 Subject: Documentation overhaul. Rewrote most of the manual and Lua API to complement each other. Key bindings reference moved from Appendix to modules/textadept/keys.lua LuaDoc. --- doc/08_Themes.md | 91 -------------------------------------------------------- 1 file changed, 91 deletions(-) delete mode 100644 doc/08_Themes.md (limited to 'doc/08_Themes.md') diff --git a/doc/08_Themes.md b/doc/08_Themes.md deleted file mode 100644 index 5a171c82..00000000 --- a/doc/08_Themes.md +++ /dev/null @@ -1,91 +0,0 @@ -# Themes - -Textadept's look and feel can be 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 ncurses version. To change the -theme, create a `~/.textadept/theme` and/or `~/.textadept/theme_term` whose -first lines of text are the names of the themes you would like to use. - -![Light Theme](images/lighttheme.png) -   -![Dark Theme](images/darktheme.png) -   -![Term Theme](images/termtheme.png) - -Themes apply to all buffers. You cannot assign a theme to a particular file or -filetype. You can change things like tab and indent settings per filetype -however by creating a [language-specific module]. - -[language-specific module]: 7_Modules.html#Buffer.Properties - -## Creating or Modifying Themes - -Each theme is a single folder on the filesystem composed of three files: -`lexer.lua`, `buffer.lua`, and `view.lua`. It is recommended to put themes in -your `~/.textadept/themes/` directory so they will not be overwritten when you -update Textadept. 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. - -To use a theme not located in `~/.textadept/themes/` or Textadept's `themes/` -directory, you need to specify an absolute path to the theme's folder in your -`~/.textadept/theme` file. - -### Lexer - -Textadept uses lexers to assign names to buffer elements like comments, strings, -and keywords. These elements are assigned styles composed of font and color -information in the theme's `lexer.lua`. See the `Styling Tokens` section of the -[lexer][] page for more information on how to create styles and colors. - -[lexer]: api/lexer.html - -### Buffer - -`buffer.lua` contains buffer-specific properties like indentation size and -whether or not to use tabs. For example, to set the default tab size to 4 and -use tabs: - - buffer.tab_width = 4 - buffer.use_tabs = true - buffer.indent = 4 - -See the [LuaDoc][] for documentation on the properties. - -[LuaDoc]: api/buffer.html - -### View - -`view.lua` contains view-specific properties like caret and selection colors. -See the [LuaDoc][] for documentation on the properties. - -[LuaDoc]: api/buffer.html - -## Testing Themes - -You can reload or switch between themes on the fly using `Ctrl+Shift+T` (`⌘⇧T` -on Mac OSX | none in ncurses), but be aware that the Scintilla views do not -reset themselves, so any options set explicitly in the previous theme's -`view.lua` file that are not set explicitly in the new theme will carry over. -The switch feature is intended primarily for theme exploration and/or -development and can be slow when many buffers or views are open. - -Any errors that occur in the theme are printed to `io.stderr`. - -## Theming the GUI - -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: - - widget "textadept*GtkEntry*" style "textadept-entry-style" - -[GTK Resource files]: http://library.gnome.org/devel/gtk/stable/gtk-Resource-Files.html - -## 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. - -[wiki]: http://foicica.com/wiki/textadept -- cgit v1.2.3