org-tutorials/org-appearance.org

   1 #+TITLE: Org appearance
   2
   3 [[file:index.org][{Back to Worg's index}]]
   4
   5 This page is about customizing the appearance of Org-mode.
   6
   7 * Customizing Org appearance
   8   :PROPERTIES:
   9   :ID:       849d13ea-d2ca-45e8-ac49-ff7586c119cb
  10   :END:
  11
  12 To customize all aspects of Org appearance use
  13
  14 #+begin_example
  15 =M-x customize-group RET org-font-lock RET=
  16 #+end_example
  17
  18 Here you will find several options that can be chaged, and a further
  19 link to a page for customizing [[id:f47abcd0-e31e-4b23-87db-d916d21665ad][Org-mode faces]].
  20
  21 ** Customize Org-mode faces
  22   :PROPERTIES:
  23   :ID:       f47abcd0-e31e-4b23-87db-d916d21665ad
  24   :END:
  25
  26 A "face" is the term emacs uses to refer to the font and colour of
  27 some text (as well as other features such as underlining etc).
  28
  29 Customizing Org faces is straightforward:
  30
  31 #+begin_example
  32 =M-x customize-group RET org-faces RET=
  33 #+end_example
  34
  35 You can also customize faces on the fly by just calling the
  36 =customize-face= command with the cursor on the face you want to
  37 customize.
  38
  39 ** Hiding leading stars
  40    the variable org-hide-leading-stars can be configured so that only
  41    one star is shown at the start of each heading. Many people find
  42    that this give the org buffer a cleaner appearance. This can be set
  43    in the Org Font Lock customize group as explained above in
  44    [[id:849d13ea-d2ca-45e8-ac49-ff7586c119cb][Customizing Org appearance]].
  45
  46 ** Customizing the title, date, author and email lines.
  47
  48    The title, date and author information for an org document are
  49    specified using the special keywords =#+TITLE:=, =#+DATE=,
  50    =#+AUTHOR=, =#+EMAIL=.
  51
  52    By default, title, author, date and email lines appear in dark blue
  53    with the initial keywords greyed out. The title is in a larger font
  54    than the others. To change this, customize the faces
  55
  56    - org-document-title
  57    - org-document-info
  58    - org-document-info-keyword
  59
  60    In addition, the variable org-hidden-keywords can be used to make the
  61    corresponding keywords disappear.
  62
  63 ** Using only odd outline levels
  64    The variable org-odd-levels-only can be used so that Org only uses
  65    odd-numbered outline levels. Again, some people prefer this, finding
  66    that the Org buffer looks less cluttered.
  67 * Org-mode ready color-themes
  68
  69 A popular way of customizing Emacs colors is to use the color-theme
  70 package (see [[http://www.emacswiki.org/emacs/ColorTheme][color-theme emacswiki page]].)
  71
  72 Here is a list of color themes that are aware of Org:
  73
  74 ** [[http://www.brockman.se/software/zenburn/zenburn.el][zenburn.el]] (maintained by Daniel Brockman)
  75
  76   [[file:../img/screenshots/org-mode-zenburn.jpg][file:../img/screenshots/thumbs/org-mode-zenburn.png]]
  77
  78
  79
  80
  81
  82
  83
  84
  85 * Org config                                                       :noexport:
  86 #+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
  87 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
  88 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
  89 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) noexport
  90 #+AUTHOR:     Worg people
  91 #+EMAIL:      bzg AT altern DOT org
  92 #+LANGUAGE:   en
  93 #+PRIORITIES: A C B
  94 #+CATEGORY:   worg
  95