基本設定

概要

ここでは org-mode 周りのベースとなる設定を書いているつもり。といいつつ、まだ書き方が雑だなと思っている。またその内にでも修正しよう

org-mode のインストール

Emacs に標準で入っている org-mode は古かったりするのでとりあえずデフォルトで入ってるやつは削除しちゃって el-get でインストールしている。

(el-get-bundle org-mode)

とりあえず今は 9.6 系を入れておいている。バージョンを固定するために el-get についているレシピをコピーして書き換えて使っている。

(:name org-mode
       :website "http://orgmode.org/"
       :description "Org-mode is for keeping notes, maintaining ToDo lists, doing project planning, and authoring with a fast and effective plain-text system."
       :type git
       :url "https://git.savannah.gnu.org/git/emacs/org-mode.git"
       :checkout "release_9.6.30"
       :info "doc"
       :build/berkeley-unix `,(mapcar
                               (lambda (target)
                                 (list "gmake" target (concat "EMACS=" (shell-quote-argument el-get-emacs))))
                               '("oldorg"))
       :build `,(mapcar
                 (lambda (target)
                   (list "make" target (concat "EMACS=" (shell-quote-argument el-get-emacs))))
                 '("oldorg"))
       :load-path ("." "lisp")
       :load ("lisp/org-loaddefs.el"))

[2023-10-30 月] に main ブランチのものを入れたら agenda が動かなくなって焦ったし [2024-08-22 木] に 9.7 系を入れたら ox-hugo や org-gcal が動かなくなったのでとりあえず 9.6 系を使う運用にしている

org 用ディレクトリの指定

org-mode のファイルを保存するデフォルトのディレクトリを指定している。

デフォルトだと ~/org なのだけどホームディレクトリを汚したくないのと基本的に Mac を使ってるので ~/Documents/org というディレクトリを用意してそこにファイルを置いている。

(setq org-directory (expand-file-name "~/Documents/org/"))

タスク管理ファイルのフォルダの指定

タスク管理ファイルがいくつかに分かれているがそれらをまとめて ~/Documents/org/tasks フォルダに置いている。

(setq my/org-tasks-directory (concat org-directory "tasks/"))

とりあえずこの my/org-tasks-directory という変数を用意することであちらこちらでこれを使い回している。

タスクの状態管理のキーワード指定

org-mode といえば TODO 管理で使ってる人も多いと思う。自分も最初はそういう使い方から始めたし、今でもそれをメインにして使っている。

そして TODO の状態がデフォルトでは

  • TODO

  • DONE

    の2つしかないけど、それでは足りないので昔見たインターネットのどこかの記事を参考に以下のように設定している。

      (setq org-todo-keywords
            '((sequence "TODO" "EXAMINATION(e)" "READY(r)" "DOING(!)" "WAIT" "|" "DONE(!)" "SOMEDAY(s)")))
    

    初期状態は TODO で、作業開始時点で DOING にして待ちが発生したら WAIT にして完了したら DONE にしている。

    SOMEDAY は「いつかやる」に付与しているけど最近ほとんど使ってない。

    org-todo-keywords は複数の sequence を指定したり type を指定したりもできるがそこまでの活用ができていないので、どこかで見直したいですね。

完了時間の記録

org-clock を使うようにしているしあんまり要らない気がする。もしかしたら habits で必要かもしれないけど。

(setq org-log-done 'time)
(setq org-log-into-drawer "LOGBOOK")

org ファイルを開いた時の折り畳み

デフォルト設定では全展開だけど、基本的に見出しだけ見れれば良いかなと思うのでそのように設定した。

(custom-set-variables
 '(org-startup-folded t))

journal ファイルはもう少し展開してても良い気がするので journal のテンプレートか何かを弄っておくのも良さそう

タグ設定時の補完候補設定

agenda ファイルに使われているタグは全部補完対象になってほしいのでそのように設定している

(custom-set-variables
 '(org-complete-tags-always-offer-all-agenda-tags t))

org-mode 読み込み後の追加実行コード

まず org-protocol を使って Firefox と連携したいのでこれを読み込むようにしている。また org-mode のリンク先の拡張子が xlsx の時に OS 側で指定した標準アプリを開くようにしている。

(with-eval-after-load 'org
  (require 'org-protocol)
  (add-to-list 'org-modules 'org-protocol)
  (add-to-list 'org-file-apps '("\\.xlsx?\\'" . default)))

第二引数に default を指定すると、内部的には Mac なら open コマンドが使われることを利用している。