NonGNU ELPA - org-auto-tangle

org-auto-tangle

Description
Automatically and Asynchronously tangles org files on save
Latest
org-auto-tangle-0.6.0.tar (.sig), 2024-Mar-31, 20.0 KiB
Maintainer
Yilkal Argaw <yilkalargawworkneh@gmail.com>
Atom feed
org-auto-tangle.xml
Website
https://github.com/yilkalargaw/org-auto-tangle
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

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.

1. 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.

The #+auto_tangle: option may also be used to specify variables that should be preserved in the asynchronous tangling process. For example, if you have installed a newer version of org-mode or additional Babel processors, using

#+auto_tangle: vars:load-path

will be sure that they are available during tangling. The vars option takes a colon-separated list so multiple variables may be specified

#+auto_tangle: vars:calendar-longitude:calendar-latitude:calendar-location-name

It is also possible to disable auto-tangling by adding the nil option to the line without removing any vars list.

#+auto_tangle: vars:load-path nil

2. Babel Auto Tangle Safelist

Add a list of files to the safelist to autotangle with noweb evaluation

(setq org-auto-tangle-babel-safelist '(
				     "~/system.org"
				     "~/test.org"
				     ))

3. License

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

Old versions

org-auto-tangle-0.5.1.tar.lz2022-Jul-153.27 KiB
org-auto-tangle-0.5.0.tar.lz2022-Jul-023.28 KiB
org-auto-tangle-0.4.2.tar.lz2022-Jun-303.22 KiB
org-auto-tangle-0.4.1.tar.lz2022-Jun-072.92 KiB
org-auto-tangle-0.0.1.tar.lz2022-Jun-061.96 KiB