wilderjds
/
outshine
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
312 Commits
1 Branch
0 Tags
741 KiB
 
Tag: Branch: Tree: 073f7e036a
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '073f7e036a'
${ noResults }
outshine/README.org

3.9 KiB
Raw Blame History

Outshine

Outshine attempts to bring the look and feel of Org Mode to the world outside of the Org major-mode. It's an extension of outline-minor-mode that should act as a replacement of Outline Mode. Just change all your calls to outline-minor-mode into outshine-mode.

Installation

MELPA

Simply install the outshine package from MELPA.

Quelpa

Installing directly with Quelpa into your Emacs config is also very easy:

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

After installation, upgrading can be done through quelpa, e.g. with C-u M-x quelpa RET outshine RET.

Manual

Manual installation is not recommended because it's difficult to keep up with changes. If you want to do this, you'll have to install the elisp files and dependencies manually.

Usage

Keymap prefix

To enable the keybindings, you must set the variable outline-minor-mode-prefix (note the variable name carefully) before loading Outshine, e.g.:

  (defvar outline-minor-mode-prefix "\M-#")

Activation

Activate outshine-mode in buffers in which you want to use it. You may add it to major mode hooks like so:

  (add-hook 'emacs-lisp-mode-hook 'outshine-mode)

Commands

The extensions to outline-minor-mode aim to make its use similar to Org. Given a correctly structured outshine buffer, outline navigation, structure editing, and visibility cycling with outshine should make an Org user feel right at home.

Try C-h m (describe-mode) and C-h b (describe-bindings) in an outshine buffer to see the available functions and their keybindings.

Speed commands

The very useful Org speed commands are available in outshine. To activate them, customize the variable outshine-use-speed-commands. Call outshine-speed-command-help to get an overview of the commands and keybindings.

Misc

  • imenu is supported with the command outshine-imenu.
  • Show the number of hidden lines in folded headlines with the command outshine-show-hidden-lines-cookies.

  • latex-mode commands:

    • outshine-latex-insert-header
    • outshine-latex-insert-headers-in-buffer
    • outshine-TeX-command-region-on-subtree.

Changelog

3.1-pre

Added

  • Add outshine-define-key macro for defining conditional key bindings (e.g. on headlines). Improves on previous outshine-define-key-with-fallback macro by interning a named function and matching the function signature of define-key.
  • Bind <backtab> to outshine-cycle-buffer on headlines

Deprecated

  • Declare outshine-define-key-with-fallback as obsolete, use outshine-define-key instead

3.0 and earlier

date author(s) version
<2018-12-30 Sun> Thibault Polge 3.0
<2018-10-24 Wed> (Various contributors) 2.1
<2014-09-20 Sat> Thorsten Jolitz 2.0
<2013-05-03 Fri> Thorsten Jolitz 1.0
<2013-02-20 Wed> Thorsten Jolitz 0.9

Credits

Outshine was originally authored by Thorsten Jolitz, based on outline-magic by Carsten Dominik (the creator of Org Mode) and out-xtra by Per Abrahamsen. Maintainership was transferred to Adam Porter in 2017. It was refactored to a minor mode and released as 3.0 by Thibault Polge in 2018.

License

GPLv2+