mirror of
https://git.savannah.gnu.org/git/emacs/org-mode.git
synced 2024-11-28 07:44:49 +00:00
Merge branch 'maint'
This commit is contained in:
Nicolas Goaziou
commit
31d2f48f69
@ -7549,9 +7549,12 @@ Now lets look at the elements of a template definition. Each entry in
|
||||
The template for creating the capture item. If you leave this
|
||||
empty, an appropriate default template will be used. Otherwise this
|
||||
is a string with escape codes, which will be replaced depending on
|
||||
time and context of the capture call. The string with escapes may
|
||||
be loaded from a template file, using the special syntax =(file
|
||||
"template filename")=. See below for more details.
|
||||
time and context of the capture call. You may also get this
|
||||
template string from a file[fn:85], or dynamically, from a function
|
||||
using either syntax:
|
||||
|
||||
: (file "/path/to/template-file")
|
||||
: (function FUNCTION-RETURNING-THE-TEMPLATE)
|
||||
|
||||
- properties ::
|
||||
|
||||
@ -7632,7 +7635,7 @@ Now lets look at the elements of a template definition. Each entry in
|
||||
:DESCRIPTION: Filling in information about time and context.
|
||||
:END:
|
||||
|
||||
In the template itself, special "%-escapes"[fn:85] allow dynamic
|
||||
In the template itself, special "%-escapes"[fn:86] allow dynamic
|
||||
insertion of content. The templates are expanded in the order given
|
||||
here:
|
||||
|
||||
@ -7759,7 +7762,7 @@ here:
|
||||
After completing the template, position point here.
|
||||
|
||||
#+vindex: org-store-link-props
|
||||
For specific link types, the following keywords are defined[fn:86]:
|
||||
For specific link types, the following keywords are defined[fn:87]:
|
||||
|
||||
#+vindex: org-link-from-user-regexp
|
||||
| Link type | Available keywords |
|
||||
@ -7772,7 +7775,7 @@ For specific link types, the following keywords are defined[fn:86]:
|
||||
| | =%:date= (message date header field) |
|
||||
| | =%:date-timestamp= (date as active timestamp) |
|
||||
| | =%:date-timestamp-inactive= (date as inactive timestamp) |
|
||||
| | =%:fromto= (either "to NAME" or "from NAME")[fn:87] |
|
||||
| | =%:fromto= (either "to NAME" or "from NAME")[fn:88] |
|
||||
| gnus | =%:group=, for messages also all email fields |
|
||||
| w3, w3m | =%:url= |
|
||||
| info | =%:file=, =%:node= |
|
||||
@ -7830,7 +7833,7 @@ By default, org-attach will use ID properties when adding attachments
|
||||
to outline nodes. This makes working with attachments fully
|
||||
automated. There is no decision needed for folder-name or location.
|
||||
ID-based directories are by default located in the =data/= directory,
|
||||
which lives in the same directory where your Org file lives[fn:88].
|
||||
which lives in the same directory where your Org file lives[fn:89].
|
||||
For more control over the setup, see [[*Attachment options]].
|
||||
|
||||
When attachments are made using ~org-attach~ a default tag =ATTACH= is
|
||||
@ -8209,12 +8212,12 @@ the window configuration is restored when the agenda exits:
|
||||
|
||||
#+vindex: org-agenda-files
|
||||
The information to be shown is normally collected from all /agenda
|
||||
files/, the files listed in the variable ~org-agenda-files~[fn:89].
|
||||
files/, the files listed in the variable ~org-agenda-files~[fn:90].
|
||||
If a directory is part of this list, all files with the extension
|
||||
=.org= in this directory are part of the list.
|
||||
|
||||
Thus, even if you only work with a single Org file, that file should
|
||||
be put into the list[fn:90]. You can customize ~org-agenda-files~,
|
||||
be put into the list[fn:91]. You can customize ~org-agenda-files~,
|
||||
but the easiest way to maintain it is through the following commands
|
||||
|
||||
#+attr_texinfo: :sep and
|
||||
@ -8347,7 +8350,7 @@ commands:
|
||||
- {{{kbd(<)}}} ::
|
||||
|
||||
#+kindex: < @r{(Agenda dispatcher)}
|
||||
Restrict an agenda command to the current buffer[fn:91]. If
|
||||
Restrict an agenda command to the current buffer[fn:92]. If
|
||||
narrowing is in effect restrict to the narrowed part of the buffer.
|
||||
After pressing {{{kbd(<)}}}, you still need to press the character
|
||||
selecting the command.
|
||||
@ -8357,7 +8360,7 @@ commands:
|
||||
#+kindex: < < @r{(Agenda dispatcher)}
|
||||
If there is an active region, restrict the following agenda command
|
||||
to the region. Otherwise, restrict it to the current
|
||||
subtree[fn:92]. After pressing {{{kbd(< <)}}}, you still need to
|
||||
subtree[fn:93]. After pressing {{{kbd(< <)}}}, you still need to
|
||||
press the character selecting the command.
|
||||
|
||||
- {{{kbd(*)}}} ::
|
||||
@ -8407,7 +8410,7 @@ a paper agenda, showing all the tasks for the current week or day.
|
||||
#+cindex: org-agenda, command
|
||||
Compile an agenda for the current week from a list of Org files.
|
||||
The agenda shows the entries for each day. With a numeric prefix
|
||||
argument[fn:93]---like {{{kbd(C-u 2 1 M-x org-agenda a)}}}---you may
|
||||
argument[fn:94]---like {{{kbd(C-u 2 1 M-x org-agenda a)}}}---you may
|
||||
set the number of days to be displayed.
|
||||
|
||||
#+vindex: org-agenda-span
|
||||
@ -8466,7 +8469,7 @@ move the entries into an Org file. Org mode evaluates diary-style
|
||||
expression entries, and does it faster because there is no overhead
|
||||
for first creating the diary display. Note that the expression
|
||||
entries must start at the left margin, no whitespace is allowed before
|
||||
them, as seen in the following segment of an Org file:[fn:94]
|
||||
them, as seen in the following segment of an Org file:[fn:95]
|
||||
|
||||
#+begin_example
|
||||
,* Holidays
|
||||
@ -8968,7 +8971,7 @@ Time ranges can be specified with two timestamps:
|
||||
|
||||
#+vindex: org-agenda-search-headline-for-time
|
||||
In the headline of the entry itself, a time(range)---like =12:45= or
|
||||
a =8:30-1pm=---may also appear as plain text[fn:95].
|
||||
a =8:30-1pm=---may also appear as plain text[fn:96].
|
||||
|
||||
If the agenda integrates the Emacs diary (see [[*Weekly/daily agenda]]),
|
||||
time specifications in diary entries are recognized as well.
|
||||
@ -9058,7 +9061,7 @@ filters and limits allow to flexibly narrow down the list of agenda
|
||||
entries.
|
||||
|
||||
/Filters/ only change the visibility of items, are very fast and are
|
||||
mostly used interactively[fn:96]. You can switch quickly between
|
||||
mostly used interactively[fn:97]. You can switch quickly between
|
||||
different filters without having to recreate the agenda. /Limits/ on
|
||||
the other hand take effect before the agenda buffer is populated, so
|
||||
they are mostly useful when defined as local variables within custom
|
||||
@ -9523,7 +9526,7 @@ the other commands, point needs to be in the desired line.
|
||||
variable ~org-agenda-start-with-clockreport-mode~. By using
|
||||
a prefix argument when toggling this mode (i.e., {{{kbd(C-u R)}}}),
|
||||
the clock table does not show contributions from entries that are
|
||||
hidden by agenda filtering[fn:97]. See also the variable
|
||||
hidden by agenda filtering[fn:98]. See also the variable
|
||||
~org-clock-report-include-clocking-task~.
|
||||
|
||||
- {{{kbd(v c)}}} ::
|
||||
@ -9962,7 +9965,7 @@ the other commands, point needs to be in the desired line.
|
||||
- {{{kbd(f)}}} ::
|
||||
|
||||
#+vindex: org-agenda-bulk-custom-functions
|
||||
Apply a function[fn:98] to marked entries. For example, the
|
||||
Apply a function[fn:99] to marked entries. For example, the
|
||||
function below sets the =CATEGORY= property of the entries to
|
||||
=web=.
|
||||
|
||||
@ -10002,7 +10005,7 @@ the other commands, point needs to be in the desired line.
|
||||
#+cindex: diary entries, creating from agenda
|
||||
Insert a new entry into the diary, using the date at point and (for
|
||||
block entries) the date at the mark. This adds to the Emacs diary
|
||||
file[fn:99], in a way similar to the {{{kbd(i)}}} command in the
|
||||
file[fn:100], in a way similar to the {{{kbd(i)}}} command in the
|
||||
calendar. The diary file pops up in another window, where you can
|
||||
add the entry.
|
||||
|
||||
@ -10128,13 +10131,13 @@ after the dispatcher command in order to access the command. Usually
|
||||
this is just a single character, but if you have many similar
|
||||
commands, you can also define two-letter combinations where the first
|
||||
character is the same in several combinations and serves as a prefix
|
||||
key[fn:100]. The second parameter is the search type, followed by the
|
||||
key[fn:101]. The second parameter is the search type, followed by the
|
||||
string or regular expression to be used for the matching. The example
|
||||
above will therefore define:
|
||||
|
||||
- {{{kbd(x)}}} ::
|
||||
|
||||
as a global search for agenda entries planned[fn:101] this week/day.
|
||||
as a global search for agenda entries planned[fn:102] this week/day.
|
||||
|
||||
- {{{kbd(y)}}} ::
|
||||
|
||||
@ -10314,8 +10317,8 @@ See the docstring of the variable for more information.
|
||||
|
||||
If you are away from your computer, it can be very useful to have
|
||||
a printed version of some agenda views to carry around. Org mode can
|
||||
export custom agenda views as plain text, HTML[fn:102], Postscript,
|
||||
PDF[fn:103], and iCalendar files. If you want to do this only
|
||||
export custom agenda views as plain text, HTML[fn:103], Postscript,
|
||||
PDF[fn:104], and iCalendar files. If you want to do this only
|
||||
occasionally, use the following command:
|
||||
|
||||
- {{{kbd(C-x C-w)}}} (~org-agenda-write~) ::
|
||||
@ -10329,7 +10332,7 @@ occasionally, use the following command:
|
||||
|
||||
If you need to export certain agenda views frequently, you can
|
||||
associate any custom agenda command with a list of output file
|
||||
names[fn:104]. Here is an example that first defines custom commands
|
||||
names[fn:105]. Here is an example that first defines custom commands
|
||||
for the agenda and the global TODO list, together with a number of
|
||||
files to which to export them. Then we define two block agenda
|
||||
commands and specify file names for them as well. File names can be
|
||||
@ -10417,7 +10420,7 @@ emacs -eval (org-batch-store-agenda-views) -kill
|
||||
#+end_src
|
||||
|
||||
#+texinfo: @noindent
|
||||
or, if you need to modify some parameters[fn:105]
|
||||
or, if you need to modify some parameters[fn:106]
|
||||
|
||||
#+begin_src shell
|
||||
emacs -eval '(org-batch-store-agenda-views \
|
||||
@ -10661,7 +10664,7 @@ becomes = = in HTML and =~= in LaTeX.
|
||||
|
||||
#+cindex: special symbols, in-buffer display
|
||||
If you would like to see entities displayed as UTF-8 characters, use
|
||||
the following command[fn:106]:
|
||||
the following command[fn:107]:
|
||||
|
||||
- {{{kbd(C-c C-x \)}}} (~org-toggle-pretty-entities~) ::
|
||||
#+kindex: C-c C-x \
|
||||
@ -10675,7 +10678,7 @@ the following command[fn:106]:
|
||||
#+cindex: dash, special symbol
|
||||
#+cindex: ellipsis, special symbol
|
||||
In addition to regular entities defined above, Org exports in
|
||||
a special way[fn:107] the following commonly used character
|
||||
a special way[fn:108] the following commonly used character
|
||||
combinations: =\-= is treated as a shy hyphen, =--= and =---= are
|
||||
converted into dashes, and =...= becomes a compact set of dots.
|
||||
|
||||
@ -10688,7 +10691,7 @@ converted into dashes, and =...= becomes a compact set of dots.
|
||||
|
||||
Plain ASCII is normally sufficient for almost all note taking.
|
||||
Exceptions include scientific notes, which often require mathematical
|
||||
symbols and the occasional formula. LaTeX[fn:108] is widely used to
|
||||
symbols and the occasional formula. LaTeX[fn:109] is widely used to
|
||||
typeset scientific documents. Org mode supports embedding LaTeX code
|
||||
into its files, because many academics are used to writing and reading
|
||||
LaTeX source code, and because it can be readily processed to produce
|
||||
@ -10710,7 +10713,7 @@ into images (see [[*Previewing LaTeX fragments]]).
|
||||
LaTeX fragments do not need any special marking at all. The following
|
||||
snippets are identified as LaTeX source code:
|
||||
|
||||
- Environments of any kind[fn:109]. The only requirement is that the
|
||||
- Environments of any kind[fn:110]. The only requirement is that the
|
||||
=\begin= statement appears on a new line, preceded by only
|
||||
whitespace.
|
||||
|
||||
@ -10754,7 +10757,7 @@ lines:
|
||||
|
||||
#+vindex: org-preview-latex-default-process
|
||||
If you have a working LaTeX installation and =dvipng=, =dvisvgm= or
|
||||
=convert= installed[fn:110], LaTeX fragments can be processed to
|
||||
=convert= installed[fn:111], LaTeX fragments can be processed to
|
||||
produce images of the typeset expressions to be used for inclusion
|
||||
while exporting to HTML (see [[*LaTeX fragments]]), or for inline
|
||||
previewing within Org mode.
|
||||
@ -10825,7 +10828,7 @@ more details see the documentation of CDLaTeX mode):
|
||||
#+kindex: TAB
|
||||
|
||||
The {{{kbd(TAB)}}} key expands the template if point is inside
|
||||
a LaTeX fragment[fn:111]. For example, {{{kbd(TAB)}}} expands =fr=
|
||||
a LaTeX fragment[fn:112]. For example, {{{kbd(TAB)}}} expands =fr=
|
||||
to =\frac{}{}= and position point correctly inside the first brace.
|
||||
Another {{{kbd(TAB)}}} gets you into the second brace.
|
||||
|
||||
@ -10908,9 +10911,9 @@ Here is an example
|
||||
#+vindex: org-latex-listings
|
||||
If the example is source code from a programming language, or any
|
||||
other text that can be marked up by Font Lock in Emacs, you can ask
|
||||
for the example to look like the fontified Emacs buffer[fn:112]. This
|
||||
for the example to look like the fontified Emacs buffer[fn:113]. This
|
||||
is done with the code block, where you also need to specify the name
|
||||
of the major mode that should be used to fontify the example[fn:113],
|
||||
of the major mode that should be used to fontify the example[fn:114],
|
||||
see [[*Structure Templates]] for shortcuts to easily insert code blocks.
|
||||
|
||||
#+cindex: @samp{BEGIN_SRC}
|
||||
@ -10951,7 +10954,7 @@ In HTML, hovering the mouse over such a link remote-highlights the
|
||||
corresponding code line, which is kind of cool.
|
||||
|
||||
You can also add a =-r= switch which /removes/ the labels from the
|
||||
source code[fn:114]. With the =-n= switch, links to these references
|
||||
source code[fn:115]. With the =-n= switch, links to these references
|
||||
are labeled by the line numbers from the code listing. Otherwise
|
||||
links use the labels with no parentheses. Here is an example:
|
||||
|
||||
@ -10996,7 +10999,7 @@ a shortcut is provided (see [[*Structure Templates]]).
|
||||
need to exit by pressing {{{kbd(C-c ')}}} again. The edited version
|
||||
then replaces the old version in the Org buffer. Fixed-width
|
||||
regions---where each line starts with a colon followed by
|
||||
a space---are edited using Artist mode[fn:115] to allow creating
|
||||
a space---are edited using Artist mode[fn:116] to allow creating
|
||||
ASCII drawings easily. Using this command in an empty line creates
|
||||
a new fixed-width region.
|
||||
|
||||
@ -11015,7 +11018,7 @@ the end of the current line. Then the label is stored as a link
|
||||
|
||||
#+cindex: inlining images
|
||||
#+cindex: images, markup rules
|
||||
An image is a link to an image file[fn:116] that does not have
|
||||
An image is a link to an image file[fn:117] that does not have
|
||||
a description part, for example
|
||||
|
||||
: ./img/cat.jpg
|
||||
@ -11043,7 +11046,7 @@ command:
|
||||
a prefix argument, also display images that do have a link
|
||||
description. You can ask for inline images to be displayed at
|
||||
startup by configuring the variable
|
||||
~org-startup-with-inline-images~[fn:117].
|
||||
~org-startup-with-inline-images~[fn:118].
|
||||
|
||||
** Captions
|
||||
:PROPERTIES:
|
||||
@ -11135,7 +11138,7 @@ The following command handles footnotes:
|
||||
#+vindex: org-footnote-define-inline
|
||||
#+vindex: org-footnote-section
|
||||
Otherwise, create a new footnote. Depending on the variable
|
||||
~org-footnote-define-inline~[fn:118], the definition is placed right
|
||||
~org-footnote-define-inline~[fn:119], the definition is placed right
|
||||
into the text as part of the reference, or separately into the
|
||||
location determined by the variable ~org-footnote-section~.
|
||||
|
||||
@ -11150,7 +11153,7 @@ The following command handles footnotes:
|
||||
| {{{kbd(d)}}} | Delete the footnote at point, including definition and references. |
|
||||
|
||||
#+vindex: org-footnote-auto-adjust
|
||||
Depending on the variable ~org-footnote-auto-adjust~[fn:119],
|
||||
Depending on the variable ~org-footnote-auto-adjust~[fn:120],
|
||||
renumbering and sorting footnotes can be automatic after each
|
||||
insertion or deletion.
|
||||
|
||||
@ -11340,7 +11343,7 @@ global variables, include:
|
||||
|
||||
#+cindex: @samp{DATE}, keyword
|
||||
#+vindex: org-export-date-timestamp-format
|
||||
A date or a time-stamp[fn:120].
|
||||
A date or a time-stamp[fn:121].
|
||||
|
||||
- =EMAIL= ::
|
||||
|
||||
@ -11355,7 +11358,7 @@ global variables, include:
|
||||
Language to use for translating certain strings
|
||||
(~org-export-default-language~). With =#+LANGUAGE: fr=, for
|
||||
example, Org translates =Table of contents= to the French =Table des
|
||||
matières=[fn:121].
|
||||
matières=[fn:122].
|
||||
|
||||
- =SELECT_TAGS= ::
|
||||
|
||||
@ -11632,7 +11635,7 @@ keyword:
|
||||
#+cindex: excluding entries from table of contents
|
||||
#+cindex: table of contents, exclude entries
|
||||
Org includes both numbered and unnumbered headlines in the table of
|
||||
contents[fn:122]. If you need to exclude an unnumbered headline,
|
||||
contents[fn:123]. If you need to exclude an unnumbered headline,
|
||||
along with all its children, set the =UNNUMBERED= property to =notoc=
|
||||
value.
|
||||
|
||||
@ -11751,7 +11754,7 @@ be omitted to use the obvious defaults.
|
||||
| =#+INCLUDE: "~/.emacs" :lines "10-"= | Include lines from 10 to EOF |
|
||||
|
||||
Inclusions may specify a file-link to extract an object matched by
|
||||
~org-link-search~[fn:123] (see [[*Search Options in File Links]]). The
|
||||
~org-link-search~[fn:124] (see [[*Search Options in File Links]]). The
|
||||
ranges for =:lines= keyword are relative to the requested element.
|
||||
Therefore,
|
||||
|
||||
@ -11791,7 +11794,7 @@ following syntax:
|
||||
: #+MACRO: name replacement text; $1, $2 are arguments
|
||||
|
||||
#+texinfo: @noindent
|
||||
which can be referenced using ={{{name(arg1, arg2)}}}=[fn:124]. For
|
||||
which can be referenced using ={{{name(arg1, arg2)}}}=[fn:125]. For
|
||||
example
|
||||
|
||||
#+begin_example
|
||||
@ -11910,7 +11913,7 @@ are not exported.
|
||||
Finally, a =COMMENT= keyword at the beginning of an entry, but after
|
||||
any other keyword or priority cookie, comments out the entire subtree.
|
||||
In this case, the subtree is not exported and no code block within it
|
||||
is executed either[fn:125]. The command below helps changing the
|
||||
is executed either[fn:126]. The command below helps changing the
|
||||
comment status of a headline.
|
||||
|
||||
- {{{kbd(C-c ;)}}} (~org-toggle-comment~) ::
|
||||
@ -12182,7 +12185,7 @@ should in principle be exportable as a Beamer presentation.
|
||||
|
||||
- Org exports a Beamer frame's objects as block environments. Org can
|
||||
enforce wrapping in special block types when =BEAMER_ENV= property
|
||||
is set[fn:126]. For valid values see
|
||||
is set[fn:127]. For valid values see
|
||||
~org-beamer-environments-default~. To add more values, see
|
||||
~org-beamer-environments-extra~.
|
||||
#+vindex: org-beamer-environments-default
|
||||
@ -12767,7 +12770,7 @@ as-is.
|
||||
#+vindex: org-html-mathjax-options~
|
||||
LaTeX math snippets (see [[*LaTeX fragments]]) can be displayed in two
|
||||
different ways on HTML pages. The default is to use the [[http://www.mathjax.org][MathJax]],
|
||||
which should work out of the box with Org[fn:127][fn:128]. Some MathJax
|
||||
which should work out of the box with Org[fn:128][fn:129]. Some MathJax
|
||||
display options can be configured via ~org-html-mathjax-options~, or
|
||||
in the buffer. For example, with the following settings,
|
||||
|
||||
@ -12779,7 +12782,7 @@ in the buffer. For example, with the following settings,
|
||||
#+texinfo: @noindent
|
||||
equation labels are displayed on the left margin and equations are
|
||||
five em from the left margin. In addition, it loads the two MathJax
|
||||
extensions =cancel.js= and =noErrors.js=[fn:129].
|
||||
extensions =cancel.js= and =noErrors.js=[fn:130].
|
||||
|
||||
#+vindex: org-html-mathjax-template
|
||||
See the docstring of ~org-html-mathjax-options~ for all supported
|
||||
@ -12842,7 +12845,7 @@ line.
|
||||
#+vindex: org-export-html-todo-kwd-class-prefix
|
||||
#+vindex: org-export-html-tag-class-prefix
|
||||
You can modify the CSS style definitions for the exported file. The
|
||||
HTML exporter assigns the following special CSS classes[fn:130] to
|
||||
HTML exporter assigns the following special CSS classes[fn:131] to
|
||||
appropriate parts of the document---your style specifications may
|
||||
change these, in addition to any of the standard classes like for
|
||||
headlines, tables, etc.
|
||||
@ -13081,7 +13084,7 @@ LaTeX export back-end finds the compiler version to use from
|
||||
Org file. See the docstring for the
|
||||
~org-latex-default-packages-alist~ for loading packages with certain
|
||||
compilers. Also see ~org-latex-bibtex-compiler~ to set the
|
||||
bibliography compiler[fn:131].
|
||||
bibliography compiler[fn:132].
|
||||
|
||||
*** LaTeX specific export settings
|
||||
:PROPERTIES:
|
||||
@ -13703,7 +13706,7 @@ a limit to a level before the absolute limit (see [[*Export Settings]]).
|
||||
|
||||
The ODT export back-end handles creating of OpenDocument Text (ODT)
|
||||
format. Documents created by this exporter use the
|
||||
{{{cite(OpenDocument-v1.2 specification)}}}[fn:132] and are compatible
|
||||
{{{cite(OpenDocument-v1.2 specification)}}}[fn:133] and are compatible
|
||||
with LibreOffice 3.4.
|
||||
|
||||
*** Pre-requisites for ODT export
|
||||
@ -14104,7 +14107,7 @@ document in one of the following ways:
|
||||
variables ~org-latex-to-mathml-convert-command~ and
|
||||
~org-latex-to-mathml-jar-file~.
|
||||
|
||||
If you prefer to use MathToWeb[fn:133] as your converter, you can
|
||||
If you prefer to use MathToWeb[fn:134] as your converter, you can
|
||||
configure the above variables as shown below.
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
@ -14115,7 +14118,7 @@ document in one of the following ways:
|
||||
#+end_src
|
||||
|
||||
#+texinfo: @noindent
|
||||
or, to use LaTeXML[fn:134] instead,
|
||||
or, to use LaTeXML[fn:135] instead,
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
(setq org-latex-to-mathml-convert-command
|
||||
@ -14434,7 +14437,7 @@ with the =#+ATTR_ODT= line. For a discussion on default formatting of
|
||||
tables, see [[*Tables in ODT export]].
|
||||
|
||||
This feature closely mimics the way table templates are defined in the
|
||||
OpenDocument-v1.2 specification[fn:135].
|
||||
OpenDocument-v1.2 specification[fn:136].
|
||||
|
||||
#+vindex: org-odt-table-styles
|
||||
For quick preview of this feature, install the settings below and export the
|
||||
@ -14468,7 +14471,7 @@ templates, define new styles there.
|
||||
|
||||
To use this feature proceed as follows:
|
||||
|
||||
1. Create a table template[fn:136].
|
||||
1. Create a table template[fn:137].
|
||||
|
||||
A table template is set of =table-cell= and =paragraph= styles for
|
||||
each of the following table cell categories:
|
||||
@ -14507,7 +14510,7 @@ To use this feature proceed as follows:
|
||||
=</office:automatic-styles>= element of the content template file
|
||||
(see [[x-orgodtcontenttemplate-xml][Factory styles]]).
|
||||
|
||||
2. Define a table style[fn:137].
|
||||
2. Define a table style[fn:138].
|
||||
|
||||
#+vindex: org-odt-table-styles
|
||||
To define a table style, create an entry for the style in the
|
||||
@ -15595,7 +15598,7 @@ If you want to publish the Org file as an =.org= file but with
|
||||
~org-publish-org-to-org~. This produces =file.org= and put it in the
|
||||
publishing directory. If you want a htmlized version of this file,
|
||||
set the parameter ~:htmlized-source~ to ~t~. It produces
|
||||
=file.org.html= in the publishing directory[fn:138].
|
||||
=file.org.html= in the publishing directory[fn:139].
|
||||
|
||||
Other files like images only need to be copied to the publishing
|
||||
destination; for this you can use ~org-publish-attachment~. For
|
||||
@ -16968,13 +16971,13 @@ See [[*Languages]] to enable other languages.
|
||||
#+kindex: C-c C-v e
|
||||
#+findex: org-babel-execute-src-block
|
||||
Org provides many ways to execute code blocks. {{{kbd(C-c C-c)}}} or
|
||||
{{{kbd(C-c C-v e)}}} with the point on a code block[fn:139] calls the
|
||||
{{{kbd(C-c C-v e)}}} with the point on a code block[fn:140] calls the
|
||||
~org-babel-execute-src-block~ function, which executes the code in the
|
||||
block, collects the results, and inserts them in the buffer.
|
||||
|
||||
#+cindex: @samp{CALL}, keyword
|
||||
#+vindex: org-babel-inline-result-wrap
|
||||
By calling a named code block[fn:140] from an Org mode buffer or
|
||||
By calling a named code block[fn:141] from an Org mode buffer or
|
||||
a table. Org can call the named code blocks from the current Org mode
|
||||
buffer or from the "Library of Babel" (see [[*Library of Babel]]).
|
||||
|
||||
@ -17775,10 +17778,10 @@ Code blocks in the following languages are supported.
|
||||
| Asymptote | =asymptote= | Lisp | =lisp= |
|
||||
| Awk | =awk= | Lua | =lua= |
|
||||
| C | =C= | MATLAB | =matlab= |
|
||||
| C++ | =C++=[fn:141] | Mscgen | =mscgen= |
|
||||
| C++ | =C++=[fn:142] | Mscgen | =mscgen= |
|
||||
| Clojure | =clojure= | Objective Caml | =ocaml= |
|
||||
| CSS | =css= | Octave | =octave= |
|
||||
| D | =D=[fn:142] | Org mode | =org= |
|
||||
| D | =D=[fn:143] | Org mode | =org= |
|
||||
| ditaa | =ditaa= | Oz | =oz= |
|
||||
| Emacs Calc | =calc= | Perl | =perl= |
|
||||
| Emacs Lisp | =emacs-lisp= | Plantuml | =plantuml= |
|
||||
@ -17907,7 +17910,7 @@ for Python and Emacs Lisp languages.
|
||||
#+cindex: syntax, Noweb
|
||||
#+cindex: source code, Noweb reference
|
||||
|
||||
Org supports named blocks in Noweb[fn:143] style syntax:
|
||||
Org supports named blocks in Noweb[fn:144] style syntax:
|
||||
|
||||
: <<CODE-BLOCK-ID>>
|
||||
|
||||
@ -18403,7 +18406,7 @@ Org Tempo expands snippets to structures defined in
|
||||
~org-structure-template-alist~ and ~org-tempo-keywords-alist~. For
|
||||
example, {{{kbd(< s TAB)}}} creates a code block. Enable it by
|
||||
customizing ~org-modules~ or add =(require 'org-tempo)= to your Emacs
|
||||
init file[fn:144].
|
||||
init file[fn:145].
|
||||
|
||||
#+attr_texinfo: :columns 0.1 0.9
|
||||
| {{{kbd(a)}}} | =#+BEGIN_EXPORT ascii= ... =#+END_EXPORT= |
|
||||
@ -18483,13 +18486,13 @@ in the desired amount with hard spaces and hiding leading stars.
|
||||
To display the buffer in the indented view, activate Org Indent minor
|
||||
mode, using {{{kbd(M-x org-indent-mode)}}}. Text lines that are not
|
||||
headlines are prefixed with virtual spaces to vertically align with
|
||||
the headline text[fn:145].
|
||||
the headline text[fn:146].
|
||||
|
||||
#+vindex: org-indent-indentation-per-level
|
||||
To make more horizontal space, the headlines are shifted by two
|
||||
characters. Configure ~org-indent-indentation-per-level~ variable for
|
||||
a different number. Only one star on each headline is visible, the
|
||||
rest are masked with the same font color as the background[fn:146].
|
||||
rest are masked with the same font color as the background[fn:147].
|
||||
|
||||
#+vindex: org-startup-indented
|
||||
To globally turn on Org Indent mode for all files, customize the
|
||||
@ -18503,7 +18506,7 @@ use =STARTUP= keyword as follows:
|
||||
|
||||
It is possible to use hard spaces to achieve the indentation instead,
|
||||
if the bare ASCII file should have the indented look also outside
|
||||
Emacs[fn:147]. With Org's support, you have to indent all lines to
|
||||
Emacs[fn:148]. With Org's support, you have to indent all lines to
|
||||
line up with the outline headers. You would use these settings:
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
@ -18744,7 +18747,7 @@ changes.
|
||||
|
||||
#+vindex: org-startup-indented
|
||||
Dynamic virtual indentation is controlled by the variable
|
||||
~org-startup-indented~[fn:148].
|
||||
~org-startup-indented~[fn:149].
|
||||
|
||||
| =indent= | Start with Org Indent mode turned on. |
|
||||
| =noindent= | Start with Org Indent mode turned off. |
|
||||
@ -19552,7 +19555,7 @@ these variables.
|
||||
|
||||
#+vindex: org-mobile-directory
|
||||
The mobile application needs access to a file directory on
|
||||
a server[fn:149] to interact with Emacs. Pass its location through
|
||||
a server[fn:150] to interact with Emacs. Pass its location through
|
||||
the ~org-mobile-directory~ variable. If you can mount that directory
|
||||
locally just set the variable to point to that directory:
|
||||
|
||||
@ -19573,7 +19576,7 @@ With a public server, consider encrypting the files. Org also
|
||||
requires OpenSSL installed on the local computer. To turn on
|
||||
encryption, set the same password in the mobile application and in
|
||||
Emacs. Set the password in the variable
|
||||
~org-mobile-use-encryption~[fn:150]. Note that even after the mobile
|
||||
~org-mobile-use-encryption~[fn:151]. Note that even after the mobile
|
||||
application encrypts the file contents, the file name remains visible
|
||||
on the file systems of the local computer, the server, and the mobile
|
||||
device.
|
||||
@ -19589,15 +19592,15 @@ The command ~org-mobile-push~ copies files listed in
|
||||
~org-mobile-files~ into the staging area. Files include agenda files
|
||||
(as listed in ~org-agenda-files~). Customize ~org-mobile-files~ to
|
||||
add other files. File names are staged with paths relative to
|
||||
~org-directory~, so all files should be inside this directory[fn:151].
|
||||
~org-directory~, so all files should be inside this directory[fn:152].
|
||||
|
||||
Push creates a special Org file =agendas.org= with custom agenda views
|
||||
defined by the user[fn:152].
|
||||
defined by the user[fn:153].
|
||||
|
||||
Finally, Org writes the file =index.org=, containing links to other
|
||||
files. The mobile application reads this file first from the server
|
||||
to determine what other files to download for agendas. For faster
|
||||
downloads, it is expected to only read files whose checksums[fn:153]
|
||||
downloads, it is expected to only read files whose checksums[fn:154]
|
||||
have changed.
|
||||
|
||||
*** Pulling from the mobile application
|
||||
@ -19614,7 +19617,7 @@ data in an inbox file format, through the following steps:
|
||||
|
||||
1.
|
||||
#+vindex: org-mobile-inbox-for-pull
|
||||
Org moves all entries found in =mobileorg.org=[fn:154] and appends
|
||||
Org moves all entries found in =mobileorg.org=[fn:155] and appends
|
||||
them to the file pointed to by the variable
|
||||
~org-mobile-inbox-for-pull~. It should reside neither in the
|
||||
staging area nor on the server. Each captured entry and each
|
||||
@ -19905,9 +19908,9 @@ of these strategies:
|
||||
#+cindex: @LaTeX{}, and Orgtbl mode
|
||||
|
||||
To wrap a source table in LaTeX, use the =comment= environment
|
||||
provided by =comment.sty=[fn:155]. To activate it, put
|
||||
provided by =comment.sty=[fn:156]. To activate it, put
|
||||
~\usepackage{comment}~ in the document header. Orgtbl mode inserts
|
||||
a radio table skeleton[fn:156] with the command {{{kbd(M-x
|
||||
a radio table skeleton[fn:157] with the command {{{kbd(M-x
|
||||
orgtbl-insert-radio-table)}}}, which prompts for a table name. For
|
||||
example, if =salesfigures= is the name, the template inserts:
|
||||
|
||||
@ -19926,7 +19929,7 @@ The line =#+ORGTBL: SEND= tells Orgtbl mode to use the function
|
||||
~orgtbl-to-latex~ to convert the table to LaTeX format, then insert
|
||||
the table at the target (receive) location named =salesfigures=. Now
|
||||
the table is ready for data entry. It can even use spreadsheet
|
||||
features[fn:157]:
|
||||
features[fn:158]:
|
||||
|
||||
#+begin_example
|
||||
% BEGIN RECEIVE ORGTBL salesfigures
|
||||
@ -20142,7 +20145,7 @@ Dynamic blocks, like any other block, can be narrowed with
|
||||
#+vindex: org-agenda-skip-function
|
||||
#+vindex: org-agenda-skip-function-global
|
||||
Org provides a special hook to further limit items in agenda views:
|
||||
~agenda~, ~agenda*~[fn:158], ~todo~, ~alltodo~, ~tags~, ~tags-todo~,
|
||||
~agenda~, ~agenda*~[fn:159], ~todo~, ~alltodo~, ~tags~, ~tags-todo~,
|
||||
~tags-tree~. Specify a custom function that tests inclusion of every
|
||||
matched item in the view. This function can also skip as much as is
|
||||
needed.
|
||||
@ -20185,7 +20188,7 @@ meaningful string suitable for the agenda view.
|
||||
#+vindex: org-agenda-skip-function
|
||||
Search for entries with a limit set on levels for the custom search.
|
||||
This is a general approach to creating custom searches in Org. To
|
||||
include all levels, use =LEVEL>0=[fn:159]. Then to selectively pick
|
||||
include all levels, use =LEVEL>0=[fn:160]. Then to selectively pick
|
||||
the matched entries, use ~org-agenda-skip-function~, which also
|
||||
accepts Lisp forms, such as ~org-agenda-skip-entry-if~ and
|
||||
~org-agenda-skip-subtree-if~. For example:
|
||||
@ -21384,48 +21387,51 @@ properties. Please rewrite your date/week-tree targets using
|
||||
level, months or ISO weeks as sublevels and then dates on the lowest
|
||||
level. Tags are allowed in the tree structure.
|
||||
|
||||
[fn:85] If you need one of these sequences literally, escape the =%=
|
||||
[fn:85] When the file name is not absolute, Org assumes it is relative
|
||||
to ~org-directory~.
|
||||
|
||||
[fn:86] If you need one of these sequences literally, escape the =%=
|
||||
with a backslash.
|
||||
|
||||
[fn:86] If you define your own link types (see [[*Adding Hyperlink
|
||||
[fn:87] If you define your own link types (see [[*Adding Hyperlink
|
||||
Types]]), any property you store with ~org-store-link-props~ can be
|
||||
accessed in capture templates in a similar way.
|
||||
|
||||
[fn:87] This is always the other, not the user. See the variable
|
||||
[fn:88] This is always the other, not the user. See the variable
|
||||
~org-link-from-user-regexp~.
|
||||
|
||||
[fn:88] If you move entries or Org files from one directory to
|
||||
[fn:89] If you move entries or Org files from one directory to
|
||||
another, you may want to configure ~org-attach-id-dir~ to contain
|
||||
an absolute path.
|
||||
|
||||
[fn:89] If the value of that variable is not a list, but a single file
|
||||
[fn:90] If the value of that variable is not a list, but a single file
|
||||
name, then the list of agenda files in maintained in that external
|
||||
file.
|
||||
|
||||
[fn:90] When using the dispatcher, pressing {{{kbd(<)}}} before
|
||||
[fn:91] When using the dispatcher, pressing {{{kbd(<)}}} before
|
||||
selecting a command actually limits the command to the current file,
|
||||
and ignores ~org-agenda-files~ until the next dispatcher command.
|
||||
|
||||
[fn:91] For backward compatibility, you can also press {{{kbd(1)}}} to
|
||||
[fn:92] For backward compatibility, you can also press {{{kbd(1)}}} to
|
||||
restrict to the current buffer.
|
||||
|
||||
[fn:92] For backward compatibility, you can also press {{{kbd(0)}}} to
|
||||
[fn:93] For backward compatibility, you can also press {{{kbd(0)}}} to
|
||||
restrict to the current region/subtree.
|
||||
|
||||
[fn:93] For backward compatibility, the universal prefix argument
|
||||
[fn:94] For backward compatibility, the universal prefix argument
|
||||
{{{kbd(C-u)}}} causes all TODO entries to be listed before the agenda.
|
||||
This feature is deprecated, use the dedicated TODO list, or a block
|
||||
agenda instead (see [[*Block agenda]]).
|
||||
|
||||
[fn:94] The variable ~org-anniversary~ used in the example is just
|
||||
[fn:95] The variable ~org-anniversary~ used in the example is just
|
||||
like ~diary-anniversary~, but the argument order is always according
|
||||
to ISO and therefore independent of the value of
|
||||
~calendar-date-style~.
|
||||
|
||||
[fn:95] You can, however, disable this by setting
|
||||
[fn:96] You can, however, disable this by setting
|
||||
~org-agenda-search-headline-for-time~ variable to a ~nil~ value.
|
||||
|
||||
[fn:96] Custom agenda commands can preset a filter by binding one of
|
||||
[fn:97] Custom agenda commands can preset a filter by binding one of
|
||||
the variables ~org-agenda-tag-filter-preset~,
|
||||
~org-agenda-category-filter-preset~, ~org-agenda-effort-filter-preset~
|
||||
or ~org-agenda-regexp-filter-preset~ as an option. This filter is
|
||||
@ -21435,223 +21441,223 @@ property of the entire agenda view---in a block agenda, you should
|
||||
only set this in the global options section, not in the section of an
|
||||
individual block.
|
||||
|
||||
[fn:97] Only tags filtering is respected here, effort filtering is
|
||||
[fn:98] Only tags filtering is respected here, effort filtering is
|
||||
ignored.
|
||||
|
||||
[fn:98] You can also create persistent custom functions through
|
||||
[fn:99] You can also create persistent custom functions through
|
||||
~org-agenda-bulk-custom-functions~.
|
||||
|
||||
[fn:99] This file is parsed for the agenda when
|
||||
[fn:100] This file is parsed for the agenda when
|
||||
~org-agenda-include-diary~ is set.
|
||||
|
||||
[fn:100] You can provide a description for a prefix key by inserting
|
||||
[fn:101] You can provide a description for a prefix key by inserting
|
||||
a cons cell with the prefix and the description.
|
||||
|
||||
[fn:101] /Planned/ means here that these entries have some planning
|
||||
[fn:102] /Planned/ means here that these entries have some planning
|
||||
information attached to them, like a time-stamp, a scheduled or
|
||||
a deadline string. See ~org-agenda-entry-types~ on how to set what
|
||||
planning information is taken into account.
|
||||
|
||||
[fn:102] For HTML you need to install Hrvoje Nikšić's =htmlize.el=
|
||||
[fn:103] For HTML you need to install Hrvoje Nikšić's =htmlize.el=
|
||||
as an Emacs package from MELPA or from [[https://github.com/hniksic/emacs-htmlize][Hrvoje Nikšić's repository]].
|
||||
|
||||
[fn:103] To create PDF output, the Ghostscript ps2pdf utility must be
|
||||
[fn:104] To create PDF output, the Ghostscript ps2pdf utility must be
|
||||
installed on the system. Selecting a PDF file also creates the
|
||||
postscript file.
|
||||
|
||||
[fn:104] If you want to store standard views like the weekly agenda or
|
||||
[fn:105] If you want to store standard views like the weekly agenda or
|
||||
the global TODO list as well, you need to define custom commands for
|
||||
them in order to be able to specify file names.
|
||||
|
||||
[fn:105] Quoting depends on the system you use, please check the FAQ
|
||||
[fn:106] Quoting depends on the system you use, please check the FAQ
|
||||
for examples.
|
||||
|
||||
[fn:106] You can turn this on by default by setting the variable
|
||||
[fn:107] You can turn this on by default by setting the variable
|
||||
~org-pretty-entities~, or on a per-file base with the =STARTUP= option
|
||||
=entitiespretty=.
|
||||
|
||||
[fn:107] This behavior can be disabled with =-= export setting (see
|
||||
[fn:108] This behavior can be disabled with =-= export setting (see
|
||||
[[*Export Settings]]).
|
||||
|
||||
[fn:108] LaTeX is a macro system based on Donald\nbsp{}E.\nbsp{}Knuth's TeX
|
||||
[fn:109] LaTeX is a macro system based on Donald\nbsp{}E.\nbsp{}Knuth's TeX
|
||||
system. Many of the features described here as "LaTeX" are really
|
||||
from TeX, but for simplicity I am blurring this distinction.
|
||||
|
||||
[fn:109] When MathJax is used, only the environments recognized by
|
||||
[fn:110] When MathJax is used, only the environments recognized by
|
||||
MathJax are processed. When dvipng, dvisvgm, or ImageMagick suite is
|
||||
used to create images, any LaTeX environment is handled.
|
||||
|
||||
[fn:110] These are respectively available at
|
||||
[fn:111] These are respectively available at
|
||||
[[http://sourceforge.net/projects/dvipng/]], [[http://dvisvgm.bplaced.net/]]
|
||||
and from the ImageMagick suite. Choose the converter by setting the
|
||||
variable ~org-preview-latex-default-process~ accordingly.
|
||||
|
||||
[fn:111] Org mode has a method to test if point is inside such
|
||||
[fn:112] Org mode has a method to test if point is inside such
|
||||
a fragment, see the documentation of the function
|
||||
~org-inside-LaTeX-fragment-p~.
|
||||
|
||||
[fn:112] This works automatically for the HTML backend (it requires
|
||||
[fn:113] This works automatically for the HTML backend (it requires
|
||||
version 1.34 of the =htmlize.el= package, which you need to install).
|
||||
Fontified code chunks in LaTeX can be achieved using either the
|
||||
[[https://www.ctan.org/pkg/listings][listings]] package or the [[https://www.ctan.org/pkg/minted][minted]] package. Refer to
|
||||
~org-export-latex-listings~ for details.
|
||||
|
||||
[fn:113] Source code in code blocks may also be evaluated either
|
||||
[fn:114] Source code in code blocks may also be evaluated either
|
||||
interactively or on export. See [[*Working with Source Code]] for more
|
||||
information on evaluating code blocks.
|
||||
|
||||
[fn:114] Adding =-k= to =-n -r= /keeps/ the labels in the source code
|
||||
[fn:115] Adding =-k= to =-n -r= /keeps/ the labels in the source code
|
||||
while using line numbers for the links, which might be useful to
|
||||
explain those in an Org mode example code.
|
||||
|
||||
[fn:115] You may select a different mode with the variable
|
||||
[fn:116] You may select a different mode with the variable
|
||||
~org-edit-fixed-width-region-mode~.
|
||||
|
||||
[fn:116] What Emacs considers to be an image depends on
|
||||
[fn:117] What Emacs considers to be an image depends on
|
||||
~image-file-name-extensions~ and ~image-file-name-regexps~.
|
||||
|
||||
[fn:117] The variable ~org-startup-with-inline-images~ can be set
|
||||
[fn:118] The variable ~org-startup-with-inline-images~ can be set
|
||||
within a buffer with the =STARTUP= options =inlineimages= and
|
||||
=noinlineimages=.
|
||||
|
||||
[fn:118] The corresponding in-buffer setting is: =#+STARTUP: fninline=
|
||||
[fn:119] The corresponding in-buffer setting is: =#+STARTUP: fninline=
|
||||
or =#+STARTUP: nofninline=.
|
||||
|
||||
[fn:119] The corresponding in-buffer options are =#+STARTUP: fnadjust=
|
||||
[fn:120] The corresponding in-buffer options are =#+STARTUP: fnadjust=
|
||||
and =#+STARTUP: nofnadjust=.
|
||||
|
||||
[fn:120] The variable ~org-export-date-timestamp-format~ defines how
|
||||
[fn:121] The variable ~org-export-date-timestamp-format~ defines how
|
||||
this timestamp are exported.
|
||||
|
||||
[fn:121] For export to LaTeX format---or LaTeX-related formats such as
|
||||
[fn:122] For export to LaTeX format---or LaTeX-related formats such as
|
||||
Beamer---, the =org-latex-package-alist= variable needs further
|
||||
configuration. See [[LaTeX specific export settings]].
|
||||
|
||||
[fn:122] At the moment, some export back-ends do not obey this
|
||||
[fn:123] At the moment, some export back-ends do not obey this
|
||||
specification. For example, LaTeX export excludes every unnumbered
|
||||
headline from the table of contents.
|
||||
|
||||
[fn:123] Note that ~org-link-search-must-match-exact-headline~ is
|
||||
[fn:124] Note that ~org-link-search-must-match-exact-headline~ is
|
||||
locally bound to non-~nil~. Therefore, ~org-link-search~ only matches
|
||||
headlines and named elements.
|
||||
|
||||
[fn:124] Since commas separate the arguments, commas within arguments
|
||||
[fn:125] Since commas separate the arguments, commas within arguments
|
||||
have to be escaped with the backslash character. So only those
|
||||
backslash characters before a comma need escaping with another
|
||||
backslash character.
|
||||
|
||||
[fn:125] For a less drastic behavior, consider using a select tag (see
|
||||
[fn:126] For a less drastic behavior, consider using a select tag (see
|
||||
[[*Export Settings]]) instead.
|
||||
|
||||
[fn:126] If =BEAMER_ENV= is set, Org export adds =B_environment= tag
|
||||
[fn:127] If =BEAMER_ENV= is set, Org export adds =B_environment= tag
|
||||
to make it visible. The tag serves as a visual aid and has no
|
||||
semantic relevance.
|
||||
|
||||
[fn:127] By default Org loads MathJax from [[https://cdnjs.com][cdnjs.com]] as recommended by
|
||||
[fn:128] By default Org loads MathJax from [[https://cdnjs.com][cdnjs.com]] as recommended by
|
||||
[[http://www.mathjax.org][MathJax]].
|
||||
|
||||
[fn:128] Please note that exported formulas are part of an HTML
|
||||
[fn:129] Please note that exported formulas are part of an HTML
|
||||
document, and that signs such as =<=, =>=, or =&= have special
|
||||
meanings. See [[http://docs.mathjax.org/en/latest/tex.html#tex-and-latex-in-html-documents][MathJax TeX and LaTeX support]].
|
||||
|
||||
[fn:129] See [[http://docs.mathjax.org/en/latest/tex.html#tex-extensions][TeX and LaTeX extensions]] in the [[http://docs.mathjax.org][MathJax manual]] to learn
|
||||
[fn:130] See [[http://docs.mathjax.org/en/latest/tex.html#tex-extensions][TeX and LaTeX extensions]] in the [[http://docs.mathjax.org][MathJax manual]] to learn
|
||||
about extensions.
|
||||
|
||||
[fn:130] If the classes on TODO keywords and tags lead to conflicts,
|
||||
[fn:131] If the classes on TODO keywords and tags lead to conflicts,
|
||||
use the variables ~org-html-todo-kwd-class-prefix~ and
|
||||
~org-html-tag-class-prefix~ to make them unique.
|
||||
|
||||
[fn:131] This does not allow setting different bibliography compilers
|
||||
[fn:132] This does not allow setting different bibliography compilers
|
||||
for different files. However, "smart" LaTeX compilation systems, such
|
||||
as latexmk, can select the correct bibliography compiler.
|
||||
|
||||
[fn:132] See [[http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2.html][Open Document Format for Office Applications
|
||||
[fn:133] See [[http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2.html][Open Document Format for Office Applications
|
||||
(OpenDocument) Version 1.2]].
|
||||
|
||||
[fn:133] See [[http://www.mathtoweb.com/cgi-bin/mathtoweb_home.pl][MathToWeb]].
|
||||
[fn:134] See [[http://www.mathtoweb.com/cgi-bin/mathtoweb_home.pl][MathToWeb]].
|
||||
|
||||
[fn:134] See [[http://dlmf.nist.gov/LaTeXML/]].
|
||||
[fn:135] See [[http://dlmf.nist.gov/LaTeXML/]].
|
||||
|
||||
[fn:135] [[http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2.html][OpenDocument-v1.2 Specification]]
|
||||
[fn:136] [[http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2.html][OpenDocument-v1.2 Specification]]
|
||||
|
||||
[fn:136] See the =<table:table-template>= element of the
|
||||
[fn:137] See the =<table:table-template>= element of the
|
||||
OpenDocument-v1.2 specification.
|
||||
|
||||
[fn:137] See the attributes =table:template-name=,
|
||||
[fn:138] See the attributes =table:template-name=,
|
||||
=table:use-first-row-styles=, =table:use-last-row-styles=,
|
||||
=table:use-first-column-styles=, =table:use-last-column-styles=,
|
||||
=table:use-banding-rows-styles=, and =table:use-banding-column-styles=
|
||||
of the =<table:table>= element in the OpenDocument-v1.2 specification.
|
||||
|
||||
[fn:138] If the publishing directory is the same as the source
|
||||
[fn:139] If the publishing directory is the same as the source
|
||||
directory, =file.org= is exported as =file.org.org=, so you probably
|
||||
do not want to do this.
|
||||
|
||||
[fn:139] The option ~org-babel-no-eval-on-ctrl-c-ctrl-c~ can be used
|
||||
[fn:140] The option ~org-babel-no-eval-on-ctrl-c-ctrl-c~ can be used
|
||||
to remove code evaluation from the {{{kbd(C-c C-c)}}} key binding.
|
||||
|
||||
[fn:140] Actually, the constructs =call_<name>()= and =src_<lang>{}=
|
||||
[fn:141] Actually, the constructs =call_<name>()= and =src_<lang>{}=
|
||||
are not evaluated when they appear in a keyword (see [[*Summary of
|
||||
In-Buffer Settings]]).
|
||||
|
||||
[fn:141] C++ language is handled in =ob-C.el=. Even though the
|
||||
[fn:142] C++ language is handled in =ob-C.el=. Even though the
|
||||
identifier for such source blocks is =C++=, you activate it by loading
|
||||
the C language.
|
||||
|
||||
[fn:142] D language is handled in =ob-C.el=. Even though the
|
||||
[fn:143] D language is handled in =ob-C.el=. Even though the
|
||||
identifier for such source blocks is =D=, you activate it by loading
|
||||
the C language.
|
||||
|
||||
[fn:143] For Noweb literate programming details, see
|
||||
[fn:144] For Noweb literate programming details, see
|
||||
http://www.cs.tufts.edu/~nr/noweb/.
|
||||
|
||||
[fn:144] For more information, please refer to the commentary section
|
||||
[fn:145] For more information, please refer to the commentary section
|
||||
in =org-tempo.el=.
|
||||
|
||||
[fn:145] Org Indent mode also sets ~wrap-prefix~ correctly for
|
||||
[fn:146] Org Indent mode also sets ~wrap-prefix~ correctly for
|
||||
indenting and wrapping long lines of headlines or text. This minor
|
||||
mode also handles Visual Line mode and directly applied settings
|
||||
through ~word-wrap~.
|
||||
|
||||
[fn:146] Note that turning on Org Indent mode sets
|
||||
[fn:147] Note that turning on Org Indent mode sets
|
||||
~org-hide-leading-stars~ to ~t~ and ~org-adapt-indentation~ to ~nil~.
|
||||
|
||||
[fn:147] This works, but requires extra effort. Org Indent mode is
|
||||
[fn:148] This works, but requires extra effort. Org Indent mode is
|
||||
more convenient for most applications.
|
||||
|
||||
[fn:148] Note that Org Indent mode also sets the ~wrap-prefix~
|
||||
[fn:149] Note that Org Indent mode also sets the ~wrap-prefix~
|
||||
property, such that Visual Line mode (or purely setting ~word-wrap~)
|
||||
wraps long lines, including headlines, correctly indented.
|
||||
|
||||
[fn:149] For a server to host files, consider using a WebDAV server,
|
||||
[fn:150] For a server to host files, consider using a WebDAV server,
|
||||
such as [[https://nextcloud.com][Nextcloud]]. Additional help is at this [[https://orgmode.org/worg/org-faq.html#mobileorg_webdav][FAQ entry]].
|
||||
|
||||
[fn:150] If Emacs is configured for safe storing of passwords, then
|
||||
[fn:151] If Emacs is configured for safe storing of passwords, then
|
||||
configure the variable ~org-mobile-encryption-password~; please read
|
||||
the docstring of that variable.
|
||||
|
||||
[fn:151] Symbolic links in ~org-directory~ need to have the same name
|
||||
[fn:152] Symbolic links in ~org-directory~ need to have the same name
|
||||
as their targets.
|
||||
|
||||
[fn:152] While creating the agendas, Org mode forces =ID= properties
|
||||
[fn:153] While creating the agendas, Org mode forces =ID= properties
|
||||
on all referenced entries, so that these entries can be uniquely
|
||||
identified if Org Mobile flags them for further action. To avoid
|
||||
setting properties configure the variable
|
||||
~org-mobile-force-id-on-agenda-items~ to ~nil~. Org mode then relies
|
||||
on outline paths, assuming they are unique.
|
||||
|
||||
[fn:153] Checksums are stored automatically in the file
|
||||
[fn:154] Checksums are stored automatically in the file
|
||||
=checksums.dat=.
|
||||
|
||||
[fn:154] The file will be empty after this operation.
|
||||
[fn:155] The file will be empty after this operation.
|
||||
|
||||
[fn:155] https://www.ctan.org/pkg/comment
|
||||
[fn:156] https://www.ctan.org/pkg/comment
|
||||
|
||||
[fn:156] By default this works only for LaTeX, HTML, and Texinfo.
|
||||
[fn:157] By default this works only for LaTeX, HTML, and Texinfo.
|
||||
Configure the variable ~orgtbl-radio-table-templates~ to install
|
||||
templates for other modes.
|
||||
|
||||
[fn:157] If the =TBLFM= keyword contains an odd number of dollar
|
||||
[fn:158] If the =TBLFM= keyword contains an odd number of dollar
|
||||
characters, this may cause problems with Font Lock in LaTeX mode. As
|
||||
shown in the example you can fix this by adding an extra line inside
|
||||
the =comment= environment that is used to balance the dollar
|
||||
@ -21659,9 +21665,9 @@ expressions. If you are using AUCTeX with the font-latex library,
|
||||
a much better solution is to add the =comment= environment to the
|
||||
variable ~LaTeX-verbatim-environments~.
|
||||
|
||||
[fn:158] The ~agenda*~ view is the same as ~agenda~ except that it
|
||||
[fn:159] The ~agenda*~ view is the same as ~agenda~ except that it
|
||||
only considers /appointments/, i.e., scheduled and deadline items that
|
||||
have a time specification =[h]h:mm= in their time-stamps.
|
||||
|
||||
[fn:159] Note that, for ~org-odd-levels-only~, a level number
|
||||
[fn:160] Note that, for ~org-odd-levels-only~, a level number
|
||||
corresponds to order in the hierarchy, not to the number of stars.
|
||||
|
||||
@ -698,21 +698,19 @@ of the day at point (if any) or the current HH:MM time."
|
||||
|
||||
(defun org-capture-get-template ()
|
||||
"Get the template from a file or a function if necessary."
|
||||
(let ((txt (org-capture-get :template)) file)
|
||||
(cond
|
||||
((and (listp txt) (eq (car txt) 'file))
|
||||
(if (file-exists-p
|
||||
(setq file (expand-file-name (nth 1 txt) org-directory)))
|
||||
(setq txt (org-file-contents file))
|
||||
(setq txt (format "* Template file %s not found" (nth 1 txt)))))
|
||||
((and (listp txt) (eq (car txt) 'function))
|
||||
(if (fboundp (nth 1 txt))
|
||||
(setq txt (funcall (nth 1 txt)))
|
||||
(setq txt (format "* Template function %s not found" (nth 1 txt)))))
|
||||
((not txt) (setq txt ""))
|
||||
((stringp txt))
|
||||
(t (setq txt "* Invalid capture template")))
|
||||
(org-capture-put :template txt)))
|
||||
(org-capture-put
|
||||
:template
|
||||
(pcase (org-capture-get :template)
|
||||
(`nil "")
|
||||
((and (pred stringp) template) template)
|
||||
(`(file ,file)
|
||||
(let ((filename (expand-file-name file org-directory)))
|
||||
(if (file-exists-p filename) (org-file-contents filename)
|
||||
(format "* Template file %S not found" file))))
|
||||
(`(function ,f)
|
||||
(if (functionp f) (funcall f)
|
||||
(format "* Template function %S not found" f)))
|
||||
(_ "* Invalid capture template"))))
|
||||
|
||||
(defun org-capture-finalize (&optional stay-with-capture)
|
||||
"Finalize the capture process.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user