介紹javascript
做爲一名 Emacs 人,我儘量讓全部的工做流都在 Org 模式Org-mode 上進行 —— 我比較喜歡文本。html
我傾向於將書籤記錄在 Org 模式 代辦列表中,而 Org 協議Org-protocol 則容許外部進程利用 Org 模式 的某些功能。然而,要作到這一點配置起來很麻煩。(搜索引擎上)有不少教程,Firefox 也有這類 擴展,然而我對它們都不太滿意。java
所以我決定將我如今的配置記錄在這篇博客中,方便其餘有須要的人使用。linux
配置 Emacs Org 模式app
啓用 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 模式 手冊中 捕獲模板 章節中獲取幫助。測試
設置默認使用的模板:ui
(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 框架中,多是一個任意的框架中,打開一個窗口,顯示你預約的模板。