All Projects → yilkalargaw → org-auto-tangle

yilkalargaw / org-auto-tangle

Licence: BSD-2-Clause License
a simple emacs package to allow org file tangling upon save

Programming Languages

emacs lisp
2029 projects

org-auto-tangle

This package (i.e org-auto-tangle) is a very simple emacs package that allows you to automatically tangle org files on save. This is done by adding the option #+auto_tangle: t in your org file.

The tangling process happens asynchronously so it will not block your emacs session.

USAGE

Simply require the package in you emacs init and hook it into org-mode.

(require 'org-auto-tangle)

(add-hook 'org-mode-hook 'org-auto-tangle-mode)

or you can use use-package

(use-package org-auto-tangle
  :load-path "site-lisp/org-auto-tangle/"    ;; this line is necessary only if you cloned the repo in your site-lisp directory 
  :defer t
  :hook (org-mode . org-auto-tangle-mode))

If the minor mode is on, it will try to automatically tangle your org files if they contain a non nil value for the #+auto_tangle: option.

You can configure auto-tangle as the default behavior for all org buffers by setting the org-auto-tangle-default variable to t. In this case, you can disable it for some buffers by setting the #+auto_tangle: option to nil.

License

This package (i.e. org-auto-tangle) is licensed under the the 2-Clause BSD License.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].