org-tutorials/org-appearance.org

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