在 Firefox 上如何配置 Emacs Org 模式

介绍

做为一名 Emacs 人，我尽量让全部的工做流都在 Org 模式Org-mode 上进行 —— 我比较喜欢文本。

我倾向于将书签记录在 Org 模式 代办列表中，而 Org 协议Org-protocol 则容许外部进程利用 Org 模式 的某些功能。然而，要作到这一点配置起来很麻烦。（搜索引擎上）有不少教程，Firefox 也有这类 扩展，然而我对它们都不太满意。

所以我决定将我如今的配置记录在这篇博客中，方便其余有须要的人使用。

配置 Emacs Org 模式

启用 Org 协议：

(require 'org-protocol)

添加一个捕获模板 —— 个人配置是这样的：

(setq org-capture-templates
(quote (...
("w" "org-protocol" entry (file "~/org/refile.org")
"* TODO Review %a\n%U\n%:initial\n" :immediate-finish)
...)))

你能够从 Org 模式 手册中 捕获模板 章节中获取帮助。

设置默认使用的模板：

(setq org-protocol-default-template-key "w")

执行这些新增配置让它们在当前 Emacs 会话中生效。

快速测试

在下一步开始前，最好测试一下配置：

emacsclient -n "org-protocol:///capture?url=http%3a%2f%2fduckduckgo%2ecom&title=DuckDuckGo"

基于的配置的模板，可能会弹出一个捕获窗口。请确保正常工做，不然后面的操做没有任何意义。若是工做不正常，检查刚才的配置而且确保你执行了这些代码块。

若是你的 Org 模式 版本比较老(老于 7 版本)，测试的格式会有点不一样：这种 URL 编码后的格式须要改为用斜杠来分割 url 和标题。在网上搜一下很容易找出这二者的不一样。

Firefox 协议

如今开始设置 Firefox。浏览 about:config。右击配置项列表，选择 “New -> Boolean”，而后输入 network.protocol-handler.expose.org-protocol 做为名字而且将值设置为 true。

有些教程说这一步是能够省略的 —— 配不配因人而异。

添加 Desktop 文件

大多数的教程都有这一步：
增长一个文件 ~/.local/share/applications/org-protocol.desktop：

[Desktop Entry]
Name=org-protocol
Exec=/path/to/emacsclient -n %u
Type=Application
Terminal=false
Categories=System;
MimeType=x-scheme-handler/org-protocol;

而后运行更新器。对于 i3 窗口管理器我使用下面命令(跟 gnome 同样)：

update-desktop-database ~/.local/share/applications/

KDE 的方法不太同样……你能够查询其余相关教程。

在 FireFox 中设置捕获按钮

建立一个书签（我是在工具栏上建立这个书签的），地址栏输入下面内容：

javascript:location.href="org-protocol:///capture?url="+encodeURIComponent(location.href)+"&title="+encodeURIComponent(document.title||"[untitled page]")

保存该书签后，再次编辑该书签，你应该会看到其中的全部空格都被替换成了 %20 —— 也就是空格的 URL 编码形式。

如今当你点击该书签，你就会在某个 Emacs 框架中，多是一个任意的框架中，打开一个窗口，显示你预约的模板。

---

 

原文来自： https://www.linuxprobe.com/firefox-org-url.html