aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authormitchell <70453897+667e-11@users.noreply.github.com>2011-11-23 06:25:48 -0500
committermitchell <70453897+667e-11@users.noreply.github.com>2011-11-23 06:25:48 -0500
commit10cd8e9477e9e3ead6c12110bcc9f67924f540cd (patch)
treece8045dc01c4261cc54164a9440ebccd6c06b0dd /doc/manual
parent1859dff605a32d9e78a36c14239129579d9fc6e4 (diff)
downloadtextadept-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')
-rw-r--r--doc/manual/14_Appendix.md1
-rw-r--r--doc/manual/8_Themes.md39
-rw-r--r--doc/manual/images/scitetheme.pngbin29966 -> 0 bytes
3 files changed, 27 insertions, 13 deletions
diff --git a/doc/manual/14_Appendix.md b/doc/manual/14_Appendix.md
index 61cd8a0d..5ca4b9c6 100644
--- a/doc/manual/14_Appendix.md
+++ b/doc/manual/14_Appendix.md
@@ -132,6 +132,7 @@ Ctrl+Alt+Shift+V |^⇧V |Toggle virtual space
Ctrl+= |⌘= |Zoom in
Ctrl+- |⌘- |Zoom out
Ctrl+0 |⌘0 |Reset zoom
+Ctrl+Shift+T |⌘⇧T |Select theme...
**Help** |||
F1 |F1 |Open manual
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.
![Light Theme](images/lighttheme.png)
&nbsp;&nbsp;&nbsp;&nbsp;
![Dark Theme](images/darktheme.png)
-&nbsp;&nbsp;&nbsp;&nbsp;
-![SciTE Theme](images/scitetheme.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
@@ -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.
diff --git a/doc/manual/images/scitetheme.png b/doc/manual/images/scitetheme.png
deleted file mode 100644
index 6161006b..00000000
--- a/doc/manual/images/scitetheme.png
+++ /dev/null
Binary files differ