Skip to content

alphapapa/org-notely

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

org-notely

This package makes it easy to quickly take a note in a new heading displayed in a new, indirect buffer. It’s similar to Org’s built-in capture functionality, but it’s not limited to one capture “session”, so you can pop up a new note at any time, without interfering with other activities in Emacs.

For convenience, the new, indirect buffer has RET bound to a command that renames the buffer according to the heading when pressed with point on the heading, and an inactive timestamp is automatically inserted at the beginning of the note.

Used with Yequake, it can also pop open a new Emacs frame.

Contents

Installation

Quelpa

Installing with Quelpa is easy:

  1. Install quelpa-use-package (which can be installed directly from MELPA).
  2. Add this form to your init file:
(use-package org-notely
  :quelpa (org-notely :fetcher github :repo "alphapapa/org-notely"))

Usage

  1. Run M-x customize-group RET org-notely RET and configure the options org-notely-file and org-notely-outline-path according to your preferences.
  2. M-x org-notely RET to pop up a new note buffer at the configured place.
  3. M-x org-notely-here RET to pop up a new note buffer under the heading at point.

Tips

  • The command org-notely accepts a point-marker argument, so one could easily write a command to add a new heading to any other certain heading (similar to Org Capture, but without requiring advance configuration).

Yequake

Yequake makes it easy to display org-notely in a new Emacs frame. Here’s an example configuration:

(use-package yequake
  :custom
  (yequake-frames
   (list (cons "org-notely"
               (list (cons 'buffer-fns '(org-notely))
                     (cons 'width 0.25)
                     (cons 'height 0.5))))))

Then bind a global keyboard shortcut in your desktop environment to run this command, which pops up a new Emacs frame showing a new org-notely buffer:

emacsclient -n -e '(yequake-toggle "org-notely")'

This configuration uses org-sidebar to display a list of org-notely notes, organized by month and year, next to the new-note buffer:

(use-package yequake
  :custom
  (yequake-frames
   '(("org-notely"
      (buffer-fns (lambda ()
                    (find-file-noselect org-notely-file))
                  (lambda ()
                    (org-with-wide-buffer
                     (org-global-cycle '(4))
                     (goto-char (org-find-olp '("Notes") 'this-buffer))
                     (org-cycle)
                     (org-tree-to-indirect-buffer)
                     (let ((org-super-agenda-date-format "%Y %B"))
                       (org-sidebar-ql (current-buffer)
                                       '(regexp ".")
                                       :narrow t :sort 'date
                                       :super-groups '((:auto-ts))))
                     (goto-char (org-end-of-subtree))))
                  org-notely)
      (width . 0.25)
      (height . 0.5)))))

Changelog

0.1-pre

Initial release.

Development

Bug reports, feature requests, suggestions — oh my!

License

GPLv3

About

Pop to new Org headings for quick notetaking

Resources

License

Stars

Watchers

Forks

Releases

No releases published