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