Release 4.53
[org-mode/org-mode-NeilSmithlineMods.git] / orgcard.tex
blob7ef75acedc405fbf444bfb263d09a8944931d145
1 % Reference Card for Org Mode
2 \def\orgversionnumber{4.53}
3 \def\year{2006}
5 %**start of header
6 \newcount\columnsperpage
8 % This file can be printed with 1, 2, or 3 columns per page (see below).
9 % At the moment this card works quite nicely in 3 column format and
10 % currently takes 2 full pages. It is thus suited to producing one
11 % double-side page when printed.
13 % There are a couple of tweaks in the format of this card which make it work
14 % slightly better on A4 paper. The changes due, I think, to Stephen Eglen,
15 % are commented below. Revert the changes if you want letter sized paper.
17 % Try running something like
18 % tex org-mode-ref.tex; dvips -t landscape org-mode-ref.dvi
19 % to print the card
21 \columnsperpage=3
23 % Copyright (c) 2004 Philip Rooke, 2005, 2006 Free Software Foundation
25 % GNU Emacs is free software; you can redistribute it and/or modify
26 % it under the terms of the GNU General Public License as published by
27 % the Free Software Foundation; either version 2, or (at your option)
28 % any later version.
30 % GNU Emacs is distributed in the hope that it will be useful,
31 % but WITHOUT ANY WARRANTY; without even the implied warranty of
32 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
33 % GNU General Public License for more details.
35 % You should have received a copy of the GNU General Public License
36 % along with GNU Emacs; see the file COPYING. If not, write to
37 % the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
38 % Boston, MA 02111-1307, USA.
40 % This file is intended to be processed by plain TeX (TeX82).
42 % The final reference card has six columns, three on each side.
43 % This file can be used to produce it in any of three ways:
44 % 1 column per page
45 % produces six separate pages, each of which needs to be reduced to 80%.
46 % This gives the best resolution.
47 % 2 columns per page
48 % produces three already-reduced pages.
49 % You will still need to cut and paste.
50 % 3 columns per page
51 % produces two pages which must be printed sideways to make a
52 % ready-to-use 8.5 x 11 inch reference card.
53 % For this you need a dvi device driver that can print sideways.
54 % Which mode to use is controlled by setting \columnsperpage above.
56 % Author:
57 % Stephen Gildea
58 % Internet: gildea@stop.mail-abuse.org
60 % Thanks to Paul Rubin, Bob Chassell, Len Tower, and Richard Mlynarik
61 % for their many good ideas.
63 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
64 \centerline{\small \copyright\ 2004, 2005, 2006\ Free Software Foundation, Inc.
65 Permissions on back. v\orgversionnumber}}
67 \def\copyrightnotice{
68 \vskip 1ex plus 100 fill\begingroup\small
69 \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
70 \centerline{v\orgversionnumber{} for Org-Mode \orgversionnumber{}, \year}
71 \centerline{Author: Philip Rooke}
72 \centerline{based on refcard design and format by Stephen Gildea}
74 Permission is granted to make and distribute copies of
75 this card provided the copyright notice and this permission notice
76 are preserved on all copies.
78 \endgroup}
80 % make \bye not \outer so that the \def\bye in the \else clause below
81 % can be scanned without complaint.
82 \def\bye{\par\vfill\supereject\end}
84 \newdimen\intercolumnskip %horizontal space between columns
85 \newbox\columna %boxes to hold columns already built
86 \newbox\columnb
88 \def\ncolumns{\the\columnsperpage}
90 \message{[\ncolumns\space
91 column\if 1\ncolumns\else s\fi\space per page]}
93 \def\scaledmag#1{ scaled \magstep #1}
95 % This multi-way format was designed by Stephen Gildea October 1986.
96 % Note that the 1-column format is fontfamily-independent.
97 \if 1\ncolumns %one-column format uses normal size
98 \hsize 4in
99 \vsize 10in
100 \voffset -.7in
101 \font\titlefont=\fontname\tenbf \scaledmag3
102 \font\headingfont=\fontname\tenbf \scaledmag2
103 \font\smallfont=\fontname\sevenrm
104 \font\smallsy=\fontname\sevensy
106 \footline{\hss\folio}
107 \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}}
108 \else %2 or 3 columns uses prereduced size
109 \hsize 3.2in
111 % FIXME - Try to make things more A4 friendly
112 % \vsize 7.95in
113 \vsize 7.65in
114 % \hoffset -.75in
115 \hoffset -.25in
116 \voffset -.745in
117 \font\titlefont=cmbx10 \scaledmag2
118 \font\headingfont=cmbx10 \scaledmag1
119 \font\smallfont=cmr6
120 \font\smallsy=cmsy6
121 \font\eightrm=cmr8
122 \font\eightbf=cmbx8
123 \font\eightit=cmti8
124 \font\eighttt=cmtt8
125 \font\eightmi=cmmi8
126 \font\eightsy=cmsy8
127 \textfont0=\eightrm
128 \textfont1=\eightmi
129 \textfont2=\eightsy
130 \def\rm{\eightrm}
131 \def\bf{\eightbf}
132 \def\it{\eightit}
133 \def\tt{\eighttt}
135 % FIXME - Try to make things more A4 friendly
136 % \normalbaselineskip=.8\normalbaselineskip
137 \normalbaselineskip=.7\normalbaselineskip
138 \normallineskip=.8\normallineskip
139 \normallineskiplimit=.8\normallineskiplimit
140 \normalbaselines\rm %make definitions take effect
142 \if 2\ncolumns
143 \let\maxcolumn=b
144 \footline{\hss\rm\folio\hss}
145 \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}}
146 \else \if 3\ncolumns
147 \let\maxcolumn=c
148 \nopagenumbers
149 \else
150 \errhelp{You must set \columnsperpage equal to 1, 2, or 3.}
151 \errmessage{Illegal number of columns per page}
152 \fi\fi
154 \intercolumnskip=.46in
155 \def\abc{a}
156 \output={% %see The TeXbook page 257
157 % This next line is useful when designing the layout.
158 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
159 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a}
160 \else\if a\abc
161 \global\setbox\columna\columnbox \global\def\abc{b}
162 %% in case we never use \columnb (two-column mode)
163 \global\setbox\columnb\hbox to -\intercolumnskip{}
164 \else
165 \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi}
166 \def\multicolumnformat{\shipout\vbox{\makeheadline
167 \hbox{\box\columna\hskip\intercolumnskip
168 \box\columnb\hskip\intercolumnskip\columnbox}
169 \makefootline}\advancepageno}
170 \def\columnbox{\leftline{\pagebody}}
172 \def\bye{\par\vfill\supereject
173 \if a\abc \else\null\vfill\eject\fi
174 \if a\abc \else\null\vfill\eject\fi
175 \end}
178 % we won't be using math mode much, so redefine some of the characters
179 % we might want to talk about
180 %\catcode`\^=12
181 \catcode`\_=12
183 % we also need the tilde, for file names.
184 \catcode`\~=12
186 \chardef\\=`\\
187 \chardef\{=`\{
188 \chardef\}=`\}
190 \hyphenation{mini-buf-fer}
192 \parindent 0pt
193 \parskip 1ex plus .5ex minus .5ex
195 \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip}
197 % newcolumn - force a new column. Use sparingly, probably only for
198 % the first column of a page, which should have a title anyway.
199 \outer\def\newcolumn{\vfill\eject}
201 % title - page title. Argument is title text.
202 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex}
204 % section - new major section. Argument is section name.
205 \outer\def\section#1{\par\filbreak
206 \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}%
207 \vskip 2ex plus 1ex minus 1.5ex}
209 \newdimen\keyindent
211 % beginindentedkeys...endindentedkeys - key definitions will be
212 % indented, but running text, typically used as headings to group
213 % definitions, will not.
214 \def\beginindentedkeys{\keyindent=1em}
215 \def\endindentedkeys{\keyindent=0em}
216 \endindentedkeys
218 % paralign - begin paragraph containing an alignment.
219 % If an \halign is entered while in vertical mode, a parskip is never
220 % inserted. Using \paralign instead of \halign solves this problem.
221 \def\paralign{\vskip\parskip\halign}
223 % \<...> - surrounds a variable name in a code example
224 \def\<#1>{{\it #1\/}}
226 % kbd - argument is characters typed literally. Like the Texinfo command.
227 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
229 % beginexample...endexample - surrounds literal text, such a code example.
230 % typeset in a typewriter font with line breaks preserved
231 \def\beginexample{\par\leavevmode\begingroup
232 \obeylines\obeyspaces\parskip0pt\tt}
233 {\obeyspaces\global\let =\ }
234 \def\endexample{\endgroup}
236 % key - definition of a key.
237 % \key{description of key}{key-name}
238 % prints the description left-justified, and the key-name in a \kbd
239 % form near the right margin.
240 \def\key#1#2{\leavevmode\hbox to \hsize{\vtop
241 {\hsize=.75\hsize\rightskip=1em
242 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
244 \newbox\metaxbox
245 \setbox\metaxbox\hbox{\kbd{M-x }}
246 \newdimen\metaxwidth
247 \metaxwidth=\wd\metaxbox
249 % metax - definition of a M-x command.
250 % \metax{description of command}{M-x command-name}
251 % Tries to justify the beginning of the command name at the same place
252 % as \key starts the key name. (The "M-x " sticks out to the left.)
253 \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize
254 {\hskip\keyindent\relax#1\hfil}%
255 \hskip -\metaxwidth minus 1fil
256 \kbd{#2}\hfil}}
258 % threecol - like "key" but with two key names.
259 % for example, one for doing the action backward, and one for forward.
260 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\hfil\quad
261 &\kbd{#3}\hfil\quad\cr}
263 %**end of header
266 \title{Org-Mode Reference Card (1/2)}
268 \centerline{(for version \orgversionnumber)}
270 \section{Getting Started}
272 \vskip -1mm
273 \beginexample%
274 (add-to-list 'auto-mode-alist '("\\\\.org\$" . org-mode))
275 (define-key global-map "\\C-cl" 'org-store-link)$^1$
276 (define-key global-map "\\C-ca" 'org-agenda)$^1$
277 \endexample
279 \metax{For the many customization options try}{M-x org-customize}
280 \metax{To read the on-line documentation try}{M-x org-info}
282 \section{Visibility Cycling}
284 \key{rotate current subtree between states}{TAB}
285 \key{rotate entire buffer between states}{S-TAB}
286 \key{show the whole file}{C-c C-a}
287 %\key{show branches}{C-c C-k}
289 \section{Motion}
291 \key{next/previous heading}{C-c C-n/p}
292 \key{next/previous heading, same level}{C-c C-f/b}
293 \key{backward to higher level heading}{C-c C-u}
294 \key{jump to another place in document}{C-c C-j}
295 \key{previous/next plain list item}{S-UP/DOWN$^3$}
297 \section{Structure Editing}
299 \key{insert new heading/item at current level}{M-RET}
300 \key{insert new TODO entry/checkbox item}{M-S-RET}
302 \key{promote current heading up one level}{M-LEFT}
303 \key{demote current heading down one level}{M-RIGHT}
304 \key{promote current subtree up one level}{M-S-LEFT}
305 \key{demote current subtree down one level}{M-S-RIGHT}
307 \key{move subtree/list item up/down}{M-S-UP/DOWN}
308 \key{kill subtree}{C-c C-x C-w}
309 \key{copy subtree}{C-c C-x M-w}
310 \key{yank subtree}{C-c C-x C-y}
311 \key{narrow buffer to current subtree}{C-x n s}
313 \section{Archiving}
315 \key{toggle ARCHIVE tag}{C-c C-x C-a}
316 \metax{mark fully done children}{C-u C-c C-x C-a}
317 \key{force cycling of an ARCHIVEd tree}{C-TAB}
318 \key{move subtree to archive file}{C-c \$}
319 \key{move all fully done children}{C-u C-c \$}
320 To set archive location for current file, add a line like$^2$:
321 \vskip -1mm
322 \beginexample%
323 \#+ARCHIVE: archfile::* Archived Tasks
324 \endexample
326 \section{Filtering and Sparse Trees}
328 \key{show sparse tree for all matches of a regexp}{C-c /}
329 \key{view TODO's in sparse tree}{C-c C-v}
330 \key{global TODO list in agenda mode}{C-c t$^1$}
331 \key{create sparse tree with all deadlines due}{C-c C-w}
332 \key{time sorted view of current org file}{C-c a L}
333 %\key{agenda for the week}{C-c a$^1$}
334 %\key{agenda for date at cursor}{C-c C-o}
336 \section{Tables}
338 {\bf Creating a table}
340 %\metax{insert a new Org-mode table}{M-x org-table-create}
341 \metax{just start typing, e.g.}{|Name|Phone|Age RET |- TAB}
342 \key{convert region to table}{C-c |}
343 \key{... separator at least 3 spaces}{C-3 C-c |}
345 {\bf Commands available inside tables}
347 The following commands work when the cursor is {\it inside a table}.
348 Outside of tables, the same keys may have other functionality.
350 {\bf Re-aligning and field motion}
352 \key{re-align the table without moving the cursor}{C-c C-c}
353 \key{re-align the table, move to next field}{TAB}
354 \key{move to previous field}{S-TAB}
355 \key{re-align the table, move to next row}{RET}
357 {\bf Row and column editing}
359 \key{move the current column left}{M-LEFT}
360 \key{move the current column right}{M-RIGHT}
361 \key{kill the current column}{M-S-LEFT}
362 \key{insert new column to left of cursor position}{M-S-RIGHT}
364 \key{move the current row up}{M-UP}
365 \key{move the current row down}{M-DOWN}
366 \key{kill the current row or horizontal line}{M-S-UP}
367 \key{insert new row above the current row}{M-S-DOWN}
368 \key{insert horizontal line below the current row}{C-c -}
369 \key{insert horizontal line above the current row}{C-u C-c -}
370 \key{sort lines in region}{C-c \^{}}
372 {\bf Regions}
374 \key{cut rectangular region}{C-c C-x C-w}
375 \key{copy rectangular region}{C-c C-x M-w}
376 \key{paste rectangular region}{C-c C-x C-y}
377 \key{fill paragraph across selected cells}{C-c C-q}
379 {\bf Calculations} (in combination with Emacs \kbd{calc} package)
381 \key{set and eval column formula}{C-c =}
382 \key{set and eval named-field formula}{C-u C-c =}
383 \key{edit formulas in separate buffer}{C-c '}
384 \key{re-apply all stored equations to current line}{C-c *}
385 \key{re-apply all stored equations to entire table}{C-u C-c *}
387 %\kbd{TAB}, \kbd{RET} and \kbd{C-c C-c} trigger automatic recalculation
388 %in lines starting with: {\tt | \# |}.
390 \key{rotate calculation mark through \# * ! \^ \_ \$}{C-\#}
392 \key{display column number cursor is in}{C-c ?}
393 \key{sum numbers in current column/rectangle}{C-c +}
394 \key{copy down with increment}{S-RET$^3$}
396 Formulas typed in field are executed by \kbd{TAB},
397 \kbd{RET} and \kbd{C-c C-c}. \kbd{=} introduces a column
398 formula, \kbd{:=} a named-field formula.
400 \key{Example: Add Col1 and Col2}{=\$1+\$2}
401 \key{... with printf format specification}{=\$1+\$2;\%.2f}
402 \key{... with constants from constants.el}{=\$1/\$c/\$cm}
403 \key{sum from 3rd hline above to here}{:=vsum(\&III)}
404 \key{apply current column formula}{=}
406 {\bf Miscellaneous}
408 \key{to limit column width to \kbd{N} characters, use}{...| <N> |...}
409 \key{edit the current field in a separate window}{C-c `}
410 \key{make current field fully visible}{C-u TAB}
411 \metax{export as tab-separated file}{M-x org-table-export}
412 \metax{import tab-separated file}{M-x org-table-import}
414 {\bf Tables created with the \kbd{table.el} package}
416 \key{insert a new \kbd{table.el} table}{C-c ~}
417 \key{recognize existing table.el table}{C-c C-c}
418 \key{convert table (Org-mode $\leftrightarrow$ table.el)}{C-c ~}
420 \section{Links}
422 \key{globally store link to the current location}{C-c l$^1$}
423 \key{insert a link (TAB completes stored links)}{C-c C-l}
424 \key{insert file link with file name completion}{C-u C-c C-l}
425 \key{edit (also hidden part of) link at point}{C-c C-l}
427 \key{open file links in emacs}{C-c C-o}
428 \key{...force open in emacs/other window}{C-u C-c C-o}
429 \key{open link at point}{mouse-1/2}
430 \key{...force open in emacs/other window}{mouse-3}
431 \key{record a position in mark ring}{C-c \%}
432 \key{jump back to last followed link(s)}{C-c \&}
434 {\bf Internal Links}
436 \key{\kbd{<<My Target>>}}{\rm target}
437 \key{\kbd{<<<My Target>>>}}{\rm radio target$^2$}
438 \key{\kbd{[[*this text]]}}{\rm find headline}
439 \metax{\kbd{[[this text]]}}{\rm find target or text in buffer}
440 \metax{\kbd{[[this text][description]]}}{\rm optional link text}
442 {\bf External Links}
444 \key{\kbd{file:/home/dominik/img/mars.jpg}}{\rm file, absolute}
445 \key{\kbd{file:papers/last.pdf}}{\rm file, relative}
446 \key{\kbd{file:projects.org::*that text}}{\rm find headline}
447 \key{\kbd{file:projects.org::find me}}{\rm find trgt/string}
448 %\key{\kbd{file:projects.org::/regexp/}}{\rm regexp search}
449 \key{\kbd{http://www.astro.uva.nl/~dominik}}{\rm on the web}
450 \key{\kbd{mailto:adent@galaxy.net}}{\rm Email address}
451 \key{\kbd{news:comp.emacs}}{\rm Usenet group}
452 \key{\kbd{bbdb:Richard Stallman}}{\rm BBDB person}
453 \key{\kbd{gnus:group}}{\rm GNUS group}
454 \key{\kbd{gnus:group\#id}}{\rm GNUS message}
455 \key{\kbd{vm|wl|mhe|rmail:folder}}{\rm Mail folder}
456 \key{\kbd{vm|wl|mhe|rmail:folder\#id}}{\rm Mail message}
457 \key{\kbd{info:emacs:Regexps}}{\rm Info file:node}
458 \key{\kbd{shell:ls *.org}}{\rm shell command}
459 \key{\kbd{elisp:(calendar)}}{\rm elisp form}
460 \metax{\kbd{[[external link][description]]}}{\rm optional link text}
461 %\key{\kbd{vm://myself@some.where.org/folder\#id}}{\rm VM remote}
464 \section{Remember-mode Integration}
466 See the manual for how to make remember.el use Org-mode links and
467 files. The note-finishing command \kbd{C-c C-c} will first prompt for
468 an org file. In the file, find a location with:
470 \key{rotate subtree visibility}{TAB}
471 \key{next heading}{DOWN}
472 \key{previous heading}{UP}
474 Insert the note with one of the following:
476 \key{as sublevel of heading at cursor}{RET}
477 \key{right here (cursor not on heading)}{RET}
478 \key{before current heading}{LEFT}
479 \key{after current heading}{RIGHT}
480 \key{shortcut to end of buffer (cursor at buf-start)}{RET}
481 \key{Abort}{q}
483 \section{Completion}
485 In-buffer completion completes TODO keywords at headline start, TeX
486 macros after ``{\tt \\}'', option keywords after ``{\tt \#-}'', TAGS
487 after ``{\tt :}'', and dictionary words elsewhere.
489 \key{Complete word at point}{M-TAB}
492 \newcolumn
493 \title{Org-Mode Reference Card (2/2)}
495 \centerline{(for version \orgversionnumber)}
497 \section{TODO Items and Checkboxes}
499 \key{rotate the state of the current item}{C-c C-t}
500 \key{view TODO items in a sparse tree}{C-c C-v}
501 \key{view 3rd TODO keyword's sparse tree}{C-3 C-c C-v}
503 \key{set the priority of the current item}{C-c , [ABC]}
504 \key{remove priority cookie from current item}{C-c , SPC}
505 \key{raise priority of current item}{S-UP$^3$}
506 \key{lower priority of current item}{S-DOWN$^3$}
508 \key{\kbd{\#+SEQ_TODO: TODO TRY BLUFF DONE}}{\rm todo workflow}
509 \key{\kbd{\#+TYP_TODO: Phil home work DONE}}{\rm todo types}
511 \key{insert new checkbox item in plain list}{M-S-RET}
512 \key{toggle checkbox(es) in region/entry/at point}{C-c C-x C-b}
513 \key{toggle checkbox at point}{C-c C-c}
514 \metax{checkbox statistics cookies: insert {\tt [/]} or {\tt [\%]}}{}
515 \key{update checkbox statistics (\kbd{C-u} : whole file)}{C-c \#}
517 \section{Tags}
519 \key{set tags for current heading}{C-c C-c}
520 \key{realign tags in all headings}{C-u C-c C-c}
521 \key{create sparse tree with matching tags}{C-c \\}
522 \key{globally (agenda) match tags at cursor}{C-c C-o}
524 \section{Timestamps}
526 \key{prompt for date and insert timestamp}{C-c .}
527 \key{like \kbd{C-c} . but insert date and time format}{C-u C-c .}
528 \key{Like \kbd{C-c .} but make stamp inactive}{C-c !} % FIXME
529 \key{insert DEADLINE timestamp}{C-c C-d}
530 \key{insert SCHEDULED timestamp}{C-c C-s}
531 \key{create sparse tree with all deadlines due}{C-c C-w}
532 \key{the time between 2 dates in a time range}{C-c C-y}
533 \key{change timestamp at cursor by $\pm 1$ day}{S-RIGHT/LEFT$^3$}
534 \key{change year/month/day at cursor by $\pm 1$}{S-UP/DOWN$^3$}
535 \key{access the calendar for the current date}{C-c >}
536 \key{insert timestamp matching date in calendar}{C-c <}
537 \key{access agenda for current date}{C-c C-o}
538 \key{Select date while prompted}{mouse-1/RET}
539 %\key{... select date in calendar}{mouse-1/RET}
540 %\key{... scroll calendar back/forward one month}{< / >}
541 %\key{... forward/backward one day}{S-LEFT/RIGHT}
542 %\key{... forward/backward one week}{S-UP/DOWN}
543 %\key{... forward/backward one month}{M-S-LEFT/RIGT}
544 \key{Toggle custom format display for dates/times}{C-c C-x C-t}
547 \section{Clocking Time}
549 \key{start clock on current item}{C-c C-x C-i}
550 \key{stop clock on current item}{C-c C-x C-o}
551 \key{cancel current clock}{C-c C-x C-x}
553 \key{display total subtree times}{C-c C-x C-d}
554 \key{remove displayed times}{C-c C-c}
555 \key{insert/update table with clock report}{C-c C-x C-r}
557 \section{LaTeX and cdlatex-mode}
559 \key{preview LaTeX fragment}{C-c C-x C-l}
560 \key{Expand abbreviation (cdlatex-mode)}{TAB}
561 \key{Insert/modify math symbol (cdlatex-mode)}{` / '}
563 \section{Agenda Views}
565 \key{add/move current file to front of agenda}{C-c [}
566 \key{remove current file from your agenda}{C-c ]}
567 \key{cycle through agenda file list}{C-,}
569 \key{compile agenda for the current week}{C-c a a$^1$}
570 \key{compile global TODO list}{C-c a t$^1$}
571 \key{compile TODO list for specific keyword}{C-c a T$^1$}
572 \key{match tags in agenda files}{C-c a m$^1$}
573 \key{match tags in TODO entries}{C-c a M$^1$}
574 \key{show timeline of current org file}{C-c a L$^1$}
575 \key{configure custom commands}{C-c a C$^1$}
576 \key{agenda for date at cursor}{C-c C-o}
578 \vskip 1mm
579 To set categories, add lines like$^2$:
580 \vskip -1mm
581 \beginexample%
582 \#+CATEGORY: MyCateg
583 \endexample
585 {\bf Commands available in an agenda buffer}
587 {\bf View Org file}
589 \key{show original location of item}{SPC}
590 \key{... also available with}{mouse-3}
591 \key{show and recenter window}{L}
592 \key{goto original location in other window}{TAB}
593 \key{... also available with}{mouse-2}
594 \key{goto original location, delete other windows}{RET}
595 \key{toggle follow-mode}{f}
597 {\bf Change display}
599 \key{delete other windows}{o}
600 \key{switch to daily / weekly view}{d / w}
601 \key{toggle inclusion of diary entries}{D}
602 \key{toggle time grid for daily schedule}{g}
603 \key{toggle display of logbook entries}{l}
604 \key{refresh agenda buffer with any changes}{r}
605 \key{save all org-mode buffers}{s}
606 \key{display the following \kbd{org-agenda-ndays}}{RIGHT}
607 \key{display the previous \kbd{org-agenda-ndays}}{LEFT}
608 \key{goto today}{.}
610 {\bf Remote editing}
612 \key{digit argument}{0-9}
613 \key{change state of current TODO item}{t}
614 \key{show tags of current headline}{T}
615 \key{set tags for current headline}{:}
616 \key{toggle ARCHIVE tag}{a}
617 \key{set priority of current item}{p}
618 \key{raise/lower priority of current item}{S-UP/DOWN$^3$}
619 \key{display weighted priority of current item}{P}
620 \key{schedule/set deadline for this item}{C-c C-s/d}
621 \key{change timestamp to one day earlier/later}{S-LEFT/RIGHT$^3$}
622 \key{change timestamp to today}{>}
623 \key{insert new entry into diary}{i}
625 \key{Start the clock on current item (clock-in)}{I}
626 \key{Stop the clock (clock-out)}{O}
627 \key{Cancel current clock}{X}
630 {\bf Calendar commands}
632 \key{find agenda cursor date in calendar}{c}
633 \key{compute agenda for calendar cursor date}{c}
634 \key{show phases of the moon}{M}
635 \key{show sunrise/sunset times}{S}
636 \key{show holidays}{H}
637 \key{convert date to other calendars}{C}
639 {\bf Quit and Exit}
641 \key{quit agenda, remove agenda buffer}{q}
642 \key{exit agenda, remove all agenda buffers}{x}
644 \section{Calendar and Diary Integration}
646 Include Emacs diary entries into Org-mode agenda with:
647 \beginexample%
648 (setq org-agenda-include-diary t)
649 \endexample
651 \section{Exporting and Publishing}
653 Exporting creates files with extensions {\it .txt\/} and {\it .html\/}
654 in the current directory. Publishing puts the resulting file into
655 some other place.
657 \key{export/publish dispatcher}{C-c C-e}
659 \key{export visible part only}{C-c C-e v}
660 \key{insert template of export options}{C-c C-x t}
661 \key{toggle fixed width for entry or region}{C-c :}
663 {\bf HTML formatting}
665 \key{make words {\bf bold}}{*bold*}
666 \key{make words {\it italic}}{/italic/}
667 \key{make words \underbar{underlined}}{_underlined_}
668 \key{sub- and superscripts}{x\^{}3, J_dust}
669 \key{\TeX{}-like macros}{\\alpha, \\to}
670 \key{typeset lines in fixed width font}{start with :}
671 \key{tables are exported as HTML tables}{start with |}
672 \key{links become HTML links}{http:... etc}
673 \key{include html tags}{@<b>...@</b>}
675 {\bf Export options}
677 Include additional information for export by putting these anywhere in the
678 org file. Use {\tt M-TAB} completion to make sure to get the right
679 keywords. {\tt M-TAB} again just after keyword is complete inserts examples.
681 \key{the title to be shown}{\#+TITLE:}
682 \key{the author}{\#+AUTHOR:}
683 \key{authors email address}{\#+EMAIL:}
684 \key{language code for html}{\#+LANGUAGE:}
685 \key{free text description of file}{\#+TEXT:}
686 \key{... which can carry over multiple lines}{\#+TEXT:}
687 %\key{settings for the export process - see below}{\#+OPTIONS:}
688 \key{settings for the export process}{\#+OPTIONS:}
690 %\key{set number of headline levels for export}{H:2}
691 %\key{turn on/off section numbers}{num:t}
692 %\key{turn on/off table of contents}{toc:t}
693 %\key{turn on/off linebreak preservation}{\\n:nil}
694 %\key{turn on/off quoted html tags}{@:t}
695 %\key{turn on/off fixed width sections}{::t}
696 %\key{turn on/off tables}{|:t}
697 %\key{turn on/off \TeX\ syntax for sub/super-scripts}{\^{}:t}
698 %\key{turn on/off emphasised text}{*:nil}
699 %\key{turn on/off \TeX\ macros}{TeX:t}
701 {\bf Comments: Text not being exported}
703 Text before the first headline is not considered part of the document
704 and is therefore never exported.
705 Lines starting with \kbd{\#} are comments and are not exported.
706 Subtrees whose header starts with COMMENT are never exported.
708 \key{toggle COMMENT keyword on entry}{C-c ;}
711 %\section{CUA and pc-select compatibility}%
713 %Configure the variable {\tt org-CUA-compatibility} to make Org-mode
714 %avoid the \kbd{S-<cursor>} bindings used by these modes. When set,
715 %Org-mode will change the following keybindings (also in the agenda
716 %buffer, but not during date selection). See note mark four$^3$
717 %throughout the reference card.
718 %%\vskip-mm
719 %\beginexample
720 %S-UP $\to$ M-p S-DOWN $\to$ M-n
721 %S-LEFT $\to$ M-- S-RIGHT $\to$ M-+
722 %S-RET $\to$ C-S-RET
723 %\endexample
725 \section{Dynamic Blocks}
727 \key{update dynamic block at point}{C-c C-x C-u}
728 \metax{update all dynamic blocks}{C-u C-c C-x C-u}
730 \section{Notes}
731 $^1$ This is only a suggestion for a binding of this command. Choose
732 you own key as shown under INSTALLATION.
734 $^2$ After changing a \kbd{\#+KEYWORD} or \kbd{<<<target>>>} line,
735 press \kbd{C-c C-c} with the cursor still in the line to update.
737 $^3$ Keybinding affected by {\tt org-CUA-compatibility}.
739 \copyrightnotice
741 \bye
744 % arch-tag: 139f6750-5cfc-49ca-92b5-237fe5795290
746 %%% Local Variables:
747 %%% mode: latex
748 %%% TeX-master: t
749 %%% End: