HN 日本語サマリー

← 一覧へ戻る
プログラミング

シンプルで美しいEmacsのモデライン: modusregel

Simple, beautiful Emacs modeline: modusregel (codeberg.org)

6 pointsby jjba230 コメント

要約

modusregelは、Emacsのために開発された、シンプルで美しいモデライン(ステータスバー)パッケージです。カスタマイズ性、美しさ、パフォーマンスを重視して設計されており、GUIとTUIの両方のビューポートで動作します。軽量で高速、かつEmacs Lispで書かれています。

全文翻訳

modusregel

[画像: https://jointhefreeworld.org/ggg/dist/emacs-lisp.svg] [画像: https://jointhefreeworld.org/ggg/dist/license-gpl3+.svg] [画像: https://jointhefreeworld.org/ggg/dist/license-fdl13+.svg]

What is modusregel?

modusregel はオランダ語で「モードライン」を意味します。

このパッケージは、カスタマイズ性、美しさ、パフォーマンスを念頭に置いて構築された、Emacsのモデルライン(画面下部のバー)のための、クリーンでシンプル、エレガントで美しいモデルラインを提供します。EmacsのGUIとTUIの両方のビューポートで完全に互換性があります。

  • Tree-Sitterによるスマートなメジャーモードマッピング: メジャーモード名を整形し、-ts-mode のバリアント(例: rust-ts-mode)を検出し、それを美しく整形します(例: Rust)。
  • LSP & Flymake対応: EglotとFlymakeのカウンターのための、非侵襲的なインジケーターを内蔵しています。
  • 完全なバッファ状態表示: 未保存の変更、読み取り専用バッファ、ナローされたバッファ、リモートファイルなど、それぞれの状態を明示し、何も言うことがない場合は何も表示しません。
  • 軽量 & 高速: パフォーマンスを念頭に置いて、純粋で効率的なEmacs Lispで記述されており、外部依存はありません。
  • TUI/GUIの同等性: ターミナルで実行しても、グラフィカルウィンドウで実行しても、シャープで整列された表示になるように設計されています。
  • 要素ごと: モデルラインの各部分は、名前で変更、並べ替え、削除、追加ができる modusregel- 変数です。

私の活動を気に入っていただけましたら、コーヒー一杯を奢る ☕ ことで応援していただけると、さらなるモチベーションにつながります。


注: modusregelは、ネイティブのEmacsモデルラインを完全に、または部分的に置き換えるように設計されています。特定の外部モデルラインパッケージとの統合には、カスタム設定が必要になる場合があります。

[画像: https://jointhefreeworld.org/static-assets/modusregel/screen-2026-07-03-09-04-58.png]

[画像: https://jointhefreeworld.org/static-assets/modusregel/screen-2026-07-02-23-30-10.png]

[画像: https://jointhefreeworld.org/static-assets/modusregel/screen-2026-07-01-15-53-38.png]


モデルラインの各要素

modusregelは、ミニマリストなUnicodeアイコンを使用して、インターフェースをクリーンに保ちつつ、深く情報を提供します。

𝝺modusregel-leading-strLambda: モデルラインの絶対的な開始位置に配置され、EmacsのLispの伝統を彷彿とさせます。
●modusregel-buffer-modified-str未保存の変更: 現在のバッファが変更されたが、まだ保存されていない場合にのみ表示されます。
☡modusregel-buffer-read-only-str読み取り専用警告: バッファが書き込み禁止または読み取り専用の場合に表示されます。
☍modusregel-remote-exprリモート接続: リモートファイル(例: TRAMP経由)を操作している場合に表示されます。
𝌤modusregel-eglot-exprEglot LSPアクティブ: Eglot Language Server Protocolセッションがバッファをアクティブに管理している場合に表示されます。

モデルラインは modusregel-format から描画されます。これは、以下の要素のリストで、表示される順序になっています。上から下へ読むことは、モデルラインを左から右へ読むことと同じです。

要素表示
modusregel-leading-strモデルラインを開く 𝝺。
modusregel-remote-exprリモートファイルを開いているバッファの場合は ☍、それ以外の場合は何も表示しません。
modusregel-buffer-name-exprバッファ名(太字)、ツールチップにはそのファイル名が表示されます。
modusregel-buffer-modified-strバッファに変更があり保存されていない場合は ● が表示されます。
modusregel-buffer-read-only-strバッファが読み取り専用の場合は ☡ が表示されます。
modusregel-narrowed-exprバッファがナローされている場合は [narrow] と表示されます。
modusregel-spacer-str各部分の間のスペース。
modusregel-line-number-str行番号。
modusregel-column-number-str列番号(コロンの後)。
modusregel-buffer-position-exprウィンドウがバッファ内をどの程度移動したかを示します:パーセンテージ、または Top、Bot、All。
modusregel-vc-exprバージョン管理のブランチまたはリビジョン。バックエンド名は表示されません。バージョン管理外の場合は何も表示しません。
modusregel-major-mode-exprメジャーモード名(modusregel-major-mode-alist で整形されます)。
modusregel-eglot-exprEglotがバッファを管理している場合は 𝌤 が表示されます。
modusregel-flymake-exprFlymakeに報告すべきことがある場合に、Flymakeのカウンターが表示されます。

もう一つの要素として modusregel-nyan-expr があり、これは nyan-mode のNyan Catインジケーター用です。これはデフォルトのフォーマットには含まれておらず、nyan-mode がオンの場合にのみ表示されるため、オンでもオフでも使用できるフォーマットに残しておくことができます。


インストール

このパッケージは、MELPAやELPAなどの一般的なEmacsリポジトリでは(まだ)利用できません。Emacs 29.1以降が必要です。

Elpacaを使用したインストールの例:

(use-package modusregel
  :ensure (:host codeberg :repo "jjba23/modusregel" :branch "trunk")
  :demand t
  :config
  (modusregel-mode 1))

modusregel-mode はグローバルなマイナーモードで、modusregel-format をデフォルトの mode-line-format に設定し、オフにする際には以前の値に戻します。デフォルトではオフになっているため、要求されるまでパッケージは何も行いません。

注意: mode-line-format はウィンドウに属するため、デフォルト値が設定されるのはウィンドウごとです。独自のフォーマットが与えられたウィンドウはそれを保持します。これも、モデルラインをインストールする実践的な方法が setq-default を使用し、setq 単体では画面に表示されている間だけ現在のバッファを変更する理由です。

;; 独自のフォーマットが設定されていないすべてのウィンドウ。
(setq-default mode-line-format modusregel-format)

;; このバッファのみ、キルするまで。
(setq mode-line-format modusregel-format)

カスタマイズ

M-x customize-group RET modusregel RET を実行すると、各要素、その表示内容、および変更による効果を確認できます。

modusregel-format は要素の値ではなく名前を保持しているため、モデルラインは描画時にそれらを解決します。CustomizeまたはLispから modusregel-leading-str を変更すると、次の再表示で確認できます。リロードする必要はありません。

フォーマットは通常のリストなので、リストとして編集できます。描画される内容を変更する方法は、通常望まれる順序で以下のようになります。

;; Flymakeカウンターを除外する。
(setq modusregel-format (remove 'modusregel-flymake-expr modusregel-format))

;; バージョン管理ブランチを、最初のラムダの後に配置する。
(setq modusregel-format
      (cons (car modusregel-format)
            (cons 'modusregel-vc-expr
                  (remove 'modusregel-vc-expr (cdr modusregel-format)))))

;; Nyan Catを使用する場合に追加する。リテラルな構造は、シンボルと同様にフォーマットに含める必要があります。
(add-to-list 'modusregel-format 'modusregel-nyan-expr)

;; 独自のメッセージを表示し、自分で描画する。
(add-to-list 'modusregel-format
             '(:eval (when (derived-mode-p 'prog-mode) " λ ")))

mode-line-format の編集時に知っておくと役立つ2つのルールがあります。これらを破ると、静かに失敗します。

  1. carがシンボルであるリストは、描画するもののリストではありません。 これは条件付きフォーム (SYMBOL THEN ELSE...) であり、シンボルの値が非nilの場合は THEN を、そうでない場合は ELSE を描画します。したがって、modusregel-format は文字列で始まります(Emacs自身のモデルラインフォーマットも同じ理由で "%e" で始まります)。そして、その状態を維持する必要があります。

  2. シンボルがモデルラインによって処理されるためには、マークされる必要があります。 シンボルが risky-local-variable プロパティを持っている場合を除き、モデルラインは :eval フォームとその値内のテキストプロパティを無視し、空文字列を描画します。このパッケージのすべての要素はマークされています。あなた自身の要素もマークしてください:

    (put 'my-mode-line-element 'risky-local-variable t)
    

独自のフォーマットを作成する

要素は通常の変数なので、独自のフォーマットは、望む要素のリストを、望む順序で作成します。

(defun my/modusregel-format ()
  "Draw the mode line with the parts I care about."
  (setq-default mode-line-format
                (list ""
                      modusregel-leading-str
                      modusregel-remote-expr
                      modusregel-buffer-name-expr
                      modusregel-buffer-modified-str
                      modusregel-buffer-read-only-str
                      modusregel-narrowed-expr
                      modusregel-spacer-str
                      modusregel-line-number-str
                      modusregel-column-number-str
                      modusregel-spacer-str
                      modusregel-buffer-position-expr
                      modusregel-spacer-str
                      modusregel-vc-expr
                      modusregel-major-mode-expr
                      modusregel-eglot-expr
                      modusregel-spacer-str
                      modusregel-flymake-expr)))

(add-hook 'after-init-hook #'my/modusregel-format)

先頭の空文字列に注意してください。これは、リストが描画するもののリストであり、条件付きフォームではないことを示します(上記の2つのルールを参照)。

もしこのパッケージが描画するモデルライン全体が必要な場合は、(modusregel-mode 1) の方が短く、同じ設定になります。


keycastとの連携

keycast は、最後に実行したコマンドをモデルラインに表示します。これは、フォーマットに独自の構成要素として追加することで modusregel と連携します。

(use-package keycast
  :ensure t
  :hook (after-init . keycast-mode)
  :config
  (define-minor-mode keycast-mode
    "Show current command and its key binding in the mode line."
    :global t
    (if keycast-mode
        (add-hook 'pre-command-hook 'keycast--update t)
      (remove-hook 'pre-command-hook 'keycast--update))))

(use-package modusregel
  :ensure (:host codeberg :repo "jjba23/modusregel" :branch "trunk")
  :after (keycast)
  :config
  (add-to-list 'modusregel-format '("" keycast-mode-line))
  (modusregel-mode 1))

Nyan Catやその他の追加機能と共に modusregel を使用している私のEmacs設定をご覧ください:

https://codeberg.org/jjba23/heks-emacs/src/branch/trunk/src/modules/emacs-core.el


テストと開発

プロジェクトには、test/modusregel-test.el にERTテストスイート、Maak ファイル、および test/modusregel-checkdoc.el に checkdoc ゲートが含まれています。maak がインストールされていれば、1つのコマンドで品質ゲート全体を実行できます。

maak

maak 単体で check を実行します。これは以下のことを行います:

  1. パッケージとそのテストスイートをバイトコンパイルし、警告をエラーとして扱います。これにより、新しい警告が発生するとゲートが失敗します。
  2. checkdoc を強制し、発見事項を報告し、発見があった場合は非ゼロで終了します。
  3. ERTスイートを実行します。

スイートはパッケージの形状をチェックします — すべての要素が文書化され、使用され、モデルラインが必要とするようにマークされ、有効な構造を描画しているか。すべてのカスタム値が宣言された型と一致しているか。顔が、存在しない顔から継承していないか — そして、要素ごと、および全体としてモデルラインを描画します。

最後の部分は注意が必要です。なぜなら、format-mode-line は非インタラクティブなEmacsでは空文字列を返すからです。これらのテストはバッチ実行ではスキップされ、スイートは別のEmacsで、独自のターミナルを与えて再度実行し、いずれかが失敗した場合は失敗します。モデルラインに関する何も信頼されていません。

その他のタスク: maak compile、maak test、maak lint、maak clean、maak repl(モデルラインが設定されたEmacs)、および maak tasks。


ライセンス

modusregel およびそのすべてのソースコードは、GNU General Public License v3(または都合の良い新しいバージョン)の下でライセンスされるフリーソフトウェアです。

https://www.gnu.org/licenses/gpl-3.0.html

modusregel に付属するドキュメントと例(このドキュメントを含む)はすべて、GNU Free Documentation License v1.3(または都合の良い新しいバージョン)の下でライセンスされます。

https://www.gnu.org/licenses/fdl-1.3.html


AIポリシー

このプロジェクトは、jointhefreeworld AI (人工知能) ポリシー を遵守しています。

私たちの中心的な原則はシンプルです:AIは人間の創造性と問題解決を支援すべきであり、人間の推論を置き換えるべきではありません。

大規模言語モデル(LLM)やインタラクティブチャットボットのようなツールは、レビュー、小規模関数のリファクタリング、またはブレインストーミングの相手として役立つ可能性がありますが、適度に使用されるべきです。

すべての貢献において、人間が関与することを要求します。このプロジェクトに自動生成されたプルリクエストを送信するために自律的なAIエージェントを使用することは固く禁じられています。


行動規範

このプロジェクトは、jointhefreeworld行動規範を遵守しています。こちらをご覧ください:

https://jointhefreeworld.org/blog/articles/personal/jointhefreeworld-code-of-conduct/index.html

要約すると、私たちは、このフリーソフトウェアプロジェクトのすべての貢献者とユーザーのために、包括的で、敬意を払い、協力的な環境を育みます。GNUプロジェクトの理想に触発され、自由、平等、そしてコミュニティを指針とする原則として維持することを目指しています。相互尊重のコミュニティにおける協力が、優れたフリーソフトウェアを作成するために不可欠であると信じています。


modusregelプロジェクト

フリーソフトウェアへの貢献は、寛大さ、協力、そしてエンパワーメントの原則を体現しているため、ユニークに美しい行為です。

modusregelプロジェクトへ、誰もが歓迎されていると感じてほしいと願っており、改善や改善の提案、私とのブレインストーミング、よりモジュール化/柔軟にすることなど、あらゆる形態での積極的な貢献を奨励します。チャット、議論、フィードバックの報告のために、私 jjbigorra@gmail.com に連絡してください。

私のEmacsパッケージのバックログとカンバンボードはこちらで見つけられます:https://lucidplan.jointhefreeworld.org/tickets/emacs-pkg