org-tutorials/org-appearance.org

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