https://github.com/TonCherAmi/org-padding

Padding for org-mode.
https://github.com/TonCherAmi/org-padding

emacs emacs-lisp emacs-package org-mode

Last synced: 2 months ago
JSON representation

Padding for org-mode.

• Host: GitHub
• URL: https://github.com/TonCherAmi/org-padding
• Owner: TonCherAmi
• Created: 2020-07-29T00:24:02.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-05-01T16:03:20.000Z (over 1 year ago)
• Last Synced: 2024-02-17T07:35:15.890Z (11 months ago)
• Topics: emacs, emacs-lisp, emacs-package, org-mode
• Language: Emacs Lisp
• Homepage:
• Size: 5.86 KB
• Stars: 29
• Watchers: 3
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.org

Awesome Lists containing this project

README

        
* org-padding

This package makes it possible to set custom padding for org-mode headings and blocks.

** Installation

Using use-package + quelpa:

 #+BEGIN_SRC elisp

  (use-package org-padding

    :quelpa (org-padding :repo "TonCherAmi/org-padding" :fetcher github))

 #+END_SRC

Alternatively you can just download the archive and manually ~require~ the package.

** Configuration

Padding values can be configured with help of the following variables:

- ~org-padding-heading-padding-alist~ - controls the heading padding values, it is an alist where each pair

  (of form ~(TOP-PADDING . BOTTOM-PADDING)~) describes the padding values for the corresponding heading level.

- ~org-padding-block-begin-line-padding~ - controls the block-begin-line padding e.g. ~#BEGIN_SRC elisp~,

  it is a pair of form ~(TOP-PADDING . BOTTOM-PADDING)~.

- ~org-padding-block-end-line-padding~ - controls the block-end-line padding e.g. ~#END_SRC~,

  it is a pair of form ~(TOP-PADDING . BOTTOM-PADDING)~.

To enable the minor mode:

 #+BEGIN_SRC elisp

  (add-hook 'org-mode-hook #'org-padding-mode)

 #+END_SRC

*** Example configuration

 #+BEGIN_SRC elisp

  (setq org-padding-block-begin-line-padding '(2.0 . nil))

  (setq org-padding-block-end-line-padding '(nil . 1.0))

  (setq org-padding-heading-padding-alist

    '((4.0 . 1.5) (3.0 . 0.5) (3.0 . 0.5) (3.0 . 0.5) (2.5 . 0.5) (2.0 . 0.5) (1.5 . 0.5) (0.5 . 0.5)))

 #+END_SRC