Version 1.3.2 of package Org-Transclusion has just been released in GNU ELPA. You can now find it in M-x list-packages RET.
Org-Transclusion describes itself as: ================================= Transclude text content via links ================================= More at https://elpa.gnu.org/packages/org-transclusion.html ## Summary: ━━━━━━━━━━━━━━━━━━━━━━━━━━━ README – ORG-TRANSCLUSION ━━━━━━━━━━━━━━━━━━━━━━━━━━━ Table of Contents ───────────────── 1. Example Use Cases & Main Features 2. Installation 3. Contributing 4. License Org-transclusion lets you insert a copy of text content via a file link or ID link within an Org file. It lets you have the same content present in different buffers at the same time without copy-and-pasting it. Edit the source of the content, and you can refresh the transcluded copies to the up-to-date state. Org-transclusion keeps your files clear of the transcluded copies, leaving only the links to the original content. ## Recent NEWS: * Current development version - Features :: Allows for a transclusion workflow with hyper:// links (see hyperdrive.el) or http:// links. Splitting the org-transclusion-add into two parts enables functions in org-transclusion-add-functions to be asynchronous. With this change, content can be transcluded over a network, using http://, hyper://, or other protocols. For a proof-of-concept integration with hyperdrive.el, see this file: https://git.sr.ht/~ushin/hyperdrive.el/tree/org-transclusion/item/hyperdrive-org-transclusion.el. - chg: #213 Allow making transclusion links from any protocol link - refactor: #209 Split -add-callback from -add to enable async transclusion add :things-at-point (or :thingatpt) property for transcluding source and other non-org text files. Both property names are synonym with each other and work in the same way. add org-block-live-sync - Command 'org-transclusion-live-sync-start' now can start live sync when 1) transcluding a source code text file 2) into org src block with the ':src' property in #+transclude Example: #+transclude: [[python-1.py]] :src python add org-transclusion-detach - New command 'org-transclusion-detach' can be used on the transclusion at point. It turns it into a normal, edtitable text content. You can undo this operation. In addition, you can press 'C-d' directly on the transclusion at point to detach it. This is because the command is bound to 'C-d' by default in 'org-transclusion-map'. - 'org-transclusion-refresh' now accepts universal argument such as 'C-u M-x org-transclusion-refresh' and detaches the transclusion at point. You can undo this operation. - 'org-transclusion-add' now accepts universal argument such as 'C-u M-x org-transclusion-add' and copies the source content rather than transclude it. You can undo this operation. - Limitation: Undo detach does not add the overlay back on the source. This should not break any feature. You can safely refresh the transclusion and recover the source overlay. You can also safely open or moved to the source. - Fixes fix: #212 org-transclusion-make-from-link should not add transclusion link in next org heading fix: #211 Don't ever prompt to create a headline when transcluding docs: #210 Update docstring for org-transclusion-with-inhibit-read-only fix(src-lines): #219 Use end-pos in org-transclusion-content-range-of-lines fix(src-lines): #192 error when :thing-at-point nil fix: #174 add faces back org-transclusion and org-transclusion-source * 1.3.2 - fix: Delete superfluous trailing space on remove Before the fix, function 'org-transclusion-keyword-plist-to-string' would add a superfluous trailing space when converting #+transclude keyword's properties back to the string. This does not cause any harm in normal circumstances. The issue would occur with a rare combination of the case where: + You have a buffer with a large number of transclusions activated, around 50 or more + You set a 'whitespace-cleanup' in 'before-save' hook + You have 'auto-save-visited-mode' or similar that automatically saves a buffer If you had combination, and then saved the buffer with the transclusions, you might get an error mid-way of the save operation. You would not lose any data in the buffer, but the buffer would not re-activate all the transclusions that had been active before buffer-save. This was because of the superfluous trailing spaces and automatic removal of them, which caused the mismatch of the point of each transclusion that Org-transclusion remembered during the save operation. * Version 1.3.1 - build: fix #154 missing org-transclusion-pkg.el Nix requires -pkg.el. It was in ‘.elpaignore’. No functional change. ... ...
