Doom Emacsは、Emacsの長所を生かしつつ、脂肪をカットし、Emacsの経験を抽出することを目的としています。そのため、ユーザは基本的なことをするためだけに常にマニュアルをチェックする必要なく、拡張性を利用することができます。この結果、ユーザーのニーズに合わせて簡単に変更・修正できるEmacsのバージョンが出来上がります。
ところで、あなたの生産性を高めるために、私たちの Emacs キーボードショートカットのチートシートをダウンロードしてください。
Doom Emacsのインストールは比較的簡単です。事前に必要なものは3つだけです。
- vanilla Emacs 27.1 のインストール
- ripgrep
- Git
Emacs と ripgrep のインストール
Emacsとripgrepは主要なLinuxディストリビューションのほぼ全てのリポジトリで利用可能です。例えば、DebianやUbuntu 21.10でEmacsとripgrepをインストールするには、 apt を使用します。
sudo apt install emacs-gtk ripgrep
Arch Linux では、pacman を使ってください。
sudo pacman -Syu emacs ripgrep
Fedora では、dnf を使用します。
sudo dnf install emacs ripgrep
Void Linux の場合は、xbps を使用します。
sudo xbps-install emacs-gtk2 ripgrep
私の場合、Emacs と ripgrep を Void Linux にインストールしています。
Emacsには様々なフレーバーがあることに注意することが重要です。ほとんどの場合、パッケージマネージャは適切なバージョンの Emacs を選択してインストールしますが、まれにこのプロセスが失敗することがあります。
そのため、インストールするバージョンに注意する必要があります。ここでは、グラフィカルな環境で動作する Emacs のバージョンをインストールすることにします。
- X11
- GTK-2
- GTK-3
その後、Gitのインストールに進みます。
Gitのインストール
Doom Emacsをインストールするために、インターネットからリモートコードリポジトリを取得する必要があります。これを行うには、Gitをインストールします。これによってコードを即座にコピーすることができ、さらに重要なことにメジャーバージョン間の更新も可能になります。
Emacsと同様、GitはすべてのLinuxディストリビューションに共通です。DebianやUbuntuにインストールする場合は、aptを使用します。
sudo apt install git
Arch Linux では、pacman を使ってください。
sudo pacman -Syu git
Fedora では、dnf を使用してください。
sudo dnf install git
Void Linux では、xbps を使用します。
sudo xbps-install git
私の場合は、Void LinuxにGitをインストールしています。
Doom Emacs のインストール
Doom Emacsをインストールするには、いくつかのコマンドを実行するだけです。
git clone --depth 1 https://github.com/hlissner/doom-emacs ~/.emacs.d
これは私たちのマシンの Doom Emacs リポジトリを取得するための Git コマンドです。
- clone` 機能は、コマンドを実行したときに最新のリポジトリをコピーすることを意味します。
- このコマンドでは、リポジトリの履歴を最新の2つのバージョンに切り詰めます。
このコマンドでは、Emacs のデフォルトの設定ディレクトリにリポジトリも保存しています。そのため、このコマンドを入力して、そのディレクトリが存在しないことを確認する必要があります。
rm -rf /home/$USER/.emacs.d/ (日本語)
その後、インストールを開始する必要があります。次のコマンドを入力して、インストールを開始します。
/home/$USER/.emacs.d/bin/doom install
このコマンドはEmacsの上にDoom Emacsをインストールします。
インストール後の設定
この後、インストールに問題がないことを確認するために、さらにいくつかのことを行う必要があります。
まず、PATH変数に"/home/$USER/.emacs.d/doom/bin/“ディレクトリを検出するよう設定し ます。これを行うには、次の行を “/home/$USER/.profile” ファイルに追加します。export PATH=$PATH:$HOME/.emacs.d/doom/bin
これでPATH変数が更新され、Doomのbinディレクトリが含まれるようになります。その後は、環境変数を再読み込みするためにログインし直すだけです。
PATH変数が”/home/$USER/.emacs.d/doom/bin “ディレクトリを検出するかどうかをテストするには、次のコマンドを実行する必要があります。
doom doctor
これにより、インストールが正しく行われたことが確認できます。もし、処理中に何か問題があれば、doom doctor 機能が教えてくれるでしょう。
Doom ユーティリティ。Doom Emacs でのあなたの伴侶
doom doctor は doom ユーティリティで利用可能な関数のひとつに過ぎません。Doom Emacsを修正、更新、修理するためのメインプログラムです。
そのため、最も一般的な機能として、注意すべき点があります。
doom doctorは初期インストールとの間に矛盾がないかをチェックします。また、Doom Emacs を使っているときに問題にぶつかったときに特に役に立ちます。Doom に関連するすべてのディレクトリと設定をチェックし、潜在的なエ ラーを発見します。doom upgradeによって、インストールを簡単にアップグレードすることができます。リポジトリにアップデートがないかチェックし、最新のものと同期させ、バージョン間 の移行を処理します。そのために、doom upgrade は現在の Doom の設定を削除し、アップグレードを段階的に行います。doom purgeは、インストール時にインストールされた古いパッケージやモジュー ルを処理します。そのため、もし大量のパッケージを削除した場合、使用されていない依存関係をすべて削除します。また、-g フラグを付けて実行することで、既存のリポジトリを圧縮することができます。doom syncにより、カスタム設定を修正することができます。Doom Emacsをインストールすると、"/home/$USER/.doom.d/“の下に個人設定用の別ファイルが作成されます。sync機能を実行すると、.doom.dディレクトリの.emacs.dに行われた設定が有効になります。
Doom Emacsの設定
.doom.dディレクトリはDoomのすべての設定が保存されている場所です。3つのファイルで構成されています。
- packages.el ファイルは、インストールするパッケージとその場所を指定します。
- packages.el ファイルは，どのようなパッケージをどこからインストールす るかを指定します．config.el ファイルには、Doom と追加でインストールされたパッケージの両方 の設定が含まれています。
- init.elファイルはDoom Emacsの肉と芋です。init.el ファイルは Doom Emacs のミート＆ポテトです。
Doom モジュール
Doom Emacs は 150 以上のモジュールを選択することができます。そして、必要なモジュールを選ぶだけで、それらのモジュールを有効にすることができます。これにより、Doom を自分自身のコンピューティング環境としてカスタマイズすることができます。
Doom Emacs のモジュールの追加と削除は “.doom.d/init.el” ファイルにある doom! 関数を変更するだけです。一般的な構文は以下のような感じです。
(doom! :checkers
(シンタックス)
:エディタ
(evil)
:lang
(org +journal))
モジュールを有効にするには、カテゴリにラベルを付ける必要があります。この例では、syntax モジュールを追加するために、まず checkers カテゴリを追加する必要があります。
さらに、これらのモジュールには、特定のモジュールに対して有効にすることができるフラグも含まれています。これは Gentoo の USE フラグに似ていて、必要な機能だけを有効にしてプログラムを細かく調整することができます。 モジュールにフラグを追加するには、"+” 記号の後にフラグ名を追加します。この例では、org に journal フラグを追加して、journal サポートを有効にしています。
完了したら、doom sync を実行して、Doom Emacs を設定した状態で再初期化します。
追加パッケージのインストール方法
デフォルトではDoom Emacsはすでに複数のパッケージがインストールされています。しかし、リポジトリから簡単に追加パッケージをインストールすることができます。.doom.d/packages.el” ファイルにある package! 関数を使用することで可能です。
Doom にパッケージをインストールするにはいくつかの方法があります。最も一般的な方法は、ELPAとMELPAからパッケージを調達する方法です。そのためには、以下の Lisp コードを packages.el に追加するだけです。
(パッケージ！パッケージ名)
これは package! 関数に、指定したパッケージが存在するかどうか、すべての共通リポジトリをチェックするように指示します。
(パッケージ！git-パッケージ名
レシピ(:host github :repo "username/package")
これは package! 関数に、github の “username/package” リポジトリから特定のパッケージを取得するように指示します。
(パッケージ！別のgit-package
:recipe (:host github :repo "username/package")
:files ("package.el" "path/of/enta*.el")))
これは、サブディレクトリに分類された多くのパッケージがあるリポジトリからインストールするときに便利です。これを使用すると、インストールしたいパッケージを指定することができます。
これが終わったら、Doom Emacsを再初期化するためにdoom syncを実行する必要があります。
よくある質問
1. Doom Emacsをインストールしたのですが、開くと空白の画面しか表示されません。
これはおそらく .doom.d ディレクトリに問題があり、Doom Emacs が設定を読み込むことができないからでしょう。これを解決する一つの方法は、.doom.dディレクトリが存在し、init.el, packages.el, config.el という3つのファイルが存在するかどうかを確認することです。
また、生成されたinit.elファイルが不正な形式であったり、doomの関数が中に入っていなかったりするために起こることもあります。これを解決するには、Doom Emacsで実行したいモジュールを含むdoomの関数ブロックを作成する必要があります。2. パッケージの管理に package.el を使っていますが、Doom Emacs でも使えますか？
Doom Emacsはパッケージの管理に別のマネージャを使用しています。Doom Emacs が提供するパッケージの機能を利用して、追加のソフトウエアをインス トールする必要があります。
3. Doom Emacsにこのパッケージをインストールしたのですが、もう必要ありません。どうすればアンインストールできますか？
Doom Emacsのパッケージの削除は比較的簡単です。.doom.d/packages.el で以下のような Lisp コードを実行すればいいだけです。
(package! some-package :disable t)
その後、doom syncを実行してDoom Emacsを再読み込みする必要があります。ログインしなおすと、そのパッケージはアンインストールされています。
E
