mirror of
https://git.savannah.gnu.org/git/emacs/org-mode.git
synced 2024-08-23 18:19:20 +00:00
Cleanup
This commit is contained in:
parent
eef47f820f
commit
1ecc1a6233
|
@ -1,231 +0,0 @@
|
|||
|
||||
#+STARTUP: overview align
|
||||
#+TYP_TODO: TODO IDEA WISH QUESTION DECLINED INCONSISTENCY BUG DONE
|
||||
#+OPTIONS: H:2 num:t toc:t \n:nil @:t ::t |:t ^:t *:t TeX:t
|
||||
#+EMAIL: carsten.dominik@gmail.com
|
||||
#+TITLE: Org-mode Frequently Asked Questions
|
||||
|
||||
* General
|
||||
** Use features in other modes
|
||||
*I would like to use editing features of org-mode in other modes, is this possible?*
|
||||
|
||||
Not really. For tables there is =orgtbl-mode= which implements the
|
||||
table editor as a minor mode. For other features you need to switch to
|
||||
Org-mode temporarily, or prepare text in a different buffer.
|
||||
|
||||
|
||||
** Visibility cycling in Outline-mode and Outline-minor-mode
|
||||
|
||||
%Can I get the visibility-cycling features in outline-mode and
|
||||
outline-minor-mode?%
|
||||
|
||||
Yes, these functions are written in a way that they are independent of
|
||||
the outline setup. The following setup provides standard Org-mode
|
||||
functionality in outline-mode on =TAB= and =S-TAB=. For
|
||||
outline-minor-mode, we use =C-TAB= instead of =TAB=,
|
||||
because =TAB= usually has mode-specific tasks.
|
||||
|
||||
:(add-hook 'outline-minor-mode-hook
|
||||
: (lambda ()
|
||||
: (define-key outline-minor-mode-map [(control tab)] 'org-cycle)
|
||||
: (define-key outline-minor-mode-map [(shift tab)] 'org-global-cycle)))
|
||||
:(add-hook 'outline-mode-hook
|
||||
: (lambda ()
|
||||
: (define-key outline-mode-map [(tab)] 'org-cycle)
|
||||
: (define-key outline-mode-map [(shift tab)] 'org-global-cycle)))
|
||||
|
||||
Or check out /outline-magic.el/, which does this and also provides
|
||||
promotion and demotion functionality. @file{outline-magic.el} is
|
||||
available at [[http://www.astro.uva.nl/~dominik/Tools/OutlineMagic][Outline Magic]].
|
||||
|
||||
* Errors
|
||||
** =(wrong-type-argument keymapp nil)=
|
||||
When I try to use Org-mode, I always get the error message
|
||||
@code{(wrong-type-argument keymapp nil)} This is a conflict with an
|
||||
outdated version of the /allout.el/.
|
||||
|
||||
** CUA mode does not work with Org-mode
|
||||
|
||||
%Org-mode takes over the S-cursor keys. I also want to use CUA-mode,
|
||||
is there a way to fix this conflict?%
|
||||
|
||||
Yes, see the /Conflicts/ section of the manual.
|
||||
|
||||
* Setup and Structure
|
||||
** Org-mode as default mode
|
||||
|
||||
%Org-mode seems to be a useful default mode for the various README
|
||||
files I have scattered through my directories%. %How do I turn it on
|
||||
for all README files?%
|
||||
|
||||
Add the following to your .emacs file:
|
||||
|
||||
: (add-to-list 'auto-mode-alist '("README$" . org-mode))
|
||||
|
||||
|
||||
** Get rid of extra stars in outline
|
||||
|
||||
%All these stars are driving me mad, I just find the Emacs outlines
|
||||
unreadable. Can't you just put white space and a single star as a
|
||||
starter for headlines?%
|
||||
|
||||
See the section /Clean outline view/ in the manual.
|
||||
|
||||
** Two windows on same Org-mode file
|
||||
%I would like to have two windows on the same Org-mode file, but with
|
||||
different outline visibility. Is that possible?%
|
||||
|
||||
In GNU Emacs, you may use /indirect buffers/ which do exactly this.
|
||||
See the documentation on the command =make-indirect-buffer=. In
|
||||
XEmacs, this is currently not possible because of the different outline
|
||||
implementation.
|
||||
|
||||
* Hyperlinks
|
||||
** Broken links after Org-mode 4.20
|
||||
|
||||
%Some of my links stopped working after I upgraded to a version 4.20
|
||||
or later. Why is this, and how can I fix it?%
|
||||
|
||||
These must be links in plain text, containing white space, such as
|
||||
|
||||
: bbdb:Richard Stallman
|
||||
|
||||
You need to protect these links by putting double brackets around
|
||||
them, like
|
||||
|
||||
: [[bbdb:Richard Stallman]]
|
||||
|
||||
** Converting links to double-bracket format
|
||||
|
||||
%I see that Org-mode now creates links using the double bracket
|
||||
convention that hides the link part and the brackets, only showing the
|
||||
description part. How can I convert my old links to this new format?%
|
||||
|
||||
Execute once in each Org-mode file: =M-x org-upgrade-old-links=
|
||||
This replaces angular brackets with the new link format.
|
||||
|
||||
** Angular bracket links preference
|
||||
|
||||
%I don't care if you find the new bracket links great, I am attached
|
||||
to the old style using angular brackets and no hiding of the link
|
||||
text. Please give them back to me, don't tell me it is not possible!%
|
||||
|
||||
Would I let you down like that? If you must, you can do this
|
||||
|
||||
: (setq org-link-style 'plain
|
||||
: org-link-format "<%s>")
|
||||
|
||||
** Confirmation for shell and elips links
|
||||
%When I am executing shell/elisp links I always get a confirmation
|
||||
prompt and need to type =yes RET=, that's 4 key presses! Can I get
|
||||
rid of this?%
|
||||
|
||||
The confirmation is there to protect you from unwantingly execute
|
||||
potentially dangerous commands. For example, imagine a link
|
||||
:[[shell:rm -rf ~/*][ Google Search]]
|
||||
|
||||
In an Org-mode buffer, this command would look like /Google Search/,
|
||||
but really it would remove your home directory. If you wish, you can
|
||||
make it easier to respond to the query by setting
|
||||
=org-confirm-shell-link-function= and/or
|
||||
=org-confirm-elisp-link-function= to =y-or-n-p=. Then a single yc
|
||||
keypress will be enough to confirm those links. It is also possible
|
||||
to turn off this check entirely, but I do not recommend to do this.
|
||||
Be warned.
|
||||
|
||||
|
||||
|
||||
* Export
|
||||
** Make TODO entries items, not headlines in HTML export
|
||||
|
||||
%When I export my TODO list, every TODO item becomes a separate
|
||||
section. How do I enforce these items to be exported as an itemized
|
||||
list?%
|
||||
|
||||
If you plan to use ASCII or HTML export, make sure things you want to
|
||||
be exported as item lists are level 4 at least, even if that does mean
|
||||
there is a level jump. For example:
|
||||
|
||||
: * Todays top priorities
|
||||
: **** TODO write a letter to xyz
|
||||
: **** TODO Finish the paper
|
||||
: **** Pick up kids at the school
|
||||
|
||||
Alternatively, if you need a specific value for the heading/item
|
||||
transition in a particular file, use the =#+OPTIONS= line to
|
||||
configure the H switch.
|
||||
|
||||
: #+OPTIONS: H:2; ...
|
||||
|
||||
** Export only a subtree
|
||||
|
||||
%I would like to export only a subtree of my file to HTML. How?%
|
||||
|
||||
If you want to export a subtree, mark the subtree as region and then
|
||||
export. Marking can be done with =C-c @@ C-x C-x=, for example.
|
||||
|
||||
* Tables
|
||||
** #ERROR fields in tables
|
||||
|
||||
%One of my table columns has started to fill up with =#ERROR=. What
|
||||
is going on?%
|
||||
|
||||
Org-mode tried to compute the column from other fields using a
|
||||
formula stored in the =#+TBLFM:= line just below the table, and
|
||||
the evaluation of the formula fails. Fix the fields used in the
|
||||
formula, or fix the formula, or remove it!
|
||||
|
||||
** Unwanted new lines in table
|
||||
|
||||
%When I am in the last column of a table and just above a horizontal
|
||||
line in the table, pressing TAB creates a new table line before the
|
||||
horizontal line%. %How can I quickly move to the line below the
|
||||
horizontal line instead?%
|
||||
|
||||
Press =down= (to get on the separator line) and then =TAB=
|
||||
Or configure the variable =org-table-tab-jumps-over-hlines=.
|
||||
|
||||
** Change indentation of a table
|
||||
%How can I change the indentation of an entire table without fixing
|
||||
every line by hand?%
|
||||
|
||||
The indentation of a table is set by the first line. So just fix the
|
||||
indentation of the first line and realign with =TAB=.
|
||||
|
||||
* Agenda
|
||||
** Include Org-mode agenda into Emacs diary
|
||||
%Is it possible to include entries from org-mode files into my emacs
|
||||
diary?%
|
||||
|
||||
Since the org-mode agenda is much more powerful and can contain the
|
||||
diary, you should think twice
|
||||
before deciding to do this. Integrating Org-mode information into the
|
||||
diary is, however, possible. You need to turn on /fancy diary
|
||||
display/ by setting in .emacs:
|
||||
|
||||
: (add-hook 'diary-display-hook 'fancy-diary-display)
|
||||
|
||||
Then include the following line into your ~/diary file, in
|
||||
order to get the entries from all files listed in the variable
|
||||
=org-agenda-files=
|
||||
|
||||
: &%%(org-diary)
|
||||
You may also select specific files with
|
||||
|
||||
: &%%(org-diary) ~/path/to/some/org-file.org
|
||||
: &%%(org-diary) ~/path/to/another/org-file.org
|
||||
|
||||
If you now launch the calendar and press d to display a diary, the
|
||||
headlines of entries containing a timestamp, date range, schedule, or
|
||||
deadline referring to the selected date will be listed. Just like
|
||||
Org-mode's agenda view, the diary for @emph{today} contains additional
|
||||
entries for overdue deadlines and scheduled items. See also the
|
||||
documentation of the @command{org-diary} function. Under XEmacs, it is
|
||||
not possible to jump back from the diary to the org, this works only in
|
||||
the agenda buffer.
|
||||
|
||||
* COMMENT HTML style specifications
|
||||
|
||||
# Local Variables:
|
||||
# org-export-html-style: "<link rel=stylesheet href=\"freeshell2.css\" type=\"text/css\"> <style type=\"text/css\"> .tag { color: red; font-weight:bold}</style>"
|
||||
# End:
|
Loading…
Reference in a new issue