[[258648]]

介紹

作為一名 Emacs 人，我盡可能讓所有的工作流都在 Org 模式Org-mode 上進(jìn)行 —— 我比較喜歡文本。

我傾向于將書(shū)簽記錄在 Org 模式 等待列表中，而 Org 協(xié)議Org-protocol 則允許外部進(jìn)程利用 Org 模式 的某些功能。然而，要做到這一點(diǎn)配置起來(lái)很麻煩。（搜索引擎上）有很多教程，F(xiàn)irefox 也有這類(lèi) 擴(kuò)展，然而我對(duì)它們都不太滿(mǎn)意。

因此我決定將我現(xiàn)在的配置記錄在這篇博客中，方便其他有需要的人使用。

配置 Emacs Org 模式

啟用 Org 協(xié)議：

(require 'org-protocol)

添加一個(gè)捕獲模板capture template —— 我的配置是這樣的：

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

你可以從 Org 模式 手冊(cè)中 捕獲模板 章節(jié)中獲取幫助。

設(shè)置默認(rèn)使用的模板：

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

執(zhí)行這些新增配置讓它們?cè)诋?dāng)前 Emacs 會(huì)話中生效。

快速測(cè)試

在下一步開(kāi)始前，先來(lái)測(cè)試一下配置：

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

基于的配置的模板，可能會(huì)彈出一個(gè)捕獲窗口。請(qǐng)確保正常工作，否則后面的操作沒(méi)有任何意義。如果工作不正常，檢查剛才的配置并且確保你執(zhí)行了這些代碼塊。

如果你的 Org 模式 版本比較老(老于 7 版本)，測(cè)試的格式會(huì)有點(diǎn)不同：這種 URL 編碼后的格式需要改成用斜杠來(lái)分割 url 和標(biāo)題。在網(wǎng)上搜一下很容易找出這兩者的不同。

Firefox 協(xié)議

現(xiàn)在開(kāi)始設(shè)置 Firefox。瀏覽 about:config。右擊配置項(xiàng)列表，選擇 “New -> Boolean”，然后輸入 network.protocol-handler.expose.org-protocol 作為名字并且將值設(shè)置為 true。

有些教程說(shuō)這一步是可以省略的 —— 配不配因人而異。

添加 Desktop 文件

大多數(shù)的教程都有這一步：

增加一個(gè)文件 ~/.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;

然后運(yùn)行更新器。對(duì)于 i3 窗口管理器我使用下面命令(跟 gnome 一樣)：

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

KDE 的方法不太一樣……你可以查詢(xún)其他相關(guān)教程。

在 FireFox 中設(shè)置捕獲按鈕

創(chuàng)建一個(gè)書(shū)簽（我是在工具欄上創(chuàng)建這個(gè)書(shū)簽的），地址欄輸入下面內(nèi)容：

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

保存該書(shū)簽后，再次編輯該書(shū)簽，你應(yīng)該會(huì)看到其中的所有空格都被替換成了 %20 —— 也就是空格的 URL 編碼形式。

現(xiàn)在當(dāng)你點(diǎn)擊該書(shū)簽，你就會(huì)在某個(gè) Emacs 框架中，可能是一個(gè)任意的框架中，打開(kāi)一個(gè)窗口，顯示你預(yù)定的模板。