org-tutorials/org-customize.org

   1 #+OPTIONS:    H:3 num:nil toc:nil \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:      Customizing Org-mode
   6 #+AUTHOR:     Carsten Dominik
   7 #+EMAIL:      carsten dot dominik at gmail dot com
   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 [[file:index.org][{Back to Worg's index}]]
  16
  17 This page contains an illustrated example on how to use the Emacs
  18 customization system to find the right variable for a particular
  19 purpose.  Org-mode contains more than 650 options that can be used to
  20 fine-tune a detail, and it can be daunting to find the right variable
  21 for a particular job - even though more often than not, the variable
  22 does exist.
  23
  24 The [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Easy-Customization.html#Easy-Customization][Emacs customize system]] offers a way out.  With this tool,
  25 variables can be grouped and organized into a hierarchical system
  26 that makes it much easier to find the right one.  The best way to
  27 start is to /browse a customization group/.  This can be done with
  28
  29 #+example
  30 M-x customize-browse RET
  31 #+end_example
  32
  33 which enters the top-level group for all of Emacs and lets you drill
  34 down from there.  Org-mode provides a special command to start
  35 directly in the Org group:
  36
  37 #+example
  38 M-x org-customize RET
  39 #+end_example
  40
  41 You can also access this command from the Org menu under =Org ->
  42 Customize -> Brows Org Group=.
  43
  44 * How to change the parameters for the clocktable in the Org-mode Daily Agenda
  45
  46 So here is an example.  Recently, Flavio de Souza [[http://article.gmane.org/gmane.emacs.orgmode/9538][asked]] on
  47 [[http://dir.gmane.org/gmane.emacs.orgmode][emacs-orgmode@gnu.org]] how he could change the maximum level for the
  48 construction of the clock table in the Org Daily/Weekly agenda.
  49
  50 Here is the illustrated answer:
  51
  52
  53 1. In an Org-buffer, use the menu to select
  54    Org -> Customize -> Browse Org Group
  55
  56     [[file:../images/cd/customize-1.png]]
  57
  58 2. Open the "Org Agenda" group by clicking the "+" in front of it.
  59
  60     [[file:../images/cd/customize-2.png]]
  61
  62
  63 3. Inside you find another group: "Daily/Weekly Agenda", and in that group
  64    there is the option "Org Agenda Clockreport Parameter Plist":
  65
  66     [[file:../images/cd/customize-3.png]]
  67
  68 4. When you select this variable, you are in a customization buffer
  69    where you can changes the parameters for this option, in your case
  70    you will set maxlevel to 3.
  71
  72     [[file:../images/cd/customize-4.png]]
  73
  74 5. After you are done, click on *Set for current section* and then on
  75    *Save for future sessions* near the top of the buffer.
  76
  77
  78 It may not always be as simple to find the correct variable, but with
  79 some clicking around, you will get there.  And if you find that a
  80 particular variable has a stupid name, or is not in the right group,
  81 [[mailto:emacs-orgmode@gnu.org][drop us a note]] so that we can fix things.