HOWTO: Org Mode
Table of Contents
1. Per document TODO states
Execute C-c C-c on a changed #+todo line to re-evaluate it.
Adds BLOCKED as a TODO state and CANCELED as a DONE state:
#+todo: TODO BLOCKED | DONE CANCELED
Defines keybindings for each state that are prompted for when C-c C-t is
invoked:
#+todo: TODO(t) BLOCKED(b) | DONE(d) CANCELED(c)
Asks for a logbook entry when entering the BLOCKED, DONE and CANCELED states.
#+todo: TODO(t) BLOCKED(b@) | DONE(d@) CANCELED(c@)
See https://orgmode.org/manual/Tracking-TODO-state-changes.html for more information about TODO state changes.
2. Exporting to Other Formats
2.1. Document Options
The following line:
#+options: toc:nil num:0 H:4 author:nil timestamp:nil ^:nil
Breaks down to:
- Disables TOC
- Disables section numbering
- Generates 4 headline levels
- Disables author information
- Disables document creation timestamp
- Disables the super-script markup tag (underscore character)
2.2. Explicit TOC
Disable the TOC using the toc:nil option and include an explicit TOC tag.
Example:
#+toc: headlines 2
This makes it possible to include an introduction before the TOC. Otherwise the TOC is always generated first in the exported document.
2.3. HTML custom CSS file
Specify a CSS file to embed for HTML exports:
#+setupfile: style.css.org
Contents of file style.css.org:
#+OPTIONS: org-html-head-include-default-style:nil #+HTML_HEAD: <style type="text/css"> #+HTML_HEAD: EMBEDDED_CSS_GOES_HERE #+HTML_HEAD: </style>
EMBEDDED_CSS_GOES_HERE is regular CSS with each line prefixed with #+HTML_HEAD:.
See https://orgmode.org/manual/CSS-support.html for more information.
My CSS file is kept at https://github.com/johan-bolmsjo/org_css for reference.