900b6d7eb12c261413f85b8a287d8779bb179a69
[worg.git] / org-color-themes.org
1 #+OPTIONS:    H:3 num:nil toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
2 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
3 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
4 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
5 #+TITLE:      Org Color Themes
6 #+AUTHOR:     Worg people
7 #+EMAIL:      mdl AT imapmail DOT org
8 #+LANGUAGE:   en
9 #+PRIORITIES: A C B
10 #+CATEGORY:   worg
11
12 # This file is the default header for new Org files in Worg.  Feel free
13 # to tailor it to your needs.
14
15 #+MACRO: screenshot #+HTML: <br style="clear:both;"/><div class="figure"><p><img style="float:center;margin:20px 20px 20px 20px;" width="500px" src="$2"/></p><p><a href="http://repo.or.cz/w/Worg.git/blob_plain/HEAD:/color-themes/$1">$1</a></p></div>
16
17 [[file:index.org][{Back to Worg's index}]]
18
19 # Contributing Screenshots to this page.
20 #
21 # To make an addition to this page
22 # 1) place your screenshot in the /images/screenshots/ directory in the
23 #    base of the worg repository -- or not if you'd rather host the
24 #    image externally
25 # 2) place your color-theme-*.el file in the /color-themes/ file in the
26 #    base of the worg repository
27 # 3) add a macro call like those shown below passing the name of your
28 #    color theme and the link to your screen-shot respectively to the
29 #    =screenshot= macro
30
31 * Org Colour Themes
32
33 #+index: Themes
34
35 A popular way of customizing Emacs colours is to use the color-theme
36 package (see [[http://www.emacswiki.org/emacs/ColorTheme][color-theme emacswiki page]].)
37
38 Here is a list of color themes that are aware of Org:
39 You can see screen shots of these themes [[file:color-themes-screenshot.org][here]]. Once you have
40 installed a theme it is easy to tweak its appearance by editing the
41 theme's lisp file.
42
43 Some of these themes are available in Worg in the color-themes
44 directory, whilst others are linked either to the author's site, or to Github.
45
46 There is a page with screenshots of each of the themes [[file:color-themes-screenshot.org][here]] .
47
48 ** [[http://www.emacswiki.org/emacs/zenburn.el][color-theme-zenburn.el]] (maintained by Daniel Brockman)
49 ** [[http://jaderholm.com/color-themes/color-theme-colorful-obsolescence.el][color-theme-colorful-obsolescence.el]] (Scott Jaderholm)
50
51 Links to Scott's themes all point directly to his site.
52 ** [[http://jaderholm.com/color-themes/color-theme-wombat.el][color-theme-wombat.el]] (Scott Jaderholm)
53
54 ** [[http://jaderholm.com/color-themes/color-theme-active.el][color-theme-active.el]] (Scott Jaderholm)
55
56 ** [[https://github.com/fniessen/color-theme-leuven][color-theme-leuven.el]] (Fabrice Niessen)
57
58 ** [[file:color-themes/color-theme-zenburn.el][color-theme-zenburn.el]] (Daniel Brockman Adrian C., Bastien Guerry)
59
60 ** [[file:color-themes/color-theme-tangotango.el][color-theme-tangotango.el]] (Julien Barnier)
61 [[http://blog.nozav.org/post/2010/07/12/Updated-tangotango-emacs-color-theme][Link]] to Julien's blog post about tangotango. [[http://github.com/juba/color-theme-tangotango][Link]] to the Github repository.
62
63 ** [[file:color-themes/color-theme-folio.el][color-theme-folio.el]] color-theme-folio.el (David O'Toole)
64
65 ** [[file:color-themes/color-theme-manoj.el][color-theme-manoj.el]] (maintained by [[http://www.golden-gryphon.com/blog/manoj/blog/2008/05/26/Theming_Emacs/][Memnon]])
66
67 ** [[file:color-themes/color-theme-zenash.el][color-theme-zenash.el]] (maintained by Yavuz Arkun)
68 A modified version of zenburn. [[http://github.com/yarkun/zenash][Link]] to the Github repository.
69
70 ** [[http://github.com/suvayu/.emacs.d/blob/master/lisp/color-theme-dark-emacs.el][color-theme-dark-emacs.el]] (maintained by Suvayu Ali)
71 Based on theme made by the emacswiki user, ZWZ. The original theme can
72 be found [[http://www.emacswiki.org/emacs/zwz][here]]. Suvayu has also made some org-mode font modifications
73 outside of the colour theme, which can be obtained [[http://github.com/suvayu/.emacs.d/blob/master/lisp/org-mode-settings.el][here]]. Suvayu's
74 [[http://github.com/suvayu/.emacs.d/blob/master/init.el][init.el]] gives more information on how to use his customizations.
75
76 /NB:/ This theme is not maintained anymore, and won't work with the
77 trunk version of Emacs 24.1. Emacs 24.1 removes support for the
78 deprecated 3rd argument form for =face-spec-set=. This breaks the
79 =color-theme= package in general; so instead of waiting for it to be
80 fixed, ~dark-emacs~ is now available as an Emacs 24 custom theme. The
81 latest version can be found [[http://github.com/suvayu/.emacs.d/blob/master/themes/dark-emacs-theme.el][here]].
82
83 ** Installing Org Colour Themes.
84 First make sure that you have the Emacs color-theme package
85 installed. Copy the lisp files for the themes into a directory in your
86 Emacs load path.
87
88 If you want to be able to easily cycle between different
89 colour schemes, you need something like the following in your .emacs:
90
91 #+BEGIN_SRC emacs-lisp
92 (require 'color-theme)
93 (setq color-theme-is-global t)
94 (color-theme-initialize)
95
96 (load "color-theme-colorful-obsolescence")
97 (load "color-theme-zenburn")
98 (load "color-theme-tangotango")
99 (load "color-theme-railscast")
100 (load "color-theme-leuven")
101 (load "color-theme-folio")
102 (load "color-theme-zenash")
103 (load "color-theme-manoj")
104
105 (setq my-color-themes (list
106   'color-theme-tangotango
107   'color-theme-colorful-obsolescence 'color-theme-zenburn
108   'color-theme-leuven 'color-theme-folio 
109   'color-theme-manoj 'color-theme-zenash
110   'color-theme-railscast
111 ))
112
113 (defun my-theme-set-default () ; Set the first row
114       (interactive)
115       (setq theme-current my-color-themes)
116       (funcall (car theme-current)))
117      
118     (defun my-describe-theme () ; Show the current theme
119       (interactive)
120       (message "%s" (car theme-current)))
121      
122    ; Set the next theme (fixed by Chris Webber - tanks)
123     (defun my-theme-cycle ()            
124       (interactive)
125       (setq theme-current (cdr theme-current))
126       (if (null theme-current)
127       (setq theme-current my-color-themes))
128       (funcall (car theme-current))
129       (message "%S" (car theme-current)))
130     
131     (setq theme-current my-color-themes)
132     (setq color-theme-is-global nil) ; Initialization
133     (my-theme-set-default)
134     (global-set-key [f4] 'my-theme-cycle)
135   
136 #+END_SRC
137
138 Now you can cycle through the installed themes using the F4 key.
139