Org-transclusion 使用教程
项目地址: https://gitcode.com/gh_mirrors/or/org-transclusion 1. 项目介绍
Org-transclusion 是一个开源的 Emacs 包，它允许用户在 Org 模式下插入文本内容的副本，通过文件链接或 ID 链接来实现。使用 Org-transclusion，您可以在不同的缓冲区中同时展示相同的内容，而无需进行复制和粘贴。当源内容被编辑时，您还可以刷新所有转置的副本以更新状态。这使得您的文件保持整洁，只保留指向原始内容的链接。
2. 项目快速启动
首先，确保您的 Emacs 已经配置好 ELPA (Emacs Lisp Package Archive)。接下来，您可以按照以下步骤安装 Org-transclusion：
;; 添加 GNU ELPA 存档
(add-to-list 'package-archives '("gnu" . "https://elpa.gnu.org/packages/"))
;; 刷新存档
(M-x package-refresh-contents)
;; 安装 org-transclusion
(M-x package-install RET org-transclusion)
安装完成后，您可以开始使用 Org-transclusion 而无需额外配置。以下是一些示例快捷键，您可以将它们添加到 Emacs 配置中：
;; 绑定快捷键 F12 用于添加转置
(define-key global-map (kbd "<f12>") 'org-transclusion-add)
;; 绑定快捷键 C-n t 用于激活 Org-transclusion 模式
(define-key global-map (kbd "C-n t") 'org-transclusion-mode)
对于 Doom 用户，您需要在 ~/.doom.d/package.el 和 ~/.doom.d/config.el 文件中添加相应的配置。
3. 应用案例和最佳实践
书写书籍
您有一系列笔记，可以快速转置段落和章节到您的 Org 文件中，以组成草稿。由于转置实际上是链接，您可以轻松地重新组织它们，以找到最佳的顺序。
学术写作
您有一系列的研究和文献回顾的引用和笔记。将相关的引用和笔记转置到不同的论文中。您可以保持您的收藏作为研究的中心存储库。
技术写作
您为软件编写技术文档。将相关的代码行转置到文档中。由于代码只是被转置，您可以随着代码的演变保持文档的更新。
项目状态报告
您同时参与多个项目，并且需要向不同的项目经理报告。将您的工作笔记和日志的相关部分转置到各自的项目报告中。您可以保持一份工作笔记和日志的单一集合。
4. 典型生态项目
目前 Org-transclusion 社区内并没有明确列出典型的生态项目。不过，任何使用 Org 模式的 Emacs 用户都可以通过 Org-transclusion 来增强他们的文档编写和笔记组织。开源社区中的开发者可以贡献他们的插件和扩展，以进一步丰富 Org-transclusion 的功能和应用场景。