org-almanac

Contents

1 Application

1.1 Blogging   blogging

1.1.1 TODO Articles   articles

  1. Artur Malabarba: How I blog with Emacs: One year of posts in a single Org file   ATTACH
    author: Artur Malabarba
    published: [2015-06-26 Fri]
    
  2. Bastian Bechtold: Blogging with Emacs   ATTACH
    author: Bastian Bechtold
    published: [2013-11-13 Wed]
    
  3. Dennis Ogbe: Blogging using org-mode (and nothing else)   ATTACH
    author: Dennis Ogbe
    published: [2016-02-01 Mon]
    
  4. Diego Vicente: Blogging with Emacs, and Emacs only   ATTACH
    author: Diego Vicente
    published: [2018-11-01 Thu]
    
  5. Duncan Mac-Vicar P.: Migrating from Jekyll to org-mode and Github Actions   ATTACH
    author: Duncan Mac-Vicar P.
    published: [2019-09-03 Tue]
    

    [2019-09-04 Wed 18:54]

  6. John Louis Del Rosario: Blogging with Orgmode   ATTACH
    author: John Louis Del Rosario
    published: [2016-04-24 Sun]
    
  7. Nicolas Petton: Blogging with org-mode   ATTACH
    author: Nicolas Petton
    published: [2013-10-15 Tue]
    
  8. TODO Pierre Neidhardt: A blog in pure Org/Lisp   website ATTACH
    author: Pierre Neidhardt
    

    [2018-09-03 Mon 02:17]

  9. Rasmus Pank Roulund: Blogging with Org   ATTACH
    author: Rasmus Pank Roulund
    published: [2016-03-27 Sun]
    
  10. Seth J. Morabito: Emacs Blogging for Fun and Profit   ATTACH
    author: Seth J. Morabito
    published: [2018-07-12 Thu]
    
  11. Stig Brautaset
    author: Stig Brautaset
    
    1. TODO .emacs.d/Blogging.org at master · stig/.emacs.d · GitHub
    2. TODO Blogging with Org mode
    3. TODO Blogging with Org mode—update!
    4. TODO Creating an RSS feed with Org mode
    5. TODO How I Blog (This Week)
    6. TODO Linking Org mode blog posts into the index page
  12. Toon Claes
    author: Toon Claes
    

    Toon's blog has a unique and appealing custom theme.

    1. TODO Org mode blogging: Clickable headlines
      published: [2018-12-13 Thu]
      
    2. Org mode blogging: RSS feed   ATTACH
      published: [2018-12-30 Sun]
      
    3. TODO Org mode blogging: Unfurling links
      published: [2018-12-26 Wed]
      

1.1.3 TODO Discussions   discussions

  1. Multi-page sitemaps for org-publish? : emacs   ATTACH
  2. {O} blogging wih org-mode
  3. {PSA} Hugo users: Update to Hugo v0.46 to get syntax highlighted Org mode blocks using Chroma : orgmode   website

    [2018-08-01 Wed 17:27]

    1. Article

      Yours looks so nice!

      Thanks!

      But I'd like mine to work by keeping entries in a single file (or collecting them from multiple files), rather than storing one entry per file.

      Why "But"? :) I do exactly that i.e. multiple posts from one Org file. Well, not exactly that. I have a mix of one post per file and multiple posts per file. For example, my Nim notes ( HTML) got too out of hand, and won't suit in the above file. So I kept it separate (and same for other notes).

      that's possible, but maybe requires custom code. Do you have any thoughts about that?

      I am not sure which custom code you are referring to (the subtree-to-file and file-to-file export code is part of ox-hugo). If you see any of the Org files, they are normal Org files, with adding of #+hugo.. keywords and :EXPORT\HUGO\_.. properties.

      Or, do you mean how to do the same if not planning to use Hugo?

1.1.4 TODO Examples   examples

Blogs and personal Web sites published with Org.

  1. TODO A Scripter's Notes (Kaushal Modi's blog)
  2. Artur Malabarba: Endless Parentheses
    author: Artur Malabarba
    
  3. Duncan Mac-Vicar P.
  4. Juan Reyero
    author: Juan Reyero
    

    Engineer and programmer, with a PhD in Mechanical Engineering and working at Xaar in Cambridge, UK. Before that I worked at Hewlett Packard's research and development lab since 1996. With over 40 US patents filed, at least 12 of them granted and the rest pending. I am currently working on the data pipeline of a 3D printer.

    My latest personal project is GreaterSkies, selling personalized star charts as a high-quality PDF. You choose the location, date and time, and my Common Lisp engine will create for you a beautiful chart with thousands of stars and the planets as seen from that place and at that time.

  5. TODO Mohamed Aziz Knani's blog
  6. Nicolas Petton
    author: Nicolas Petton
    
  7. Rasmus Pank Roulund: Coffee & Coding Chronicles
    author: Rasmus Pank Roulund
    

    I am an economist at the Danish central bank, Nationalbanken, and I recently received a PhD in economics from the European University Institute in Florence.

    I am a supporter of Free Software I contribute to GNU Emacs and in particularly Org mode.

  8. Seth J. Morabito: Loom Communications
  9. Stig Brautaset
    author: Stig Brautaset
    

    I'm a software engineer based in the north east of England. This is my personal site, and opinions expressed here do not reflect those of my employer.

    I'm originally from the west coast of Norway. I studied electronics, and served as a sonar operator on a submarine during compulsory military service, before moving to London to study AI. I graduated from the University of Westminster in 2003, and have been working primarily as a backend software engineer since.

    I build this website in Emacs' Org mode, which can publish static HTML files. Those I deploy on Amazon S3 behind a CloudFront distribution and a free SSL certificate.

  10. TODO Thibault Marin: Personal website in org   ATTACH
  11. Toon Claes: Write Permission
    author: Toon Claes
    

    Toon's blog has a unique and appealing custom theme.

  12. TODO Two Wrongs

1.2 Database   database

Using Org files like a database.

1.2.1 Tools   tools

  1. org-collector

    org-collector is a library in org-contrib that collects headline properties into tables with optional pre-processing. Here's a simple example from its documentation:

    Given the following Org buffer:

    * Spending
    
    ** December
       :PROPERTIES:
       :ID:       december
       :END:
    
    *** Week 1
    
    **** Grocery Store [2008-12-01 Mon]
         :PROPERTIES:
         :amount:   56.77
         :type:     food
         :END:
    
    **** Athletic club [2008-12-02 Tue]
         :PROPERTIES:
         :amount:   75.00
         :type:     health
         :END:
    
    *** Week 2
    
    **** Restaurant [2008-12-08 Mon]
         :PROPERTIES:
         :amount:   30.67
         :type:     food
         :END:
    

    A report could be generated like so:

    #+BEGIN: propview :id "december" :conds ((string= TYPE "food")) :cols (ITEM AMOUNT)
    | "ITEM"                           | "amount" |
    |----------------------------------+----------|
    | "Grocery Store [2008-12-01 Mon]" |    56.77 |
    | "Restaurant [2008-12-08 Mon]"    |    30.67 |
    |----------------------------------+----------|
    |                                  |          |
    #+END:
    
  2. org-ql   libraries

    org-ql provides a query language for Org files. It offers two syntax styles: Lisp-like sexps and search engine-like keywords.

    It includes three libraries: The org-ql library is flexible and may be used as a backend for other tools. The libraries org-ql-search and helm-org-ql provide interactive search commands and saved views.

    Here are a few examples of the Lisp-side of the library. See the examples and screenshots on its home page for more information.

    ;; Show an agenda-like view, similar to a “traditional” Org Agenda
    ;; with Log Mode turned on.
    (org-ql-search (org-agenda-files)
      '(or (and (not (done))
                (or (habit)
                    (deadline auto)
                    (scheduled :to today)
                    (ts-active :on today)))
           (closed :on today))
      :sort '(date priority todo))
    
    ;; Show entries that have any timestamp within the past week. Group by
    ;; date using org-super-agenda with the :auto-ts group.
    (org-ql-search (org-agenda-files)
      '(ts :from -7 :to today)
      :title "Recent Items"
      :sort '(date priority todo)
      :super-groups '((:auto-ts t)))
    
    ;; If you kept a database of music in an Org file, you could run a
    ;; query like this to find tracks composed by Chopin that do not have
    ;; their key recorded in the database.
    (org-ql-search "~/org/music.org"
      '(and (property "genre" "classical")
            (property "composer" "Chopin")
            (not (property "key"))))
    

1.3 Project Management   project_management PIM

On using Org as a Personal Information Manager to manage projects and one's personal life.

1.3.1 Articles   articles

  1. Charles Cave: Natural Project Planning with org-mode (GTD)   ATTACH GTD
    author: Charles Cave
    
  2. Gregory J. Stein: A Guide to My Organizational Workflow: How to Streamline Your Life   website Emacs Org ATTACH
    author: Gregory J. Stein
    published: [2020-03-22 Sun]
    

    [2020-04-26 Sun 01:23]

    Five years ago, my life exploded in complexity. I had just started a new position in a new field. I was planning my wedding. And my inability to say NO to anyone and everyone had culminated in my serving on the board of three graduate student organizations. Inevitably, cracks began to form, and my finite brain started to lose track of tasks. My calendar was sufficient to ensure that I wouldn't miss meetings, but I would often only prepare for those meetings at the eleventh hour. My productivity and the quality of my work both suffered. Something needed to change.

    This guide is devoted to a discussion of the organizational system that I have honed in the time since.Many of the ideas presented here derive from the Getting Things Done methodology, but adapted and expanded to meet my personal needs. With it, I have found that my time is spent more wisely. Better organization means that I can consciously devote effort where it is needed early on, as opposed to scrambling to keep up, and deliver higher quality work without expending more energy.

    You too can streamline your process. This guide is meant to serve as an example of how you might reorganize your workflow and find order through the chaos of your busy life. Yet different lifestyles have different demands: what works for me may not work as well for you. As such, I do not expect that you will replicate this system in its entirety. Instead, I hope you will take inspiration from my system and use elements of it to build a workflow that works for you.

  3. Howard Abrams: Getting Boxes Done, the Code   website ATTACH
    author: Howard Abrams
    

    [2019-01-31 Thu 03:33]

  4. Juan Reyero: Org-mode tricks for team management   ATTACH

    [2019-07-24 Wed 18:07] Talks about org-secretary.el.

    1. TODO Add some kind of tag about teams and coordinating with others.

1.4 Research   research

Using Org for research.

1.4.1 Discussions   discussions

  1. Research work flow : Reddit r/orgmode

    [2020-04-06 Mon 06:20] Using Org for reproducible research, writing and translating fiction, and managing references.

1.5 Studying   studying

On using Org to study various material.

1.5.1 Discussions   discussions

  1. How can I use orgmode in a better way to plan my self study courses? : orgmode   Reddit

    [2020-04-08 Wed 10:26] Some anecdotes, links to videos and other guides, and tips.

1.6 Web Publishing   web_publishing

On publishing Web sites with Org.

See also: Blogging.

1.6.1 Articles   articles

  1. Writing a new org-mode exporter back-end – Imperfect Software   ATTACH
    author: Giles Chamberlin
    

    I’ve been maintaining a simple static website for my jujutsu club since 1985. For most of that time it was simply hand coded HTML and CSS. I’ve wanted to update the site for a while to give it a more modern look, and to handle mobile devices better. I also wanted to move away from hand-coding the HTML and so was interested by org-mode’s HTML export capacity.

    The HTML exporter backend that ships with org-mode didn’t produce the structure I was looking for, and I found myself spending an age fighting the CSS to try to produce the appearance I was after in a range of browsers.

1.6.2 Examples   examples

  1. Jujutsu in Warborough

1.7 Writing   writing

1.7.1 Citations   citations

  1. Tools

1.7.2 Discussions   discussions

  1. u/Dysyre on using Org to write and research a novel

    [2020-04-06 Mon 08:06]

    Major tasks, such as research, go in a plain list under TODO. They are hyperlinked to the relevant part of the text with #+NAME: comments. For minor stuff, I just use a comment with an arbitrary prefix (tt), so I can easily I-search (C-s, I think. I use evil) for it. I could automate things with capture, but I haven't gotten around to setting it up.

    I use priority tags to measure how far a scene is in production, since they are separate from TODO keywords. Any motifs, items, characters, etc. that need to be tracked, I create a tag/property for. I can then use C-c / together with indirect buffers to filter the information.

2 Development   development

Information about Org development.

2.1 Building   building

Information about Building Org.

2.1.1 Articles   articles

  1. Kaushal Modi: Building Org Development version   website ATTACH
    author: Kaushal Modi
    

    [2017-09-01 Fri 22:30] Kaushal Modi shared this on the Org list.

2.2 Performance   performance

2.2.1 Eli Zaretskii: How overlays affect performance   discussions overlays

[2019-12-13 Fri 08:49]

3 Configs   configs

Examples of complete Org configurations.

3.2 Bernt Hansen: Organize your life in plain text!

author: Bernt Hansen

3.2.1 TO-WATCH Bernt Hansen's tutorial   refile video

3.2.2 TO-WATCH Video of it and "navi-mode"   refile video

3.3 Justin Abrahms   ATTACH

author: Justin Abrahms

4 Documentation   documentation

Other sources of documentation about Org.

4.1 Community   community

Community-provided documentation.

4.1.1 Karl Voit: org-mode-workshop

author: Karl Voit

[2015-08-23 Sun 19:51]

In November 2012, I was lucky enough to be able to conduct a workshop about Emacs Org-mode at Graz University of Technology, Austria. This repository contains all relevant material I collected and created for this and possible future workshops on this great topic.

Includes:

Workshop presentation
Outline of presentation given by Karl.
Teaser demo
A large document demonstrating many features of Org.

4.1.2 Worg   bookmark

[2015-08-29 Sat 15:02] There's a lot of good stuff here.

4.2 Manual   bookmark

The official Org manual.

5 Features   built_in

Information about various built-in features of Org. (Related third-party tools may be linked to in the Software section.)

5.1 Agenda   agenda

5.1.1 Articles   articles

  1. Aaron Bieber: An Agenda for Life With Org Mode   website ATTACH

    [2019-04-07 Sun 18:09] I think I've seen this before, but I came across it again, and it has some good examples and code.

5.1.3 Tips   tips

  1. Exclude and include tags in custom Agenda commands

    Commands like org-tags-view naturally offer the ability to control which tags are used to filter items, but such filtering is less obvious when using daily/weekly Agenda commands. However, doing so is straightforward using the variable org-agenda-tag-filter. For example, Org user Stig Brautaset offers this example:

    (setq org-agenda-custom-commands
          '(("w" "Work Agenda"
             ((agenda "" ((org-agenda-span 'day)))
              (todo "TODO"
                    ((org-agenda-max-entries 5)
                     (org-agenda-todo-ignore-scheduled 'all)
                     (org-agenda-todo-ignore-deadlines 'all)
                     (org-agenda-todo-ignore-timestamp 'all))))
             ((org-agenda-tag-filter '("-@home" "-MAYBE"))))
            ("h" "Home Agenda"
             ((agenda "")
              (todo "TODO"
                    ((org-agenda-max-entries 5)
                     (org-agenda-todo-ignore-scheduled 'all)
                     (org-agenda-todo-ignore-deadlines 'all)
                     (org-agenda-todo-ignore-timestamp 'all))))
             ((org-agenda-tag-filter '("-@work" "-MAYBE"))))
            ("m" "Maybe"
             ((todo "PROJ")
              (tags-todo "-PROJ/TODO"))
             ((org-agenda-tag-filter '("+MAYBE"))))
            ("P" "Projects" tags-todo "-MAYBE/PROJ"))))
    

    Alternatives include:

    • Using org-ql to build Agenda-like views using queries, like:
    (org-ql-search (org-agenda-files)
      '(and (or (deadline auto)
                (scheduled :to today)
                (ts-active :on today))
            (not (or (todo "MAYBE")
                     (tags "@home")))))
    
    (setq org-agenda-custom-commands
          '(("w" "Work Agenda"
             ((agenda "" ((org-agenda-span 'day)))
              (todo "TODO"
                    ((org-agenda-max-entries 5)
                     (org-agenda-todo-ignore-scheduled 'all)
                     (org-agenda-todo-ignore-deadlines 'all)
                     (org-agenda-todo-ignore-timestamp 'all))))
             ((org-super-agenda-groups '((:discard (:tags "@home" :todo "MAYBE"))))))
            ("h" "Home Agenda"
             ((agenda "")
              (todo "TODO"
                    ((org-agenda-max-entries 5)
                     (org-agenda-todo-ignore-scheduled 'all)
                     (org-agenda-todo-ignore-deadlines 'all)
                     (org-agenda-todo-ignore-timestamp 'all))))
             ((org-super-agenda-groups '((:discard (:tags "@work" :todo "MAYBE")))))))))
    
  2. Include inactive timestamps in agenda log

    [2016-09-09 Fri 18:51] To include inactive timestamps in the agenda log view, press [. I'm not sure if I should try to make this the default, or if I should use active timestamps instead.

5.2 Appearance   appearance

5.2.1 Articles   articles

  1. Abhinav Tushar: Ricing up Org Mode   ATTACH themes
    author: Abhinav Tushar
    

    [2019-09-11 Wed 16:41] Shows a very customized, minimal and beautiful Emacs/Org config and theme.

5.2.2 Themes

5.2.3 Tools

5.3 Capture   capture

5.3.1 Tools   tools

  1. org-capture for Firefox   Org

    [2015-08-19 Wed 13:35] http://chadok.info/firefox-org-capture/ Looks nice, should try it. Here's a good thread about it on the org-mode list.

5.4 Clocking   clocking

5.4.1 Articles   articles

  1. Sacha Chua: Clocking Time with Emacs Org   ATTACH
    author: Sacha Chua
    

    [2015-08-29 Sat 14:03]

5.5 Exporting   exporting

5.5.1 Headings

  1. Excluding and including

    To exclude certain headings from being exported, use a :noexport: tag on them, like:

    * Heading 1
    
    This heading will be exported.
    
    * Heading 2                                                        :noexport:
    
    This heading will not.
    

    To include certain headings (i.e. to exclude all headings by default), use an :export tag, like:

    * Heading 1
    
    This heading will not be exported.
    
    * Heading 2                                                          :export:
    
    This heading will be.
    

    The manual explains these export option keywords:

    SELECT_TAGS
    The default value is ("export"). When a tree is tagged with export (org-export-select-tags), Org selects that tree and its sub-trees for export. Org excludes trees with noexport tags, see below. When selectively exporting files with export tags set, Org does not export any text that appears before the first headline.
    EXCLUDE_TAGS
    The default value is ("noexport"). When a tree is tagged with noexport (org-export-exclude-tags), Org excludes that tree and its sub-trees from export. Entries tagged with noexport are unconditionally excluded from the export, even if they have an export tag. Even if a sub-tree is not exported, Org executes any code blocks contained there.

5.5.2 Properties

[2020-02-13 Thu 01:31] To export drawers with specific properties, use this syntax:

#+OPTIONS: prop:("property1" "property2")

* Subtree
:PROPERTIES:
:EXPORT_OPTIONS: prop:("property1" "property2")
:END:

To set this option for a subtree, use a drawer like the one above.

Alternatively, to export a single property at a specific place, you can use an Org macro, like:

{{{property(property1)}}}

5.5.3 Themes

5.6 Lists   lists

5.6.1 Start a numbered list from any number | Pragmatic Emacs   website

[2016-03-21 Mon 20:38]

This trick is in the org-mode manual but it’s worth a quick mention in its own right. If you want to start a numbered list in org-mode from a number other than 1, then put [@N] at the start of the first item, where N is the number you want to start with. So for example,

  1. item 1
  2. item 2

This text would interrupt the list and the next item would be 1) on a new list

  1. This will be item 3 thanks to [@3]
  2. and this will be item 4

5.7 Tasks   tasks

5.7.1 Disable TODO-state logging for a file   logging

[2018-06-11 Mon 06:42] I found this page on Google, which I apparently posted to Reddit two years ago:

If you use TODO-state logging by default but want to disable it for a file, add this line at the top of the file:

#+PROPERTY: LOGGING nil

Note: It must be capitalized exactly as shown.

It took some searching of the manual and some trial-and-error to find the right combination. Maybe this will save someone else the trouble someday. :)

6 TODO People   people

People in the Org community.

  • [ ] Gather list from author property.

7 Software   software third_party

Org-related third-party software.

7.1 Features

Organized by related Org features.

7.1.2 Appearance   appearance

  1. Bullets
    1. org-superstar-mode
      author: D. Williams
      

      Prettify headings and plain lists in org-mode. This package is a direct descendant of org-bullets, with most of the code base completely rewritten.

  2. Themes   themes
    1. poet: An Emacs theme well-suited for modes using variable pitch, particularly org-mode and markdown-mode
      author: Kunal Bhalla
      

7.1.3 Exporting   exporting

  1. Themes   themes
    1. org-html-theme-darksun: A Solarized Dark version of the Bigblow Org HTML export theme   HTML
      author: Adam Porter
      
    2. org-html-themes: Framework including two themes, Bigblow and ReadTheOrg   HTML
      author: Fabrice Niessen
      

7.1.4 Lists   lists

  1. org-listcruncher: Parse list contents into tables   tables

    [2018-09-07 Fri 17:28]

7.2 Libraries   libraries

Libraries to be used by other packages, not necessarily related to a specific, user-facing Org feature.

7.2.1 CHECK org-el-cache: Persistent cache for data derived from org-elements   website Emacs Org

[2020-02-08 Sat 08:28]

7.2.2 org-parser.el

This may be a useful alternative to org-element-parse-buffer. Also see Reddit thread.

7.3 Tools   tools

7.3.1 Citations   citations

  1. TODO org-ref: modules for citations, cross-references, and bibliographies, and useful BibTeX tools   citations bibliographies cross_references
    author: John Kitchin
    

8 Tasks

Tasks related to this document.

8.1 TODO Recursive sort function

Should probably support subtree-specific sort functions.

8.2 Resources to add

8.2.1 Consistent Technical Documents Using Emacs and Org Mode - YouTube

This is an excellent demonstration of using Org and Org Babel to produce technical documentation.

8.2.2 UOMF: My Current Org Mode Files and Heading Structure

Karl Voit describes his entire Org system.

8.2.3 Using org-mode to keep track of events (particularly birthdays) : orgmode

Shows 4 specific ways Org can be used to track birthdays, etc.

8.3 TODO Sort by timestamp function

Should support timestamps in property values.

Author: Adam Porter

Created: 2020-05-04 Mon 09:16

Validate