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 350 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.  Through this system,
  25 variables of Emacs in general, and of Org-mode in particular can be
  26 grouped, and organized into a hierarchical system which makes it much
  27 easier to find the right one.  The best way to start is to /browse a
  28 customization group/.  This can be done with
  29
  30 #+example
  31 M-x customize-browse RET
  32 #+end_example
  33
  34 which enters the top-level group for all of Emacs and lets you drill
  35 down from there.  Org-mode provides a special command to start
  36 directly in the Org group:
  37
  38 #+example
  39 M-x org-customize RET
  40 #+end_example
  41
  42 You can also access this command from the Org menu under =Org ->
  43 Customize -> Brows Org Group=.
  44
  45 * How to change the parameters for the clocktable in the Org-mode Daily Agenda
  46
  47 So here is an example.  Recently, Flavio de Souza [[http://article.gmane.org/gmane.emacs.orgmode/9538][asked]] on
  48 [[http://dir.gmane.org/gmane.emacs.orgmode][emacs-orgmode@gnu.org]] how he could change the maximum level for the
  49 construction of the clock table in the Org Daily/Weekly agenda.
  50
  51 Here is the illustrated answer:
  52
  53
  54 1. In an Org-buffer, use the menu to select
  55    Org -> Customize -> Browse Org Group
  56
  57     [[file:../images/cd/customize-1.png]]
  58
  59 2. Open the "Org Agenda" group by clicking the "+" in front of it.
  60
  61     [[file:../images/cd/customize-2.png]]
  62
  63
  64 3. Inside you find another group: "Daily/Weekly Agenda", and in that group
  65    there is the option "Org Agenda Clockreport Parameter Plist":
  66
  67     [[file:../images/cd/customize-3.png]]
  68
  69 4. When you select this variable, you are in a customization buffer
  70    where you can changes the parameters for this option, in your case
  71    you will set maxlevel to 3.
  72
  73     [[file:../images/cd/customize-4.png]]
  74
  75 5. After you are done, click on *Set for current section* and then on
  76    *Save for future sessions* near the top of the buffer.
  77
  78
  79 It may not always be as simple to find the correct variable, but with
  80 some clicking around, you will get there.  And if you find that a
  81 particular variable has a stupid name, or is not in the right group,
  82 [[mailto:emacs-orgmode@gnu.org][drop us a note on]] so that we can fix things.