lisp/org-faces.el

   1 ;;; org-faces.el --- Face definitions for Org-mode.
   2
   3 ;; Copyright (C) 2004-2012 Free Software Foundation, Inc.
   4
   5 ;; Author: Carsten Dominik <carsten at orgmode dot org>
   6 ;; Keywords: outlines, hypermedia, calendar, wp
   7 ;; Homepage: http://orgmode.org
   8 ;;
   9 ;; This file is part of GNU Emacs.
  10 ;;
  11 ;; GNU Emacs is free software: you can redistribute it and/or modify
  12 ;; it under the terms of the GNU General Public License as published by
  13 ;; the Free Software Foundation, either version 3 of the License, or
  14 ;; (at your option) any later version.
  15
  16 ;; GNU Emacs is distributed in the hope that it will be useful,
  17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 ;; GNU General Public License for more details.
  20
  21 ;; You should have received a copy of the GNU General Public License
  22 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  23 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  24 ;;
  25 ;;; Commentary:
  26
  27 ;; This file contains the face definitions for Org.
  28
  29 ;;; Code:
  30
  31 (require 'org-macs)
  32 (require 'org-compat)
  33
  34 (defun org-copy-face (old-face new-face docstring &rest attributes)
  35   (unless (facep new-face)
  36     (if (fboundp 'set-face-attribute)
  37         (progn
  38           (make-face new-face)
  39           (set-face-attribute new-face nil :inherit old-face)
  40           (apply 'set-face-attribute new-face nil attributes)
  41           (set-face-doc-string new-face docstring))
  42       (copy-face old-face new-face)
  43       (if (fboundp 'set-face-doc-string)
  44           (set-face-doc-string new-face docstring)))))
  45 (put 'org-copy-face 'lisp-indent-function 2)
  46
  47 (defgroup org-faces nil
  48   "Faces in Org-mode."
  49   :tag "Org Faces"
  50   :group 'org-appearance)
  51
  52 (defface org-default
  53   (org-compatible-face 'default nil)
  54   "Face used for default text."
  55   :group 'org-faces)
  56
  57 (defface org-hide
  58   '((((background light)) (:foreground "white"))
  59     (((background dark)) (:foreground "black")))
  60   "Face used to hide leading stars in headlines.
  61 The foreground color of this face should be equal to the background
  62 color of the frame."
  63   :group 'org-faces)
  64
  65 (defface org-level-1 ;; originally copied from font-lock-function-name-face
  66   (org-compatible-face 'outline-1
  67     '((((class color) (min-colors 88) (background light)) (:foreground "Blue1"))
  68       (((class color) (min-colors 88) (background dark)) (:foreground "LightSkyBlue"))
  69       (((class color) (min-colors 16) (background light)) (:foreground "Blue"))
  70       (((class color) (min-colors 16) (background dark)) (:foreground "LightSkyBlue"))
  71       (((class color) (min-colors 8)) (:foreground "blue" :bold t))
  72       (t (:bold t))))
  73   "Face used for level 1 headlines."
  74   :group 'org-faces)
  75
  76 (defface org-level-2 ;; originally copied from font-lock-variable-name-face
  77   (org-compatible-face 'outline-2
  78     '((((class color) (min-colors 16) (background light)) (:foreground "DarkGoldenrod"))
  79       (((class color) (min-colors 16) (background dark))  (:foreground "LightGoldenrod"))
  80       (((class color) (min-colors 8)  (background light)) (:foreground "yellow"))
  81       (((class color) (min-colors 8)  (background dark))  (:foreground "yellow" :bold t))
  82       (t (:bold t))))
  83   "Face used for level 2 headlines."
  84   :group 'org-faces)
  85
  86 (defface org-level-3 ;; originally copied from font-lock-keyword-face
  87   (org-compatible-face 'outline-3
  88     '((((class color) (min-colors 88) (background light)) (:foreground "Purple"))
  89       (((class color) (min-colors 88) (background dark))  (:foreground "Cyan1"))
  90       (((class color) (min-colors 16) (background light)) (:foreground "Purple"))
  91       (((class color) (min-colors 16) (background dark))  (:foreground "Cyan"))
  92       (((class color) (min-colors 8)  (background light)) (:foreground "purple" :bold t))
  93       (((class color) (min-colors 8)  (background dark))  (:foreground "cyan" :bold t))
  94       (t (:bold t))))
  95   "Face used for level 3 headlines."
  96   :group 'org-faces)
  97
  98 (defface org-level-4   ;; originally copied from font-lock-comment-face
  99   (org-compatible-face 'outline-4
 100     '((((class color) (min-colors 88) (background light)) (:foreground "Firebrick"))
 101       (((class color) (min-colors 88) (background dark))  (:foreground "chocolate1"))
 102       (((class color) (min-colors 16) (background light)) (:foreground "red"))
 103       (((class color) (min-colors 16) (background dark))  (:foreground "red1"))
 104       (((class color) (min-colors 8) (background light))  (:foreground "red" :bold t))
 105       (((class color) (min-colors 8) (background dark))   (:foreground "red" :bold t))
 106       (t (:bold t))))
 107   "Face used for level 4 headlines."
 108   :group 'org-faces)
 109
 110 (defface org-level-5 ;; originally copied from font-lock-type-face
 111   (org-compatible-face 'outline-5
 112     '((((class color) (min-colors 16) (background light)) (:foreground "ForestGreen"))
 113       (((class color) (min-colors 16) (background dark)) (:foreground "PaleGreen"))
 114       (((class color) (min-colors 8)) (:foreground "green"))))
 115   "Face used for level 5 headlines."
 116   :group 'org-faces)
 117
 118 (defface org-level-6 ;; originally copied from font-lock-constant-face
 119   (org-compatible-face 'outline-6
 120     '((((class color) (min-colors 16) (background light)) (:foreground "CadetBlue"))
 121       (((class color) (min-colors 16) (background dark)) (:foreground "Aquamarine"))
 122       (((class color) (min-colors 8)) (:foreground "magenta"))))
 123   "Face used for level 6 headlines."
 124   :group 'org-faces)
 125
 126 (defface org-level-7 ;; originally copied from font-lock-builtin-face
 127   (org-compatible-face 'outline-7
 128     '((((class color) (min-colors 16) (background light)) (:foreground "Orchid"))
 129       (((class color) (min-colors 16) (background dark)) (:foreground "LightSteelBlue"))
 130       (((class color) (min-colors 8)) (:foreground "blue"))))
 131   "Face used for level 7 headlines."
 132   :group 'org-faces)
 133
 134 (defface org-level-8 ;; originally copied from font-lock-string-face
 135   (org-compatible-face 'outline-8
 136     '((((class color) (min-colors 16) (background light)) (:foreground "RosyBrown"))
 137       (((class color) (min-colors 16) (background dark)) (:foreground "LightSalmon"))
 138       (((class color) (min-colors 8)) (:foreground "green"))))
 139   "Face used for level 8 headlines."
 140   :group 'org-faces)
 141
 142 (defface org-special-keyword ;; originally copied from font-lock-string-face
 143   (org-compatible-face 'font-lock-keyword-face
 144     '((((class color) (min-colors 16) (background light)) (:foreground "RosyBrown"))
 145       (((class color) (min-colors 16) (background dark)) (:foreground "LightSalmon"))
 146       (t (:italic t))))
 147   "Face used for special keywords."
 148   :group 'org-faces)
 149
 150 (defface org-drawer ;; originally copied from font-lock-function-name-face
 151   (org-compatible-face nil
 152     '((((class color) (min-colors 88) (background light)) (:foreground "Blue1"))
 153       (((class color) (min-colors 88) (background dark)) (:foreground "LightSkyBlue"))
 154       (((class color) (min-colors 16) (background light)) (:foreground "Blue"))
 155       (((class color) (min-colors 16) (background dark)) (:foreground "LightSkyBlue"))
 156       (((class color) (min-colors 8)) (:foreground "blue" :bold t))
 157       (t (:bold t))))
 158   "Face used for drawers."
 159   :group 'org-faces)
 160
 161 (defface org-property-value nil
 162   "Face used for the value of a property."
 163   :group 'org-faces)
 164
 165 (defface org-column
 166   (org-compatible-face nil
 167     '((((class color) (min-colors 16) (background light))
 168        (:background "grey90" :weight normal :slant normal :strike-through nil
 169                     :underline nil))
 170       (((class color) (min-colors 16) (background dark))
 171        (:background "grey30" :weight normal :slant normal :strike-through nil
 172                     :underline nil))
 173       (((class color) (min-colors 8))
 174        (:background "cyan" :foreground "black"
 175                     :weight normal :slant normal :strike-through nil
 176                     :underline nil))
 177       (t (:inverse-video t))))
 178   "Face for column display of entry properties.
 179 This is actually only part of the face definition for the text in column view.
 180 The following faces apply, with this priority.
 181
 182 1. The color of the reference face.  This is normally the level fact that
 183    is used in the outline.  In agenda-mode, it will be the face of the
 184    first character in the line.  The color is explicitly retained to
 185    make sure that the column line still looks a bit like the structure
 186    line it is masking.
 187
 188 2. The `org-column' face.
 189
 190 3. The remaining properties of the reference face.
 191
 192 Since column view works by putting overlays with a display property
 193 over individual characters in the buffer, the face of the underlining
 194 character (this might for example be the a TODO keyword) might still
 195 shine through in some properties.  So when your column view looks
 196 funny, with \"random\" colors, weight, strike-through, try to explicitly
 197 set the properties in the `org-column' face.  For example, set
 198 :underline to nil, or the :slant to `normal'.
 199
 200 Under XEmacs, the rules are simpler, because the XEmacs version of
 201 column view defines special faces for each outline level.  See the file
 202 `org-colview-xemacs.el' for details."
 203   :group 'org-faces)
 204
 205 (defface org-column-title
 206   (org-compatible-face nil
 207     '((((class color) (min-colors 16) (background light))
 208        (:background "grey90" :underline t :weight bold))
 209       (((class color) (min-colors 16) (background dark))
 210        (:background "grey30" :underline t :weight bold))
 211       (((class color) (min-colors 8))
 212        (:background "cyan" :foreground "black" :underline t :weight bold))
 213       (t (:inverse-video t))))
 214   "Face for column display of entry properties."
 215   :group 'org-faces)
 216
 217 (when (fboundp 'set-face-attribute)
 218   ;; Make sure that a fixed-width face is used when we have a column table.
 219   (set-face-attribute 'org-column nil
 220                       :height (face-attribute 'default :height)
 221                       :family (face-attribute 'default :family)))
 222
 223 (defface org-agenda-column-dateline
 224   (org-compatible-face 'org-column
 225     '((t nil)))
 226   "Face used in agenda column view for datelines with summaries."
 227   :group 'org-faces)
 228
 229 (defface org-warning
 230   (org-compatible-face 'font-lock-warning-face
 231     '((((class color) (min-colors 16) (background light)) (:foreground "Red1" :bold t))
 232       (((class color) (min-colors 16) (background dark))  (:foreground "Pink" :bold t))
 233       (((class color) (min-colors 8)  (background light)) (:foreground "red"  :bold t))
 234       (((class color) (min-colors 8)  (background dark))  (:foreground "red"  :bold t))
 235       (t (:bold t))))
 236   "Face for deadlines and TODO keywords."
 237   :group 'org-faces)
 238
 239 (defface org-archived    ; similar to shadow
 240   (org-compatible-face 'shadow
 241     '((((class color grayscale) (min-colors 88) (background light))
 242        (:foreground "grey50"))
 243       (((class color grayscale) (min-colors 88) (background dark))
 244        (:foreground "grey70"))
 245       (((class color) (min-colors 8) (background light))
 246        (:foreground "green"))
 247       (((class color) (min-colors 8) (background dark))
 248        (:foreground "yellow"))))
 249   "Face for headline with the ARCHIVE tag."
 250   :group 'org-faces)
 251
 252 (defface org-link
 253   (org-compatible-face 'link
 254     '((((class color) (background light)) (:foreground "Purple" :underline t))
 255       (((class color) (background dark)) (:foreground "Cyan" :underline t))
 256       (t (:underline t))))
 257   "Face for links."
 258   :group 'org-faces)
 259
 260 (defface org-footnote
 261   '((((class color) (background light)) (:foreground "Purple" :underline t))
 262     (((class color) (background dark)) (:foreground "Cyan" :underline t))
 263     (t (:underline t)))
 264   "Face for links."
 265   :group 'org-faces)
 266
 267 (defface org-ellipsis
 268   '((((class color) (background light)) (:foreground "DarkGoldenrod" :underline t))
 269     (((class color) (background dark)) (:foreground "LightGoldenrod" :underline t))
 270     (t (:strike-through t)))
 271   "Face for the ellipsis in folded text."
 272   :group 'org-faces)
 273
 274 (defface org-target
 275   '((((class color) (background light)) (:underline t))
 276     (((class color) (background dark)) (:underline t))
 277     (t (:underline t)))
 278   "Face for link targets."
 279   :group 'org-faces)
 280
 281 (defface org-date
 282   '((((class color) (background light)) (:foreground "Purple" :underline t))
 283     (((class color) (background dark)) (:foreground "Cyan" :underline t))
 284     (t (:underline t)))
 285   "Face for date/time stamps."
 286   :group 'org-faces)
 287
 288 (defface org-date-selected
 289   (org-compatible-face nil
 290     '((((class color) (min-colors 16) (background light)) (:foreground "Red1" :inverse-video t))
 291       (((class color) (min-colors 16) (background dark))  (:foreground "Pink" :inverse-video t))
 292       (((class color) (min-colors 8)  (background light)) (:foreground "red"  :inverse-video t))
 293       (((class color) (min-colors 8)  (background dark))  (:foreground "red"  :inverse-video t))
 294       (t (:inverse-video t))))
 295   "Face for highlighting the calendar day when using `org-read-date'.
 296 Using a bold face here might cause discrepencies while displaying the
 297 calendar."
 298   :group 'org-faces)
 299
 300 (defface org-sexp-date
 301   '((((class color) (background light)) (:foreground "Purple"))
 302     (((class color) (background dark)) (:foreground "Cyan"))
 303     (t (:underline t)))
 304   "Face for diary-like sexp date specifications."
 305   :group 'org-faces)
 306
 307 (defface org-tag
 308   '((t (:bold t)))
 309   "Default face for tags.
 310 Note that the variable `org-tag-faces' can be used to overrule this face for
 311 specific tags."
 312   :group 'org-faces)
 313
 314 (defface org-list-dt
 315   '((t (:bold t)))
 316   "Default face for definition terms in lists."
 317   :group 'org-faces)
 318
 319 (defface org-todo ; font-lock-warning-face
 320   (org-compatible-face nil
 321     '((((class color) (min-colors 16) (background light)) (:foreground "Red1" :bold t))
 322       (((class color) (min-colors 16) (background dark))  (:foreground "Pink" :bold t))
 323       (((class color) (min-colors 8)  (background light)) (:foreground "red"  :bold t))
 324       (((class color) (min-colors 8)  (background dark))  (:foreground "red"  :bold t))
 325       (t (:inverse-video t :bold t))))
 326   "Face for TODO keywords."
 327   :group 'org-faces)
 328
 329 (defface org-done ;; originally copied from font-lock-type-face
 330   (org-compatible-face nil
 331     '((((class color) (min-colors 16) (background light)) (:foreground "ForestGreen" :bold t))
 332       (((class color) (min-colors 16) (background dark)) (:foreground "PaleGreen" :bold t))
 333       (((class color) (min-colors 8)) (:foreground "green"))
 334       (t (:bold t))))
 335   "Face used for todo keywords that indicate DONE items."
 336   :group 'org-faces)
 337
 338 (defface org-agenda-done ;; originally copied from font-lock-type-face
 339   (org-compatible-face nil
 340     '((((class color) (min-colors 16) (background light)) (:foreground "ForestGreen"))
 341       (((class color) (min-colors 16) (background dark)) (:foreground "PaleGreen"))
 342       (((class color) (min-colors 8)) (:foreground "green"))
 343       (t (:bold nil))))
 344   "Face used in agenda, to indicate lines switched to DONE.
 345 This face is used to de-emphasize items that where brightly colored in the
 346 agenda because they were things to do, or overdue.  The DONE state itself
 347 is of course immediately visible, but for example a passed deadline is
 348 \(by default) very bright read.  This face could be simply the default face
 349 of the frame, for example."
 350   :group 'org-faces)
 351
 352 (defface org-headline-done ;; originally copied from font-lock-string-face
 353   (org-compatible-face nil
 354     '((((class color) (min-colors 16) (background light)) (:foreground "RosyBrown"))
 355       (((class color) (min-colors 16) (background dark)) (:foreground "LightSalmon"))
 356       (((class color) (min-colors 8)  (background light)) (:bold nil))))
 357   "Face used to indicate that a headline is DONE.
 358 This face is only used if `org-fontify-done-headline' is set.  If applies
 359 to the part of the headline after the DONE keyword."
 360   :group 'org-faces)
 361
 362 (defcustom org-faces-easy-properties
 363   '((todo . :foreground) (tag . :foreground) (priority . :foreground))
 364   "The property changes by easy faces.
 365 This is an alist, the keys show the area of application, the values
 366 can be `:foreground' or `:background'.  A color string for special
 367 keywords will then be interpreted as either foreground or background
 368 color."
 369   :group 'org-faces
 370   :group 'org-todo
 371   :version "24.1"
 372   :type '(repeat
 373           (cons (choice (const todo) (const tag) (const priority))
 374                 (choice (const :foreground) (const :background)))))
 375
 376 (defcustom org-todo-keyword-faces nil
 377   "Faces for specific TODO keywords.
 378 This is a list of cons cells, with TODO keywords in the car
 379 and faces in the cdr.  The face can be a symbol, a color
 380 as a string (in which case the rest is inherited from the `org-todo' face),
 381 or a property list of attributes, like
 382    (:foreground \"blue\" :weight bold :underline t).
 383 If it is a color string, the variable `org-faces-easy-properties'
 384 determines if it is a foreground or a background color."
 385   :group 'org-faces
 386   :group 'org-todo
 387   :type '(repeat
 388           (cons
 389            (string :tag "Keyword")
 390            (choice :tag "Face   "
 391                    (string :tag "Color")
 392                    (sexp :tag "Face")))))
 393
 394 (defcustom org-priority-faces nil
 395   "Faces for specific Priorities.
 396 This is a list of cons cells, with priority character in the car
 397 and faces in the cdr.  The face can be a symbol, a color as
 398 as a string, or a property list of attributes, like
 399     (:foreground \"blue\" :weight bold :underline t).
 400 If it is a color string, the variable `org-faces-easy-properties'
 401 determines if it is a foreground or a background color."
 402   :group 'org-faces
 403   :group 'org-todo
 404   :type '(repeat
 405           (cons
 406            (character :tag "Priority")
 407            (choice    :tag "Face    "
 408                       (string :tag "Color")
 409                       (sexp :tag "Face")))))
 410
 411 (defvar org-tags-special-faces-re nil)
 412 (defun org-set-tag-faces (var value)
 413   (set var value)
 414   (if (not value)
 415       (setq org-tags-special-faces-re nil)
 416     (setq org-tags-special-faces-re
 417           (concat ":\\(" (mapconcat 'car value "\\|") "\\):"))))
 418
 419 (defface org-checkbox
 420   (org-compatible-face 'bold
 421     '((t (:bold t))))
 422   "Face for checkboxes."
 423   :group 'org-faces)
 424
 425
 426 (org-copy-face 'org-todo 'org-checkbox-statistics-todo
 427   "Face used for unfinished checkbox statistics.")
 428
 429 (org-copy-face 'org-done 'org-checkbox-statistics-done
 430   "Face used for finished checkbox statistics.")
 431
 432 (defcustom org-tag-faces nil
 433   "Faces for specific tags.
 434 This is a list of cons cells, with tags in the car and faces in the cdr.
 435 The face can be a symbol, a foreground color (in which case the rest is
 436 inherited from the `org-tag' face) or a property list of attributes,
 437 like (:foreground \"blue\" :weight bold :underline t).
 438 If you set this variable through customize, it will immediately be effective
 439 in new buffers and in modified lines.
 440 If you set it with Lisp, a restart of Emacs is required to activate the
 441 changes."
 442   :group 'org-faces
 443   :group 'org-tags
 444   :set 'org-set-tag-faces
 445   :type '(repeat
 446           (cons
 447            (string :tag "Tag ")
 448            (choice :tag "Face"
 449                    (string :tag "Foreground color")
 450                    (sexp :tag "Face")))))
 451
 452 (defface org-table ;; originally copied from font-lock-function-name-face
 453   (org-compatible-face nil
 454     '((((class color) (min-colors 88) (background light)) (:foreground "Blue1"))
 455       (((class color) (min-colors 88) (background dark)) (:foreground "LightSkyBlue"))
 456       (((class color) (min-colors 16) (background light)) (:foreground "Blue"))
 457       (((class color) (min-colors 16) (background dark)) (:foreground "LightSkyBlue"))
 458       (((class color) (min-colors 8)  (background light)) (:foreground "blue"))
 459       (((class color) (min-colors 8)  (background dark)))))
 460   "Face used for tables."
 461   :group 'org-faces)
 462
 463 (defface org-formula
 464   (org-compatible-face nil
 465     '((((class color) (min-colors 88) (background light)) (:foreground "Firebrick"))
 466       (((class color) (min-colors 88) (background dark)) (:foreground "chocolate1"))
 467       (((class color) (min-colors 8)  (background light)) (:foreground "red"))
 468       (((class color) (min-colors 8)  (background dark)) (:foreground "red"))
 469       (t (:bold t :italic t))))
 470   "Face for formulas."
 471   :group 'org-faces)
 472
 473 (defface org-code
 474   (org-compatible-face 'shadow
 475     '((((class color grayscale) (min-colors 88) (background light))
 476        (:foreground "grey50"))
 477       (((class color grayscale) (min-colors 88) (background dark))
 478        (:foreground "grey70"))
 479       (((class color) (min-colors 8) (background light))
 480        (:foreground "green"))
 481       (((class color) (min-colors 8) (background dark))
 482        (:foreground "yellow"))))
 483   "Face for fixed-width text like code snippets."
 484   :group 'org-faces
 485   :version "22.1")
 486
 487 (defface org-meta-line
 488   (org-compatible-face 'font-lock-comment-face nil)
 489   "Face for meta lines startin with \"#+\"."
 490   :group 'org-faces
 491   :version "22.1")
 492
 493 (defface org-document-title
 494   '((((class color) (background light)) (:foreground "midnight blue" :weight bold))
 495     (((class color) (background dark)) (:foreground "pale turquoise" :weight bold))
 496     (t (:weight bold)))
 497   "Face for document title, i.e. that which follows the #+TITLE: keyword."
 498   :group 'org-faces)
 499
 500 (defface org-document-info
 501   '((((class color) (background light)) (:foreground "midnight blue"))
 502     (((class color) (background dark)) (:foreground "pale turquoise"))
 503     (t nil))
 504   "Face for document date, author and email; i.e. that which
 505 follows a #+DATE:, #+AUTHOR: or #+EMAIL: keyword."
 506   :group 'org-faces)
 507
 508 (defface org-document-info-keyword
 509   (org-compatible-face 'shadow
 510     '((((class color grayscale) (min-colors 88) (background light))
 511        (:foreground "grey50"))
 512       (((class color grayscale) (min-colors 88) (background dark))
 513        (:foreground "grey70"))
 514       (((class color) (min-colors 8) (background light))
 515        (:foreground "green"))
 516       (((class color) (min-colors 8) (background dark))
 517        (:foreground "yellow"))))
 518   "Face for #+TITLE:, #+AUTHOR:, #+EMAIL: and #+DATE: keywords."
 519   :group 'org-faces)
 520
 521 (defface org-block
 522   (org-compatible-face 'shadow
 523     '((((class color grayscale) (min-colors 88) (background light))
 524        (:foreground "grey50"))
 525       (((class color grayscale) (min-colors 88) (background dark))
 526        (:foreground "grey70"))
 527       (((class color) (min-colors 8) (background light))
 528        (:foreground "green"))
 529       (((class color) (min-colors 8) (background dark))
 530        (:foreground "yellow"))))
 531   "Face text in #+begin ... #+end blocks."
 532   :group 'org-faces
 533   :version "22.1")
 534
 535 (defface org-block-background '((t ()))
 536   "Face used for the source block background.")
 537
 538 (org-copy-face 'org-meta-line 'org-block-begin-line
 539   "Face used for the line delimiting the begin of source blocks.")
 540
 541 (org-copy-face 'org-meta-line 'org-block-end-line
 542   "Face used for the line delimiting the end of source blocks.")
 543
 544 (defface org-verbatim
 545   (org-compatible-face 'shadow
 546     '((((class color grayscale) (min-colors 88) (background light))
 547        (:foreground "grey50" :underline t))
 548       (((class color grayscale) (min-colors 88) (background dark))
 549        (:foreground "grey70" :underline t))
 550       (((class color) (min-colors 8) (background light))
 551        (:foreground "green" :underline t))
 552       (((class color) (min-colors 8) (background dark))
 553        (:foreground "yellow" :underline t))))
 554   "Face for fixed-with text like code snippets."
 555   :group 'org-faces
 556   :version "22.1")
 557
 558 (org-copy-face 'org-block 'org-quote
 559   "Face for #+BEGIN_QUOTE ... #+END_QUOTE blocks.")
 560 (org-copy-face 'org-block 'org-verse
 561   "Face for #+BEGIN_VERSE ... #+END_VERSE blocks.")
 562
 563 (defcustom org-fontify-quote-and-verse-blocks nil
 564   "Non-nil means, add a special face to #+begin_quote and #+begin_verse block.
 565 When nil, format these as normal Org.  This is the default, because the
 566 content of these blocks will still be treated as Org syntax."
 567   :group 'org-faces
 568   :version "24.1"
 569   :type 'boolean)
 570
 571 (defface org-clock-overlay ;; copied from secondary-selection
 572   (org-compatible-face nil
 573     '((((class color) (min-colors 88) (background light))
 574        (:background "yellow1"))
 575       (((class color) (min-colors 88) (background dark))
 576        (:background "SkyBlue4"))
 577       (((class color) (min-colors 16) (background light))
 578        (:background "yellow"))
 579       (((class color) (min-colors 16) (background dark))
 580        (:background "SkyBlue4"))
 581       (((class color) (min-colors 8))
 582        (:background "cyan" :foreground "black"))
 583       (t (:inverse-video t))))
 584   "Basic face for displaying the secondary selection."
 585   :group 'org-faces)
 586
 587 (defface org-agenda-structure ;; originally copied from font-lock-function-name-face
 588   (org-compatible-face nil
 589     '((((class color) (min-colors 88) (background light)) (:foreground "Blue1"))
 590       (((class color) (min-colors 88) (background dark)) (:foreground "LightSkyBlue"))
 591       (((class color) (min-colors 16) (background light)) (:foreground "Blue"))
 592       (((class color) (min-colors 16) (background dark)) (:foreground "LightSkyBlue"))
 593       (((class color) (min-colors 8)) (:foreground "blue" :bold t))
 594       (t (:bold t))))
 595   "Face used in agenda for captions and dates."
 596   :group 'org-faces)
 597
 598 (org-copy-face 'org-agenda-structure 'org-agenda-date
 599   "Face used in agenda for normal days.")
 600
 601 (org-copy-face 'org-agenda-date 'org-agenda-date-today
 602   "Face used in agenda for today."
 603   :weight 'bold :italic 't)
 604
 605 (org-copy-face 'secondary-selection 'org-agenda-clocking
 606   "Face marking the current clock item in the agenda.")
 607
 608 (org-copy-face 'org-agenda-date 'org-agenda-date-weekend
 609   "Face used in agenda for weekend days.
 610 See the variable `org-agenda-weekend-days' for a definition of which days
 611 belong to the weekend."
 612   :weight 'bold)
 613
 614 (defface org-scheduled
 615   (org-compatible-face nil
 616     '((((class color) (min-colors 88) (background light)) (:foreground "DarkGreen"))
 617       (((class color) (min-colors 88) (background dark)) (:foreground "PaleGreen"))
 618       (((class color) (min-colors 8)) (:foreground "green"))
 619       (t (:bold t :italic t))))
 620   "Face for items scheduled for a certain day."
 621   :group 'org-faces)
 622
 623 (defface org-scheduled-today
 624   (org-compatible-face nil
 625     '((((class color) (min-colors 88) (background light)) (:foreground "DarkGreen"))
 626       (((class color) (min-colors 88) (background dark)) (:foreground "PaleGreen"))
 627       (((class color) (min-colors 8)) (:foreground "green"))
 628       (t (:bold t :italic t))))
 629   "Face for items scheduled for a certain day."
 630   :group 'org-faces)
 631
 632 (defface org-agenda-dimmed-todo-face
 633   '((((background light)) (:foreground "grey50"))
 634     (((background dark)) (:foreground "grey50")))
 635   "Face used to dim blocked tasks in the agenda."
 636   :group 'org-faces)
 637
 638 (defface org-scheduled-previously
 639   (org-compatible-face nil
 640     '((((class color) (min-colors 88) (background light)) (:foreground "Firebrick"))
 641       (((class color) (min-colors 88) (background dark)) (:foreground "chocolate1"))
 642       (((class color) (min-colors 8)  (background light)) (:foreground "red"))
 643       (((class color) (min-colors 8)  (background dark)) (:foreground "red" :bold t))
 644       (t (:bold t))))
 645   "Face for items scheduled previously, and not yet done."
 646   :group 'org-faces)
 647
 648 (defface org-upcoming-deadline
 649   (org-compatible-face nil
 650     '((((class color) (min-colors 88) (background light)) (:foreground "Firebrick"))
 651       (((class color) (min-colors 88) (background dark)) (:foreground "chocolate1"))
 652       (((class color) (min-colors 8)  (background light)) (:foreground "red"))
 653       (((class color) (min-colors 8)  (background dark)) (:foreground "red" :bold t))
 654       (t (:bold t))))
 655   "Face for items scheduled previously, and not yet done."
 656   :group 'org-faces)
 657
 658 (defcustom org-agenda-deadline-faces
 659   '((1.0 . org-warning)
 660     (0.5 . org-upcoming-deadline)
 661     (0.0 . default))
 662   "Faces for showing deadlines in the agenda.
 663 This is a list of cons cells.  The cdr of each cell is a face to be used,
 664 and it can also just be like '(:foreground \"yellow\").
 665 Each car is a fraction of the head-warning time that must have passed for
 666 this the face in the cdr to be used for display.  The numbers must be
 667 given in descending order.  The head-warning time is normally taken
 668 from `org-deadline-warning-days', but can also be specified in the deadline
 669 timestamp itself, like this:
 670
 671    DEADLINE: <2007-08-13 Mon -8d>
 672
 673 You may use d for days, w for weeks, m for months and y for years.  Months
 674 and years will only be treated in an approximate fashion (30.4 days for a
 675 month and 365.24 days for a year)."
 676   :group 'org-faces
 677   :group 'org-agenda-daily/weekly
 678   :type '(repeat
 679           (cons
 680            (number :tag "Fraction of head-warning time passed")
 681            (sexp :tag "Face"))))
 682
 683 (defface org-agenda-restriction-lock
 684   (org-compatible-face nil
 685     '((((class color) (min-colors 88) (background light)) (:background "yellow1"))
 686       (((class color) (min-colors 88) (background dark))  (:background "skyblue4"))
 687       (((class color) (min-colors 16) (background light)) (:background "yellow1"))
 688       (((class color) (min-colors 16) (background dark))  (:background "skyblue4"))
 689       (((class color) (min-colors 8)) (:background "cyan" :foreground "black"))
 690       (t (:inverse-video t))))
 691   "Face for showing the agenda restriction lock."
 692   :group 'org-faces)
 693
 694 (defface org-agenda-filter-tags
 695   (org-compatible-face 'modeline
 696     nil)
 697   "Face for tag(s) in the mode-line when filtering the agenda."
 698   :group 'org-faces)
 699
 700 (defface org-agenda-filter-category
 701   (org-compatible-face 'modeline
 702     nil)
 703   "Face for tag(s) in the mode-line when filtering the agenda."
 704   :group 'org-faces)
 705
 706 (defface org-time-grid ;; originally copied from font-lock-variable-name-face
 707   (org-compatible-face nil
 708     '((((class color) (min-colors 16) (background light)) (:foreground "DarkGoldenrod"))
 709       (((class color) (min-colors 16) (background dark)) (:foreground "LightGoldenrod"))
 710       (((class color) (min-colors 8)) (:foreground "yellow" :weight light))))
 711   "Face used for time grids."
 712   :group 'org-faces)
 713
 714 (org-copy-face 'org-time-grid 'org-agenda-current-time
 715   "Face used to show the current time in the time grid.")
 716
 717 (defface org-agenda-diary
 718   (org-compatible-face 'default
 719     nil)
 720   "Face used for agenda entries that come from the Emacs diary."
 721   :group 'org-faces)
 722
 723 (defface org-agenda-calendar-event
 724   (org-compatible-face 'default
 725     nil)
 726   "Face used to show events and appointments in the agenda."
 727   :group 'org-faces)
 728
 729 (defface org-agenda-calendar-sexp
 730   (org-compatible-face 'default
 731     nil)
 732   "Face used to show events computed from a S-expression."
 733   :group 'org-faces)
 734
 735 (defconst org-level-faces
 736   '(org-level-1 org-level-2 org-level-3 org-level-4
 737                 org-level-5 org-level-6 org-level-7 org-level-8
 738                 ))
 739
 740 (defcustom org-n-level-faces (length org-level-faces)
 741   "The number of different faces to be used for headlines.
 742 Org-mode defines 8 different headline faces, so this can be at most 8.
 743 If it is less than 8, the level-1 face gets re-used for level N+1 etc."
 744   :type 'integer
 745   :group 'org-faces)
 746
 747 (defcustom org-cycle-level-faces t
 748   "Non-nil means level styles cycle after level `org-n-level-faces'.
 749 Then so level org-n-level-faces+1 is styled like level 1.
 750 If nil, then all levels >=org-n-level-faces are styled like
 751 level org-n-level-faces"
 752   :group 'org-appearance
 753   :group 'org-faces
 754   :version "24.1"
 755   :type 'boolean)
 756
 757 (defface org-latex-and-export-specials
 758   (let ((font (cond ((assq :inherit custom-face-attributes)
 759                      '(:inherit underline))
 760                     (t '(:underline t)))))
 761     `((((class grayscale) (background light))
 762        (:foreground "DimGray" ,@font))
 763       (((class grayscale) (background dark))
 764        (:foreground "LightGray" ,@font))
 765       (((class color) (background light))
 766        (:foreground "SaddleBrown"))
 767       (((class color) (background dark))
 768        (:foreground "burlywood"))
 769       (t (,@font))))
 770   "Face used to highlight math latex and other special exporter stuff."
 771   :group 'org-faces)
 772
 773 (org-copy-face 'modeline 'org-mode-line-clock
 774   "Face used for clock display in mode line.")
 775 (org-copy-face 'modeline 'org-mode-line-clock-overrun
 776   "Face used for clock display for overrun tasks in mode line."
 777   :background "red")
 778
 779 (provide 'org-faces)
 780
 781 ;;; org-faces.el ends here