在 Firefox 上使用 Org 協議捕獲 URL | Linux 中國

介紹

作為一名 Emacs 人，我盡可能讓所有的工作流都在 Org 樣式Org-mode[1] 上進行 —— 我比較喜歡文字。

我傾向於將書簽記錄在 Org 樣式[1] 代辦串列中，而 Org 協議Org-protocol[2] 則允許外部行程利用 Org 樣式[1] 的某些功能。然而，要做到這一點配置起來很麻煩。（搜尋引擎上[3]）有很多教程，Firefox 也有這類 擴充套件[4]，然而我對它們都不太滿意。

因此我決定將我現在的配置記錄在這篇部落格中，方便其他有需要的人使用。

配置 Emacs Org 樣式

啟用 Org 協議：

1. (require 'org-protocol)

新增一個捕獲模板capture template —— 我的配置是這樣的：

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

你可以從 Org 樣式[1] 手冊中 捕獲模板[5] 章節中獲取幫助。

設定預設使用的模板：

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

執行這些新增配置讓它們在當前 Emacs 會話中生效。

快速測試

在下一步開始前，最好測試一下配置：

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

基於的配置的模板，可能會彈出一個捕獲視窗。請確保正常工作，否則後面的操作沒有任何意義。如果工作不正常，檢查剛才的配置並且確保你執行了這些程式碼塊。

如果你的 Org 樣式[1] 版本比較老(老於 7 版本)，測試的格式會有點不同：這種 URL 編碼後的格式需要改成用斜槓來分割 url 和標題。在網上搜一下很容易找出這兩者的不同。

Firefox 協議

現在開始設定 Firefox。瀏覽 about:config。右擊配置項串列，選擇 “New -> Boolean”，然後輸入 network.protocol-handler.expose.org-protocol 作為名字並且將值設定為 true。

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

新增 Desktop 檔案

大多數的教程都有這一步：

增加一個檔案 ~/.local/share/applications/org-protocol.desktop：

1. [Desktop Entry]
2. Name=org-protocol
3. Exec=/path/to/emacsclient -n %u
4. Type=Application
5. Terminal=false
6. Categories=System;
7. MimeType=x-scheme-handler/org-protocol;

然後執行更新器。對於 i3 視窗管理器我使用下麵命令(跟 gnome 一樣)：

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

KDE 的方法不太一樣……你可以查詢其他相關教程。

在 FireFox 中設定捕獲按鈕

建立一個書簽（我是在工具欄上建立這個書簽的），位址列輸入下麵內容：

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

儲存該書簽後，再次編輯該書簽，你應該會看到其中的所有空格都被替換成了 %20 —— 也就是空格的 URL 編碼形式。

現在當你點選該書簽，你就會在某個 Emacs 框架中，可能是一個任意的框架中，開啟一個視窗，顯示你預定的模板。