comparison .emacs.d/color-theme-6.6.0/README @ 0:2764b4f45f9f

1st commit
author Shohei KOKUBO <e105744@ie.u-ryukyu.ac.jp>
date Mon, 21 Apr 2014 04:30:59 +0900
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:2764b4f45f9f
1 Sharing your current color setup:
2
3 Use `color-theme-submit'. If you have already invested time in
4 customizing Emacs faces, please consider sharing your current setup.
5 Make sure that color-theme.el is in your `load-path'. Type M-x
6 load-library RET color-theme RET to load all the functions. Type M-x
7 color-theme-submit RET and mail the result to the maintainer of this
8 package (see above for mail addres).
9
10 If you want to make sure that all your customization was exported,
11 type M-x list-faces-display RET to get a list of all faces currently
12 defined. This is the list of faces that `color-theme-print' uses.
13
14 Installing a color theme:
15
16 Make sure that color-theme.el is in your `load-path'. Type M-x
17 load-library RET color-theme RET to load all the functions.
18
19 The main function to call is color-theme-select. Type M-x
20 color-theme-select RET. That creates a Color Theme Selection
21 buffer. Press RET or `i' on a color theme to install it for the
22 rest of your session.
23
24 If you want to install the color theme as soon as Emacs is started
25 up, read the description of the theme you like and remember the
26 name of the color theme function. Press `d' on a color theme in
27 the Color Theme Selection buffer to read the description. Assuming
28 you like the Gnome2 theme, you'll find that the function to use is
29 called `color-theme-gnome2'. Add the following to the end of your
30 .emacs (removing the leading `;;').
31
32 (require 'color-theme)
33 (color-theme-gnome2)
34
35 Changing menu colors:
36
37 In Emacs 21 on X, you can set the menu colors and font using the
38 menu face. Example for your .emacs file:
39
40 (set-face-font 'menu "7x14")
41 (set-face-foreground 'menu "white").
42
43 If are using X, you can set the menu foreground and background using
44 a resource file, usually .Xdefaults or .Xresources. Usually
45 .Xdefaults is used when you start your session using a display
46 manager such as xdm or gdm. .Xresources is usually used when you
47 start X directly via a shell script such as startx. If you set
48 Emacs*Background and Emacs*Foreground in such a resource file, the
49 foreground and background of Emacs including the menu will be set.
50 If your .emacs then loads a color theme, the foreground and
51 background are changed -- with the exception of the menu. There is
52 no way to manipulate the menu foreground and background color from
53 elisp. You can also set more specific menu resources for Emacs in
54 the resource file. Here is a sample entry for your resource file:
55
56 Emacs*Background: DarkSlateGray
57 Emacs*Foreground: wheat
58
59 Creating your own color theme:
60
61 Use M-x customize-face and customize the faces. Make sure to "Set
62 for Current Session" -- you don't want to save these using custom!
63 When you are done, call M-x color-theme-print to produce the elisp
64 code required to recreate your theme. Better yet, use M-x
65 color-theme-submit to mail it to the maintainer. That way it will be
66 added to future versions of color-theme.el.
67
68 For more information on the elisp format of a color theme, start with
69 the documentation of `color-theme-install' using C-h f
70 color-theme-install.
71
72 When your color theme is just a variation of an existing color theme,
73 take a look at `color-theme-robin-hood' in order to see an example of
74 how to do it. Essentially you want to call all the parent color
75 themes before installing your changes. For all but the first parent
76 color theme, you need to make sure that `color-theme-is-cumulative'
77 is bound to t. If you don't do that, users that set
78 `color-theme-is-cumulative' to nil will only install your changes
79 without the parent color themes.
80
81 Making a color theme work for both Emacs and XEmacs:
82
83 Once you have printed the color-theme, you can make sure it looks
84 similar in both Emacs and XEmacs by running
85 `color-theme-analyze-defun' on the printed theme. This function
86 will check for missing faces for the other editor...