poet-theme

An emacs theme that’s well suited for prose: particularly org-mode and markdown-mode; or any mode that works well with variable-pitch mode.

Motivation

The theme makes Emacs more friendly for writing prose instead of code. Highlights include mixing monospace and variable pitch text in markdown and org-modes, making it convenient to write prose and code together.

I wrote about building poet at https://explog.in/notes/poet.html.

Set up

Installation:
- Melpa: Make sure melpa is in your package archives list, and M-x package-install poet-theme
- Manual: Download the theme to your custom-theme-directory which defaults to ~/emacs.d.
Variable-pitch-mode: Adding variable pitch mode to text modes will help in rendering mixed fonts every time you edit markdown, org-mode, etc.

(add-hook 'text-mode-hook
           (lambda ()
            (variable-pitch-mode 1)))

Custom fonts: Choose your fonts/font sizes before loading the theme with

(set-face-attribute 'default nil :family "DejaVu Sans Mono" :height 130)
(set-face-attribute 'fixed-pitch nil :family "DejaVu Sans Mono")
(set-face-attribute 'variable-pitch nil :family "IBM Plex Serif")

Mac OSX Title Bar: (Only for *Emacs 26.1*+)

(add-to-list
  'default-frame-alist'(ns-transparent-titlebar . t))
(add-to-list
  'default-frame-alist'(ns-appearance . light))

Reddit reviews poet

Warning

Exclusively aimed at graphical emacs

Next Steps

(No fixed timelines for these, depends on my time and motivation)

[X] Publish v1 to Melpa.
[X] Add more screenshots showing off different modes (particularly markdown)
[X] Evaluate & test github flavoured markdown in markdown-mode.
[X] Publish v2 to Melpa
[X] Create a poet-dark mode with a yellow/white/black scheme.
[X] Add a dark brown theme
[X] Add support for disabling variable font sizes.
[ ] Explore a new bolder version of poet.
[ ] Document support for additional modes.
[ ] Publish v3 to Melpa.