diff options
| author |   mitchell <70453897+667e-11@users.noreply.github.com> | 2011-11-23 06:25:48 -0500 |
|---|---|---|
| committer | mitchell <70453897+667e-11@users.noreply.github.com> | 2011-11-23 06:25:48 -0500 |
| commit | 10cd8e9477e9e3ead6c12110bcc9f67924f540cd (patch) | |
| tree | ce8045dc01c4261cc54164a9440ebccd6c06b0dd /doc/manual/8_Themes.md | |
| parent | 1859dff605a32d9e78a36c14239129579d9fc6e4 (diff) | |
| download | textadept-10cd8e9477e9e3ead6c12110bcc9f67924f540cd.tar.gz textadept-10cd8e9477e9e3ead6c12110bcc9f67924f540cd.zip | |
Added theme utilities, modified light and dark themes, and removed scite theme.
Added gui.set_theme() and gui.select_theme() theming utilities.
All new light and dark themes. Moved old classic themes to the wiki.
Diffstat (limited to 'doc/manual/8_Themes.md')
| -rw-r--r-- | doc/manual/8_Themes.md | 39 |
1 files changed, 26 insertions, 13 deletions
diff --git a/doc/manual/8_Themes.md b/doc/manual/8_Themes.md index 64a1624d..81ee285d 100644 --- a/doc/manual/8_Themes.md +++ b/doc/manual/8_Themes.md @@ -1,16 +1,13 @@ # Themes Textadept's look and feel can be customized with themes. The themes that come -with Textadept are `'light'`, `'dark'`, and `'scite'`. By default the `'light'` -theme is used. The `'scite'` theme is recommended for users accustomed to SciTE. -To change the theme, create a `~/.textadept/theme` file whose first line of text -is the name of the theme you would like to use. +with Textadept are `light` and `dark`'. By default the `light` theme is used. To +change the theme, create a `~/.textadept/theme` file whose first line of text is +the name of the theme you would like to use.   - - 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 @@ -55,14 +52,30 @@ See the [LuaDoc](../modules/buffer.html) for documentation on the properties. `view.lua` contains view-specific properties like caret and selection colors. See the [LuaDoc](../modules/buffer.html) for documentation on the properties. -## Theming Text Fields +## Testing Themes + +You can reload or switch between themes on the fly using `Ctrl+Shift+T` (⌘⇧T on +Mac OSX), 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`. -There is no way to theme text fields like the Find and Replace ones from within -Textadept. Instead, use [GTK Resource files][gtkrc]. The names of the text field -widgets are: +## Theming the GUI -* Find field: `textadept-find-entry`. -* Replace field: `textadept-replace-entry`. -* Command entry: `textadept-command-entry`. +There is no way to theme GUI controls like text fields and buttons from within +Textadept. Instead, use [GTK Resource files][gtkrc]. 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" [gtkrc]: http://library.gnome.org/devel/gtk/stable/gtk-Resource-Files.html + +## Getting Themes + +For now, user-created themes are obtained from the +[wiki](http://caladbolg.net/textadeptwiki). The classic `dark`, `light`, and +`scite` themes prior to version 4.3 have been moved there. |