Org Mode Bookmarks
Table of Contents
1. Websites in Org Mode
1.1. List of Websites
List of websites written and published using Org Mode:
- Thibaultmarin and Personal wiki in org, the blog post describing the setup. Interesting because published on GitHub (last retrieved )
- Loom Communications, and the articles describing the publishing workflow: More on Emacs Blogging (describes how to implement post pagination) and Emacs Blogging for Fun and Profit, which describes the publishing framework approach (last retrieved ).
- Diego Codes, and Blogging with Emacs, and Emacs only which describes the publishing configuration. Interesting for simplicity and layout. (Last retrieved )
- Ramblings from a Corner, and the Blogging with Org publishing, which describes custom HTML export functions, Disqus, and analytics, if you are in such things. (Last retrieved )
- Juan José García Ripoll use Moustache for defining the templates: Org-THTML: An HTML template system for org-mode. (Last retrieved )
- Pavel Panchekha describes in Using Org-mode to Publish a Web Site how to trigger publication on Git commit. (Last retrieved )
- John Louis Del Rosario has a pretty straightforward workflow described in Blogging with Org mode. The websites uses CM fonts, a nice touch. (Last retrieved )
- Intro to AI website of a course with a nice two columns layout on the home page (which is written directly in HTML, though). Source code available on GitHub: joshuaeckroth /cse3521-website. Interesting the idea of mixing HTML (for more complex layouts) and plain Org Mode (for “standard” pages). (Last retrieved )
- The Kitchin Research Group does everything with Org Mode. Impressive work and many interesting article on their blog. Their Blog archive has various articles about literate programming and Org Mode. (Last retrieved )
- Mohammed Sadiq uses a pretty straightforward workflow and uses
directory names to determine the location of posts (e.g.,
2018/08/08/hello-world.org
). Index managed by hand. Nice layout. (Last retrieved ) - Duncan Codes is a blog based on Org Mode. The article describing the setup, Migrating from Jekyll to org-mode and GitHub Actions, is interesting for the design choices behind the migration. The publishing workflow is fairly complex, supports redirects keyword in pages and has a nice layout, based on the Jekyll theme Lagom. (Last retrieved )
- Write Permission is written using Org Mode. The workflow seems to be based on a fairly long piece of Emacs lisp (the source code of the website is available here: Gitlab Repository). Some articles illustrate in more details tips and tricks used on the website: Org mode blogging: RSS feed, Org mode blogging: Clickable headlines, Org mode blogging: Unfurling links. (Last retrieved )
Basti’s Scratchpad on the Internet has a straightforward setup, in which each post is a file. The index page is generated by hand, using
#+include
; the list of all posts is generated with the:auto-sitemap
directive:... :auto-sitemap t :sitemap-filename "archive.org" :sitemap-title "Archive" :sitemap-sort-files anti-chronologically :sitemap-style list :makeindex t ...
Setup described in Blogging with Emacs. (Last retrieved )
- The blog posts of Justin Abrahms is another example of a straightforward application of Org Mode publishing functions. Setup described in Writing a static site generator using org-mode. (Last retrieved )
- Endless Parentheses uses a single file for all his blog: How I blog: One year of posts in a single org file. Publication based on Jekyll, though. (Last retrieved )
Jay Kamat shows some simple and effective solutions (such as listing links to other pages in the content of the homepage, rather than in a top-bar). More important, the article Creating A Blog in Org Mode has a super-interesting and simple suggestion on how to generate a
<div>
wrapper around some content:#+begin_classname Content inside your div #+end_classname
(Last retrieved
)- Nicolas Petton blogs using Org Mode. Very simple setup, with header and footer setup in Emacs lisp. Setup described here: Blogging withorg-mode. Very nice layout; not clear how the blog is generated. (Last retrieved )
- Eric Evenchick has a website with Org Mode. Setup described here: Blogging with Org Mode (Last retrieved )
- Vincent Demeester describes his setup here Migrating to an org-mode
website, which includes a nice example of
:sitemap-format-entry
to generate a list of posts. (Last retrieved ) - (blog ’zezin) describes a Gitlab workflow to publish his Org Mode website: Blogging with org-mode and Gitlab Pages. (Last retrieved )
- Pierre Neidhardt has a website published using Org Mode only, described here: A blog in pure Org/Lisp. (Last retrieved )
- BHL0388 has a simple and very nice layout. A couple of posts describe the setup: Blog with only Org Mode, Blog in Org Mode Revisited; another explains how to improve the section ids in the exported HTML file: Org HTML Export: Permanent Section Link.
1.2. Meta lists
- The official list: https://orgmode.org/worg/org-web.html
- Another list with seven websites (as of Jan 28, 2019): https://pages.gitlab.io/org-mode/post3.html
1.3. Reusable Assets
- org-css a nice looking CSS style for exported documents
- org-html-themes has various CSS themes, among which “Read The Org”, which mimics “Read the docs” and can be used for generating a documentation website.
1.4. Templating Languages
Templating language to intermix Emacs lisp and HTML markup:
- Templatel has a syntax similar to Liquid, very simple to use from Emacs Lisp. I am using it for this website.
- Org-THTML: An HTML template system for org-mode has a syntax similar to Moustache.
- pp-html is a html template language in Emacs-Lisp similar to HAML.
1.5. Publishing Tutorials
1.6. Static Website Generators written in Emacs Lisp
- Yet Another Org Wiki generates a “read the docs” like website directly from an OrgMode publication project.
- Org2Jekyll lets you manage all files in Org Mode while exporting to a Jekyll website, which you can then compile to HTML (similar to Firn).
- Weblorg looks very interesting and is based on the concept of pipelines: each pipeline specify how to transform a group of files. Templatel templates can be used for rendering
1.7. Other Possibilities
If you prefer a more “conventional” approach, you can use any of the following:
- Jekyll with the Jekyll Org plugin takes Org Mode files as input
- Hugo, which supports Org Mode natively
- Firn, written in Clojure, generates a static site from org-mode files (similar to Org2Jekyll).
2. Beamer and Org Mode
2.1. Authoring Beamer presentations in Org Mode
- Contributed tutorial, good for getting started
- Reference Card for Org Beamer is a good reference for the various options and configurations
2.2. Beamer documentation
- Beamer User Guide is the official documentation
- Introduction to Latex - Beamer is a nice tutorial, written in Beamer.
2.3. Customizing Beamer Presentations
- Beamer Cheatsheet lists many configuration options you can set to change the appearance of Beamer slides. This seems to be another instance of the same document.
- Beamer Theme Gallery presents the different combinations of themes and colors in a big matrix. A more convenient layout can be found in the Beamer Theme Gallery page, where one can interactively select theme, color, and fonts.
- The Ultimate Beamer Theme List lists several custom themes, many of which, in my opinion, worth trying.
- Some nice themes: Simple, Metropolis
3. Org Mode Customization
3.1. Improving Look
- Hugo Cisneros posted his Emacs configuration, which includes many tunings to the display of Org Mode Agendas and files. There is a nice and simple example to sync with Nextcloud, using org-caldav.