Commit | Line | Data |
---|---|---|
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 | ||
75 | Permission is granted to make and distribute copies of | |
76 | this card provided the copyright notice and this permission notice | |
77 | are 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 | % | |
273 | Put 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 \$} | |
323 | To 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 | |
349 | per-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 | |
355 | per-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} | |
410 | Wanderlust \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 | ||
431 | The following commands work when the cursor is {\it inside a table}. | |
432 | Outside 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 | 465 | These 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 | |
474 | in 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 |
482 | A formula can also be typed directly into into a field and will |
483 | executed by \kbd{TAB}, \kbd{RET} and \kbd{C-c C-c}. A leading \kbd{=} | |
484 | introduces 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 | |
520 | To 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 | ||
528 | The 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 | ||
584 | Exporting creates files with extensions {\it .txt\/} and {\it .html\/} | |
585 | in 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 | ||
615 | Include additional information for export by putting these anywhere in the | |
616 | org file. Use {\tt M-TAB} completion to make sure to get the right | |
617 | keywords. {\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 | ||
642 | Text before the first headline is not considered part of the document | |
643 | and is therefore never exported. | |
644 | Lines starting with \kbd{\#} are comments and are not exported. | |
645 | Subtrees whose header starts with COMMENT are never exported. | |
646 | ||
647 | \key{toggle COMMENT keyword on entry}{C-c ;} | |
648 | ||
649 | \section{Completion} | |
650 | ||
651 | In-buffer completion completes TODO keywords at headline start, TeX | |
fb1556f0 CD |
652 | macros after ``{\tt \\}'', option keywords after ``{\tt \#-}'', and |
653 | dictionary words elsewhere. | |
fad0a150 CD |
654 | |
655 | \key{Complete word at point}{M-TAB} | |
656 | ||
657 | \newcolumn | |
658 | ||
659 | \section{Calendar and Diary Integration} | |
660 | ||
661 | To include entries from the Emacs diary in your Org-mode agenda: | |
662 | \beginexample% | |
663 | (setq org-agenda-include-diary t) | |
664 | \endexample | |
665 | ||
666 | To include your Org-mode agenda in your normal diary, make sure you're | |
667 | using the fancy diary display | |
668 | % | |
669 | %\beginexample% | |
670 | %(add-hook 'diary-display-hook 'fancy-diary-display) | |
671 | %\endexample | |
672 | % | |
673 | and in your \kbd{~/diary} file add | |
674 | ||
675 | \beginexample% | |
676 | \&\%\%(org-diary) | |
677 | \endexample | |
678 | ||
679 | to include all the files listed in \kbd{org-agenda-files}. For more | |
680 | selective 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 | ||
688 | See the manual for how to make remember.el use Org-mode links and | |
689 | files. The note-finishing command \kbd{C-c C-c} will first prompt for | |
690 | an 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 | ||
696 | Insert 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 | ||
707 | Configure the variable {\tt org-CUA-compatibility} to make Org-mode | |
708 | avoid the \kbd{S-<cursor>} bindings used by these modes. When set, | |
709 | Org-mode will change the following keybindings (also in the agenda | |
710 | buffer, but not during date selection). See note mark four$^4$ | |
711 | throughout the reference card. | |
712 | %\vskip-mm | |
713 | \beginexample | |
714 | S-UP $\to$ M-p S-DOWN $\to$ M-n | |
715 | S-LEFT $\to$ M-- S-RIGHT $\to$ M-+ | |
716 | S-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 | |
721 | Emacs, or an XEmacs package. | |
722 | ||
723 | $^2$ This is only a suggestion for a binding of this command. Choose | |
724 | you own key as shown under INSTALLATION. | |
725 | ||
726 | $^3$ After changing a \kbd{\#+KEYWORD} line, press \kbd{C-c C-c} with | |
727 | the 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: |