Org Mode Manual

Org Mode Manual

This manual is for Org-mode (version 4.67).

Copyright © 2004, 2005, 2006, 2007, 2008 Free Software Foundation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover texts being “A GNU Manual,” and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License.”

(a) The FSF's Back-Cover Text is: “You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free Software Foundation raise funds for GNU development.”

• Introduction: Getting started
• Document structure: A tree works like your brain
• Tables: Pure magic for quick formatting
• Hyperlinks: Notes in context
• TODO items: Every tree branch can be a TODO item
• Timestamps: Assign date and time to items
• Tags: Tagging headlines and matching sets of tags
• Agenda views: Collecting information into views
• Embedded LaTeX: LaTeX fragments and formulas
• Exporting: Sharing and publishing of notes
• Publishing: Create a web site of linked Org-mode files
• Miscellaneous: All the rest which did not fit elsewhere
• Extensions and Hacking: It is possible to write add-on code
• History and Acknowledgments: How Org-mode came into being
• GNU Free Documentation License: The license for this documentation.
• Index: The fast road to specific information
• Key Index: Key bindings and where they are described

--- The Detailed Node Listing ---

Introduction

• Summary: Brief summary of what Org-mode does
• Installation: How to install a downloaded version of Org-mode
• Activation: How to activate Org-mode for certain buffers.
• Feedback: Bug reports, ideas, patches etc.

Document Structure

• Outlines: Org-mode is based on outline-mode
• Headlines: How to typeset org-tree headlines
• Visibility cycling: Show and hide, much simplified
• Motion: Jumping to other headlines
• Structure editing: Changing sequence and level of headlines
• Archiving: Move done task trees to a different place
• Sparse trees: Matches embedded in context
• Plain lists: Additional structure within an entry

Archiving

• ARCHIVE tag: Marking a tree as inactive
• Moving subtrees: Moving a tree to an archive file

Tables

• Built-in table editor: Simple tables
• Narrow columns: Stop wasting space in tables
• orgtbl-mode: The table editor as minor mode
• The spreadsheet: The table editor has spreadsheet capabilities.

The spreadsheet

• References: How to refer to another field or range
• Formula syntax for Calc: Using Calc to compute stuff
• Formula syntax for Lisp: Writing formulas in Emacs Lisp
• Field formulas: Formulas valid for a single field
• Column formulas: Formulas valid for an entire column
• Editing and debugging formulas: Fixing formulas
• Updating the table: Recomputing all dependent fields
• Advanced features: Field names, parameters and automatic recalc

Hyperlinks

• Link format: How links in Org-mode are formatted
• Internal links: Links to other places in the current file
• External links: URL-like links to the world
• Handling links: Creating, inserting and following
• Link abbreviations: Shortcuts for writing complex links
• Search options: Linking to a specific location
• Custom searches: When the default search is not enough
• Remember: Org-trees store quick notes

Internal links

• Radio targets: Make targets trigger links in plain text.

Remember

• Setting up remember: Some code for .emacs to get things going
• Remember templates: Define the outline of different note types
• Storing notes: Directly get the note to where it belongs

TODO items

• TODO basics: Marking and displaying TODO entries
• TODO extensions: Workflow and assignments
• Priorities: Some things are more important than others
• Breaking down tasks: Splitting a task into managable pieces
• Checkboxes: Tick-off lists

Extended use of TODO keywords

• Workflow states: From TODO to DONE in steps
• TODO types: I do this, Fred the rest
• Per file keywords: Different files, different requirements

Timestamps

• Time stamps: Assigning a time to a tree entry
• Creating timestamps: Commands which insert timestamps
• Custom time format: If you cannot work with the ISO format
• Repeating items: Deadlines that come back again and again
• Progress logging: Documenting when what work was done.

Creating timestamps

• The date/time prompt: How org-mode helps you entering date and time

Progress Logging

• Closing items: When was this entry marked DONE?
• Tracking TODO state changes: When did the status change?
• Clocking work time: When exactly did you work on this item?

Tags

• Tag inheritance: Tags use the tree structure of the outline
• Setting tags: How to assign tags to a headline
• Tag searches: Searching for combinations of tags

Agenda Views

• Agenda files: Files being searched for agenda information
• Agenda dispatcher: Keyboard access to agenda views
• Built-in agenda views: What is available out of the box?
• Presentation and sorting: How agenda items are prepared for display
• Agenda commands: Remote editing of org trees
• Custom agenda views: Defining special searches and views

The built-in agenda views

• Weekly/Daily agenda: The calendar page with current tasks
• Global TODO list: All unfinished action items
• Matching headline tags: Structured information with fine-tuned search
• Timeline: Time-sorted view for single file
• Stuck projects: Find projects you need to review

Presentation and sorting

• Categories: Not all tasks are equal
• Time-of-day specifications: How the agenda knows the time
• Sorting of agenda items: The order of things

Custom agenda views

• Storing searches: Type once, use often
• Block agenda: All the stuff you need in a single buffer
• Setting Options: Changing the rules
• Batch processing: Agenda views from the command line

Embedded LaTeX

• Math symbols: TeX macros for symbols and Greek letters
• Subscripts and Superscripts: Simple syntax for raising/lowering text
• LaTeX fragments: Complex formulas made easy
• Processing LaTeX fragments: Previewing LaTeX processing
• CDLaTeX mode: Speed up entering of formulas

Exporting

• ASCII export: Exporting to plain ASCII
• HTML export: Exporting to HTML
• XOXO export: Exporting to XOXO
• iCalendar export: Exporting in iCalendar format
• Text interpretation: How the exporter looks at the file

HTML export

• Export commands: How to invode HTML export
• Quoting HTML tags: Using direct HTML in Org-mode
• Links: How hyperlinks get transferred to HTML
• Images: To inline or not to inline?
• CSS support: Style specifications

Text interpretation by the exporter

• Comment lines: Some lines will not be exported
• Enhancing text: Subscripts, symbols and more
• Export options: How to influence the export settings

Publishing

• Configuration: Defining projects
• Sample configuration: Example projects
• Triggering publication: Publication commands

Configuration

• Project alist: The central configuration variable
• Sources and destinations: From here to there
• Selecting files: What files are part of the project?
• Publishing action: Setting the function doing the publishing
• Publishing options: Tweaking HTML export
• Publishing links: Which links keep working after publishing?
• Project page index: Publishing a list of project files

Sample configuration

• Simple example: One-component publishing
• Complex example: A multi-component publishing example

Miscellaneous

• Completion: M-TAB knows what you need
• Customization: Adapting Org-mode to your taste
• In-buffer settings: Overview of the #+KEYWORDS
• The very busy C-c C-c key: When in doubt, press C-c C-c
• Clean view: Getting rid of leading stars in the outline
• TTY keys: Using Org-mode on a tty
• Interaction: Other Emacs packages
• Bugs: Things which do not work perfectly

Interaction with other packages

• Cooperation: Packages Org-mode cooperates with
• Conflicts: Packages that lead to conflicts

Extensions, Hooks and Hacking

• Extensions: Existing 3rd-part extensions
• Tables in arbitrary syntax: Orgtbl for LaTeX and other programs
• Dynamic blocks: Automatically filled blocks
• Special agenda views: Customized views

Tables in arbitrary syntax

• Radio tables: Sending and receiving
• A LaTeX example: Step by step, almost a tutorial
• Translator functions: Copy and modify