powellb / poet

An emacs theme that's well suited for modes using variable pitch: particularly org-mode and markdown-mode.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

poet MELPA

A light 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 main idea behind this was to make 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 a about building poet at https://explog.in/notes/poet.html. For example,

Screenshots

Set up

  • Installation:
  • 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 "Iosevka" :height 130)
    (set-face-attribute 'fixed-pitch nil :family "Iosevka")
    (set-face-attribute 'variable-pitch nil :family "Baskerville")
  • 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))
  • Additional useful modes: Some modes I like to enable/disable
    (olivetti-mode 1)        ;; Centers text in the buffer
    (flyspell-mode 1)        ;; Catch Spelling mistakes
    (typo-mode 1)            ;; Good for symbols like em-dash

    (blink-cursor-mode 0)    ;; Reduce visual noise
    (linum-mode 0)           ;; No line numbers for prose

    (setq org-bullets-bullet-list
        '("◉" "○"))
    (org-bullets 1)

Reddit reviews poet

Reddit

Warning

  • Exclusively aimed at graphical emacs

Next Steps

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

  • Publish v1 to Melpa.

  • Add more screenshots showing off different modes (particularly markdown)
  • Evaluate & test github flavoured markdown in markdown-mode.
  • Publish v2 to Melpa

  • Create a poet-dark mode with a yellow/white/black scheme.
  • Add a dark brown theme

  • Add support for customizing font faces
  • Document support for additional modes.
  • Publish v3 to Melpa.

More Screenshots

Org Markdown 1 Markdown 2

About

An emacs theme that's well suited for modes using variable pitch: particularly org-mode and markdown-mode.

License:MIT License


Languages

Language:Emacs Lisp 100.0%