README.themes 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. THE FORMAT OF THEME FILES
  2. -------------------------
  3. A theme is a collection of attributes of various UI elements. Each
  4. theme is contained in a file with a "thm" extension.
  5. Each line of a theme file, unless blank or preceded with "#" (which
  6. makes it a comment), is of the syntax:
  7. element_name = [fg_color | special] [, bg_color | special] [, special]
  8. "color" may be any of:
  9. black gray
  10. red brightred
  11. green brightgreen
  12. brown yellow
  13. blue brightblue
  14. magenta brighmagenta
  15. cyan brightcyan
  16. lightgray white
  17. (Because of terminal restrictions, those in the second column cannot
  18. serve as background colors).
  19. "special" may be any of
  20. bold +bold
  21. underline +underline
  22. reverse +reverse
  23. normal
  24. default
  25. "default" stands for the default color of the terminal. This can be
  26. either the foreground or the background color, depending on where it's
  27. used.
  28. There are tens of elements, but thanks to an inheritance mechanism it's
  29. only necessary to specify few of them. Those elements not specified in a
  30. theme file inherit their attributes from a predetermined "parent"
  31. element. This inheritance also takes place when only a background (or a
  32. foreground) color is missing.
  33. The following is a list of the available UI elements and their descriptions.
  34. The indentations show the hierarchical structure of the inheritance.
  35. menu pull-down menu color
  36. menu.frame menu frames
  37. menu.selected selected menu item
  38. menu.letter item hot key
  39. menu.letter.selected (bg: menu.selected) item hot key, when selected
  40. menu.indicator menu indicators
  41. menu.indicator.selected (bg: menu.selected) menu indicators, selected
  42. menubar menubar
  43. scrollbar.thumb the thumb of the scrollbar
  44. statusline the status-line
  45. edit the main edit box
  46. dialogline the dialog-line
  47. scrollbar the scrollbar
  48. edit.failed-conversion characters not represented
  49. in screen encoding.
  50. edit.control control characters
  51. (usually U+0000 to U+0031)
  52. edit.eop end of paragraph symbol
  53. edit.unicode-ls Unicode line separator
  54. edit.tab tab characters
  55. edit.explicit-bidi explicit bidi marks
  56. edit.maqaf Hebrew maqaf, when highlighted
  57. edit.nsm non spacing marks (NSM)
  58. edit.nsm.hebrew Hebrew NSM (niqqud)
  59. edit.nsm.cantillation cantillation marks
  60. edit.nsm.arabic Arabic NSM (harakat)
  61. edit.wide wide Asian characters
  62. edit.trim the trim symbol ("$")
  63. edit.wrap the wrap symbol ("\")
  64. edit.selected selected text
  65. edit.html-tag highlighted HTML tags
  66. edit.emphasized highlighted *text* and _text_
  67. edit.links links in the User Manual
  68. edit.email-quote1 email quotes, level 1
  69. edit.email-quote2 email quotes, level 2
  70. edit.email-quote3 email quotes, level 3
  71. ... ...
  72. edit.email-quote9 email quotes, level 9