ArchWiki - 利用者の投稿記録 [ja]

Wayland

2025-04-18T13:59:19Z

がおびん: /* コンポジタ */

[[Category:グラフィカルユーザーインターフェイス]]
[[en:Wayland]]
[[es:Wayland]]
[[pt:Wayland]]
[[ru:Wayland]]
[[zh-hans:Wayland]]
{{Related articles start}}
{{Related|カーネルモード設定}}
{{Related|Xorg}}
{{Related|スクリーンショットの取得#Wayland}}
{{Related articles end}}

[https://wayland.freedesktop.org/ Wayland] はディスプレイサーバープロトコルです。[[Xorg|X Window System]] の後継となることを目指しています。[[Wikipedia:Wayland_(display_server_protocol)#Differences_between_Wayland_and_X|Wikipedia に Wayland と Xorg の比較]] が掲載されています。

Wayland プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。

ネイティブな X11 アプリケーションをシームレスに動かすための後方互換性として、[[#Xwayland|Xwayland]] を使うことができます。これは Wayland に X サーバを提供します。

== 要件 ==

ほとんどの Wayland コンポジタは、[[カーネルモード設定]]を利用しているシステムでのみ動作します。Wayland それ自体はグラフィカルな環境を提供しません。ゆえに、Wayland に加えてコンポジタ (以下のセクションを参照)、あるいは、コンポジタを含むデスクトップ環境 (例: [[GNOME]]、[[Plasma]]) が必要となります。

GPU ドライバと Wayland コンポジタは、同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。

{| class="wikitable"
! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート
|-
| GBM || [[NVIDIA]] < 495* 以外の全てのドライバー || 全て
|-
| EGLStreams || [[NVIDIA]] || [[GNOME]]
|}

: * Nvidia ≥ 495 は EGLStreams と GBM の両方をサポートします。[https://www.phoronix.com/scan.php?page=news_item&px=NVIDIA-495.44-Linux-Driver]

NVIDIA が GBM のサポートを導入して以来、NVIDIA ≥ 495 で多くのコンポジタ (Mutter と KWin を含む) がデフォルトで GBM を使用し始めました。GBM は一般的にベターでより幅広いサポートがあると考えられています。EGLStreams がサポートされていた理由は、NVIDIA GPU をプロプライエタリドライバで Wayland 下で使用する代替の方法を NVIDIA が提供しなかったからだけです。さらに、GBM が NVIDIA に導入された後、KWin は [https://invent.kde.org/plasma/kwin/-/merge_requests/1638 EGLStreams のサポートを打ち切りました]。

人気なデスクトップ環境/コンポジタと、NVIDIA によってまだサポートされている GPU を使用している場合、おそらくすでに GBM バックエンドを使用しています。確認するには、次を実行してください: {{ic|journalctl -b 0 --grep "renderer for"}}。GBM をバックエンドとして強制的に使用させるには、次の[[環境変数]]を設定してください:

GBM_BACKEND=nvidia-drm
__GLX_VENDOR_LIBRARY_NAME=nvidia

== コンポジタ ==

'''タイル型''', '''スタック型''', '''ダイナミック型''' の違いについては、[[ウィンドウマネージャ#種類]] を参照してください。

=== スタック型 ===

* {{App|[[Enlightenment]]|[[Enlightenment]]|[[Enlightenment#手動]] を参照してください。詳細: [https://git.enlightenment.org/enlightenment/enlightenment/src/branch/master/README.md] [https://www.enlightenment.org/about-wayland]|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
* {{App|hikari|FreeBSD で活発に開発されている [[cwm]] にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしています。|https://hikari.acmelabs.space/|{{AUR|hikari}}}}
* {{App|KDE [[w:KWin|KWin]]|[[KDE#Plasma の起動]] を参照。|https://userbase.kde.org/KWin|{{Pkg|kwin}}}}
* {{App|Liri Shell|[[Liri]] の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。|https://github.com/lirios/shell|{{AUR|liri-shell-git}}}}
* {{App|[[labwc]]|Openbox にインスパイアされた wlroots ベースのコンポジタ。|https://github.com/labwc/labwc|{{Pkg|labwc}}}}
* {{App|[[w:Mutter (software)|Mutter]]|[[GNOME#GNOME の起動]] を参照。|https://gitlab.gnome.org/GNOME/mutter|{{Pkg|mutter}}}}
* {{App|wayfire|[[Compiz]] にインスパイアされ、wlroots に基づく 3D コンポジタ。|https://wayfire.org/|{{AUR|wayfire}}}}
* {{App|[[Weston]]|正しさ、信頼性、予測可能性、性能のために設計された Wayland コンポジタ。|https://gitlab.freedesktop.org/wayland/weston|{{Pkg|weston}}}}
* {{App|wio|Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。|https://gitlab.com/Rubo/wio|{{AUR|wio-wl}}}}

=== タイル型 ===

* {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}}}}
* {{App|niri|スクロール可能なタイル型 Wayland コンポジタ。|https://github.com/YaLTeR/niri/|{{Pkg|niri}}}}
* {{App|Polonium|[[KDE]] 6 上でタイル型ウィンドウを使用できる、Bismuth の後継。|https://github.com/zeroxoneafour/polonium|{{AUR|kwin-polonium}}}}
* {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}}
* {{App|[[Sway]]|wlroots ベースの [[i3]] 互換 Wayland コンポジタ。|https://github.com/swaywm/sway|{{Pkg|sway}}}}
* {{App|SwayFx|魅力的な視覚効果機能を追加した [[Sway]]。|https://github.com/WillPower3309/swayfx|{{AUR|swayfx}}}}
* {{App|Velox|swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。|https://github.com/michaelforney/velox|{{AUR|velox-git}}}}

=== ダイナミック型 ===

* {{App|[[dwl]]|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://codeberg.org/dwl/dwl|{{AUR|dwl}}}}
* {{App|[[Hyprland]]|見た目を犠牲にしないダイナミックなタイリング Wayland コンポジタ。|https://hyprland.org|{{Pkg|hyprland}}}}
* {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}}
* {{App|[[river]]|dwm と [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://codeberg.org/river/river|{{Pkg|river}}}}
* {{App|Vivarium|wlroots を使用するダイナミックタイル型 Wayland コンポジタ。[[xmonad]] にインスパイアされたデスクトップセマンティクスを持ちます。|https://github.com/inclement/vivarium|{{AUR|vivarium-git}}}}

=== その他 ===

* {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。|https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}}
* {{App|nwg-shell|Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。|https://github.com/nwg-piotr/nwg-shell|{{Pkg|nwg-shell}}}}
* {{App|kiwmi|完全にプログラミング可能な Wayland コンポジタ。|https://github.com/buffet/kiwmi|{{AUR|kiwmi-git}}}}
* {{App|phoc|モバイル端末のための wlroots ベースの小さなコンポジタ。|https://gitlab.gnome.org/World/Phosh/phoc|{{Pkg|phoc}}}}

上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。
それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。

== ディスプレイマネージャ ==

Wayland コンポジタの実行をサポートしている[[ディスプレイマネージャ]]は以下の表の通りです。

{| class="wikitable sortable"
! 名前
! 何で動作するか
! 説明
|-
| {{Pkg|emptty}}
| TTY
| TTY で動作するシンプルな CLI ディスプレイマネージャ。
|-
| [[GDM]]
| Wayland/Xorg
| [[GNOME]] ディスプレイマネージャ。
|-
| [[greetd]]
| Wayland/Xorg/TTY
| 最小でありながら柔軟なログインデーモン。
|-
| {{Pkg|lemurs}}
| TTY
| Rust で書かれた TUI ディスプレイマネージャ。
|-
| [[LightDM]]
| Xorg[https://github.com/canonical/lightdm/issues/267]
| 様々なデスクトップに対応したディスプレイマネージャ。
|-
| [[Ly]]
| TTY
| C で書かれた TUI ディスプレイマネージャ。
|-
| [[SDDM]]
| Wayland/Xorg
| QML ベースのディスプレイマネージャ。
|-
| [[tbsm]]
| TTY
| bash のみに依存するシンプルな CLI セッションランチャー。
|-
| [[Universal_Wayland_Session_Manager|UWSM]]
| TTY
| Systemd のメカニズムを使用するスタンドアローンなコンポジタのための、セッションと XDG autostart のマネージャ。
|}

== Xwayland ==

[https://wayland.freedesktop.org/xserver.html Xwayland] は、Wayland の下で実行される X サーバーで、Wayland サポートをまだ提供していないネイティブな [[X11]] アプリケーションに互換性を提供します。これを使用するには、{{Pkg|xorg-xwayland}} パッケージを[[インストール]]します。

Xwayland はコンポジタを介して開始されるため、あなたの使用しているコンポジタのドキュメントを読み、Xwayland との互換性についてや、Xwayland の起動方法に関する指示を確認しておく必要があります。

{{Note|
* セキュリティ: Xwayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
* パフォーマンス: Xwayland は X11 と[https://openbenchmarking.org/result/2202053-NE-NVIDIARTX35 ほぼ同等のパフォーマンス]を発揮します。しかし、一部のケースで (特に NVIDIA カード上で) パフォーマンスの低下を感じるかもしれません。
* 互換性: Xwayland は X11 と完全な後方互換性があるわけではありません。一部のアプリケーションは Xwayland 下では正しく動作しない場合があります。}}

=== NVIDIA ドライバ ===

{{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェア支援のある Xwayland をサポートしておらず、非 Wayland ネイティブなアプリケーションは Wayland セッションでのパフォーマンスが低下します。}}

なお、[[NVIDIA#DRM カーネルモード設定|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://download.nvidia.com/XFree86/Linux-x86_64/515.48.07/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。

=== Kwin Wayland デバッグコンソール ===

{{pkg|kwin}} を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。

$ qdbus6 org.kde.KWin /KWin org.kde.KWin.showDebugConsole

=== Xwayland アプリケーションであることを視認する ===

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。
アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。

または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。

他の方法として、({{Pkg|xorg-xwininfo}} の) ''xwininfo'' をターミナルウィンドウで実行するというものがあります。Xwayland ウィンドウ上にマウスポインタをホバーすると、マウスポインタが + マークに変わります。ウィンドウをクリックすると、xwininfo は情報を表示して終了しますが、ネイティブな Wayland ウィンドウでは何も起こりません。{{ic|Ctrl+C}} を押すことで xwininfo を終了できます。

あるいは、''xlsclients'' ({{Pkg|xorg-xlsclients}} パッケージ) を使用することもできます。Xwayland で動作中のアプリケーションを全てリストアップするには、{{ic|xlsclients -l}} を実行してください。

== GUI ライブラリ ==

[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] で詳細を確認してください。

=== GTK ===

{{Pkg|gtk3}} と {{Pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。GTK ではデフォルトで Wayland バックエンドを使いますが、[[環境変数]]を設定することで Xwayland を使うように上書きできます: {{ic|1=GDK_BACKEND=x11}}。

テーマの問題は [[GTK#Wayland バックエンド]] を見てください。

=== Qt ===

[[Qt]] 5 または 6 で Wayland のサポートを有効化するには、Qt 5 と 6 に対してそれぞれ {{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。これで、Qt アプリケーションは Wayland セッション上では Wayland で動作するようになります。

必須ではないはずですが、明示的に Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。

一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} と設定してください。これは、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。
また、{{ic|1=QT_QPA_PLATFORM="wayland;xcb"}} を使用すると、Qt が Wayland を利用できない場合に、代わりに xcb (X11)プラグインを使用させることができます。[https://www.qt.io/blog/2018/05/29/whats-new-in-qt-5-11-for-the-wayland-platform-plugin]

[[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、[https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、{{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。

=== Clutter ===

Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。

Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|1=CLUTTER_BACKEND=wayland}} を設定する必要があります。

=== SDL2 ===

SDL2 アプリケーションを Wayland 上で動作させるには、{{ic|1=SDL_VIDEODRIVER=wayland}} を設定してください。

{{ic|1=SDL_VIDEODRIVER="wayland,x11"}} とすることにより、Wayland が利用できない場合に代わりに X11 ビデオドライバを使用するように SDL2 を設定できます [https://wiki.libsdl.org/SDL2/FAQUsingSDL]。ウィンドウ装飾を有効化するために {{Pkg|libdecor}} をインストールすると良いかもしれません (例えば、GNOME で)。

=== GLFW ===

{{Pkg|glfw}} パッケージには Wayland に対するサポートがあります。{{ic|1=XDG_SESSION_TYPE}} が {{ic|1=wayland}} に設定されていて、かつアプリケーションの開発者が特定のバックエンドを使用するようにしていなければ、Wayland バックエンドが使用されます。

詳細は GLFW の[https://github.com/glfw/glfw/blob/3.4/src/platform.c#L87-L99 ソースコード]を参照してください。

=== GLEW ===

{{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。

=== EFL ===

EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。

=== winit ===

Winit は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、環境変数を設定することで Xwayland を使うように上書きすることができます:

* バージョン 0.29.2 より前の場合、{{ic|1=WINIT_UNIX_BACKEND=x11}} を設定してください。
* バージョン 0.29.2 以降の場合、{{ic|1=WAYLAND_DISPLAY}} を unset してください。そうすることで、強制的に {{ic|1=DISPLAY}} 変数を使用して X にフォールバックされます。[https://github.com/rust-windowing/winit/blob/baf10de95843f156b0fbad6b10c3137f1ebd4f1e/src/changelog/v0.29.md?plain=1#L134]

=== Electron ===

Wayland サポートを有効化する方法は次の2つです: アプリケーションごとのコマンドラインフラグを使って有効化するか、設定ファイルを使ってグローバルに有効化するかです。

アプリケーションがどの electron バージョンを使用しているか確認する方法については [https://stackoverflow.com/q/50345957] を見てください。

{{Note|Plasma では、一部の Electron アプリケーションで間違ったアイコン (デフォルトの Wayland アイコン) がウィンドウに表示され、一方タスクバーには正しいアイコンが表示されることがあります。この問題は、デスクトップファイルの名前を強制する特殊なアプリケーション/ウィンドウルールを作成することで解決できます。}}

==== 環境変数 ====

Electron 28 及びそれ以降を使用するアプリケーションは、[[環境変数]] [https://www.electronjs.org/docs/latest/api/environment-variables#electron_ozone_platform_hint-linux ELECTRON_OZONE_PLATFORM_HINT] を {{ic|auto}} または {{ic|wayland}} に設定することで、Wayland モードを使用することができます。

コマンドラインフラグは、この環境変数より優先されます。

==== コマンドラインフラグ ====

Electron がベースとしている Chromium とは異なり、Electron アプリケーションはデフォルトで PipeWire による WebRTC 画面共有を有効化しません。なので、Wayland 上で画面共有の問題を防ぐために {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を使用することが推奨されます。画面共有は {{Pkg|xdg-desktop-portal}} をベースとしています。

環境変数を使うことが望ましくない、または不可能である場合に、{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、Electron 20 以降では {{ic|1=--ozone-platform-hint=auto}} フラグを使用することで可能です。

トップバーが消失してしまう場合、{{ic|1=--enable-features=WaylandWindowDecorations}} フラグを使用することで解決します。これは、典型的には [[GNOME]] で必須です ([https://github.com/electron/electron/pull/29618 electron17] からsパオートされています)。

これらのフラグを永続的に設定する方法は2つあります。1つ目は、アプリケーションの [[デスクトップエントリ#desktop ファイルの変更|.desktop ファイルを変更]]して {{ic|1=Exec=}} 行の末尾にフラグを追加する方法。もう一つは、以下で説明している設定ファイルを使用する方法で、こちらはよりきれいに設定できます。

{{Note|一部のアプリケーションは、Electron に対してフラグを渡さないため、そのアプリケーションの開発者が解決策を実装する必要があります。}}

==== 設定ファイル ====

Electron 系のパッケージは {{ic|1=~/.config/electron''XX''-flags.conf}} を読み込みます。ここで、''XX'' は Electron のバージョンです。該当するバージョンのファイルが存在しない場合、{{ic|1=~/.config/electron-flags.conf}} を代わりに読み込みます。

前述のフラグを一行ずつ書き込んでください:

{{hc|~/.config/electron-flags.conf|2=
--enable-features=WaylandWindowDecorations
--ozone-platform-hint=auto
}}

{{Note|このような設定ファイルは、公式リポジトリ内の Electron のパッケージと、それらの設定ファイルを使用するパッケージでのみ機能します。{{AUR|slack-desktop}} などのような Electron の独自のビルドをバンドルしているパッケージでは機能しません。{{AUR|slack-electron}} のように代替のパッケージが存在する場合があります。}}

==== 古い Electron バージョン ====

{{ic|electron25-flags.conf}} は Electron バージョン 25 に対してだけ適用されます。それより古い Electron のバージョンは {{ic|electron<バージョン>-flags.conf}} ファイルで設定できます。

古いバージョンでは、対応する Chromium バージョンによって異なるフラグが必要になる場合があります。例えば、以下のフラグは Electron 13 で機能します:

{{hc|~/.config/electron13-flags.conf|2=
--enable-features=UseOzonePlatform
--ozone-platform=wayland
}}

=== Java ===

[[Java]] プラットフォームのオープンソース実装である OpenJDK は、まだ Wayland のネイティブサポートを備えていません。
OpenJDK に Wayland を実装することを目的としたプロジェクトである [https://openjdk.java.net/projects/wakefield/ Wakefield] が実用できるようになるまでは、Xwayland を代わりに使用できます。

[[Debian:Wayland#Java Programs (supported since OpenJDK 16?)]] を参照してください:

:OpenJDK 16から、JRE は (Wayland をサポートしている) GTK3 を動的にロードできるようになりました。この[https://stackoverflow.com/questions/39197208/java-gui-support-on-wayland 議論]によると、これがサポートされているかもしれません。
:{{ic|_JAVA_AWT_WM_NONREPARENTING}} [[環境変数]]を "1" に設定することで、アプリケーションが空白の画面で起動する不具合を修正することができます。

== ヒントとテクニック ==

=== 自動化 ===

* [https://github.com/ReimuNotMoe/ydotool ydotool] ({{Pkg|ydotool}}) - 汎用のコマンドラインツール (wayland 以外でも利用可能)。{{ic|ydotool.service}} [[ユーザーユニット]]を[[起動/有効化]]してください。{{man|8|ydotoold}}、{{man|1|ydotool|url=https://github.com/ReimuNotMoe/ydotool/blob/master/manpage/ydotool.1.scd}} を参照。
* [https://github.com/atx/wtype wtype] ({{Pkg|wtype}}) - Wayland 用 xdotool type。{{man|1|wtype}} を参照。
* [https://github.com/boppreh/keyboard keyboard] - Windows と Linux で動作する Python ライブラリ。実験的な OS X サポートあり。[https://github.com/boppreh/mouse mouse] ライブラリも参照。
* [https://git.sr.ht/~brocellous/wlrctl wlrctl] ({{AUR|wlrctl}}) - 雑多な wlroots 拡張のためのコマンドラインユーティリティ (foreign-toplevel-management、virtual-keyboard、virtual-pointer をサポート)。

=== キーボードやマウスキーのリマップ ===

[[入力リマップユーティリティ]] を見てください。

=== X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする ===

[[スクリーンキャプチャ#X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする]] を見てください。

=== Chromium で完全に最大化出来ない ===

chrome://settings/appearance ''メニューから'' Use system title bar and borders'' を有効にする必要があります。

=== Waylandコンポジタをsystemdサービスとして自動的に起動する ===
{{Note|この設定はdbusセッションを破壊し,[[PipeWire#WebRTC 画面共有]]を破壊するかも知れません.}}
ディスプレイマネージャーやシェルを使いたくなければ、Waylandコンポジタを[[systemd]]サービスを使って自動的に起動できます。{{ic|ExecStart}}行を使いたいコンポジタに変えて下さい:

{{hc|/etc/systemd/system/wayland-compositor.service|2=
[Unit]
After=graphical.target systemd-user-sessions.service modprobe@drm.service
Conflicts=getty@tty1.service

[Service]
User=''username''
WorkingDirectory=~

PAMName=login
TTYPath=/dev/tty1
UnsetEnvironment=TERM

StandardOutput=journal
ExecStart=/bin/labwc -s gtklock

[Install]
WantedBy=graphical.target
}}

{{Note|[[セキュリティ#物理セキュリティ]]の為に、{{Pkg|swaylock}}や{{Pkg|gtklock}}等のスクリーンロッカーを、コンポジタの設定を通して自動的に起動する必要があるかも知れません。}}

==トラブルシューティング==

=== 色補正 ===

[[バックライト#色補正]]を参照。

=== 動作が遅い、表示がおかしい、クラッシュする ===

Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} や rc ファイルから該当箇所を削除してみてください。

=== リモートディスプレイ ===

* ([[sway]] で使用されている) {{pkg|wlroots}} は、バージョン 0.10 より、{{Pkg|wayvnc}} を使って VNC バックエンドを提供しています。RDP バックエンドは削除されました [https://github.com/swaywm/wlroots/releases/tag/0.10.0]。
* {{pkg|mutter}} はコンパイル時にリモートデスクトップが有効化されています。詳細は [https://wiki.gnome.org/Projects/Mutter/RemoteDesktop] と {{Pkg|gnome-remote-desktop}} を見てください。
* {{pkg|krfb}} は {{pkg|kwin}} に VNC サーバを提供します。{{ic|krfb-virtualmonitor}} を使えば、他のデバイスを外部モニタとしてセットアップすることが可能です。
* 2013年に FreeRDP が Weston にマージされました。コンパイルフラグで有効化されています。{{Pkg|weston}} パッケージは、バージョン 6.0.0 より、FreeRDP が有効化されています。
* {{Pkg|waypipe}} は Wayland アプリケーションの透過プロキシです。[[SSH]] 上で動作するラッパーコマンドあり。
** 以下は、Plasma デスクトップでリモートの KDE kcalc を起動する例です:
$ waypipe ssh example.local env QT_QPA_PLATFORM=wayland-egl QT_QPA_PLATFORMTHEME=KDE dbus-launch kcalc

=== ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力捕捉 ===

Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません (例: [https://tronche.com/gui/x/xlib/input/XGrabKeyboard.html キーボード]、[https://tronche.com/gui/x/xlib/input/XGrabPointer.html マウス])。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。

入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:

* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。

Wayland と Xwayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。Xorg アプリケーションの場合、Xwayland のサポートで十分であるため、アプリケーションやウィジェット・ツールキットに変更を加える必要はありません。

これらの拡張はすでに {{pkg|wayland-protocols}} に含まれており、{{pkg|xorg-xwayland}} によってサポートされています。

関連する拡張:

* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml Xwayland keyboard grabbing protocol]
* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]

サポートしている Wayland コンポジタ:

* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以降)。
* wlroots (Relative pointer protocols と Pointer constraints protocol に対応)
* Kwin
** [[KDE#Wayland で X11 のショートカットが衝突する]]
** [https://invent.kde.org/plasma/kwin/-/blob/master/src/wayland/keyboard_shortcuts_inhibit_v1_interface.cpp Keyboard shortcuts inhibit]

サポートしているウィジェットツールキット:

* GTK (リリース 3.22.18 以降)

=== GTK テーマが動かない ===

https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。

=== NVIDIA モジュールを読み込まないようにする ===

[[sway]] などの Wayland コンポジターを起動する前に {{ic|1=__EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/50_mesa.json}} を [[環境変数]] として追加します。

=== 拡大/サーフェススケーリング ===

スクリーンの拡大は、まだ解決していません。[https://gitlab.freedesktop.org/wayland/wayland-protocols/-/merge_requests/145 wp-surface-scale プロトコルを提供する]プルリクエストが2022年半ばにマージされました。

=== カーネル 6.11.2 (AMD) 以降、Wayland にラグ/スタッタリングが発生する ===

将来のカーネルリリースでこの問題が修正されるまで、回避策は、コマンドラインに {{ic|1=amdgpu.dcdebugmask=0x400}} を追加することです。

こちらを参照: https://community.frame.work/t/wayland-lag-stuttering-since-kernel-6-11-2/59422

== 参照 ==

* [https://wayland.freedesktop.org/docs/html/ Wayland オンラインドキュメント]
* [https://gitlab.freedesktop.org/wayland 公式リポジトリ]
* [[Fedora:How to debug Wayland problems]]
* [https://arewewaylandyet.com/ Are we Wayland yet?]
* [https://awesomeopensource.com/projects/wayland Awesome Wayland projects]
* [[カーソルテーマ]]
* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
* [https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives]
* [https://wayland.app/protocols/ Wayland Explorer - A better way to read Wayland documentation]
* [https://askubuntu.com/questions/1393618/how-can-i-tell-if-an-application-is-using-xwayland How can I tell if an application is using XWayland]

{{TranslationStatus|Wayland|2024-08-24|814878}}

Rdesktop

2024-04-15T09:12:30Z

がおびん: freerdp が rdesktop の別ブランチであることを明記

[[Category:リモートデスクトップ]]
[[en:Rdesktop]]
{{Related articles start}}
{{Related|xrdp}}
{{Related|Remmina}}
{{Related articles end}}
{{Note|上流の rdesktop プロジェクトでは、[https://groups.google.com/forum/#!topic/rdesktop-announce/AddglSNxK90 新しいメンテナを募集しています]。それまでの間は、そのプロジェクトの別ブランチである {{pkg|freerdp}} を使うことをお勧めします。両プロジェクトの歴史に関する説明と、両プロジェクトがどのように結びついているかを見るには、[https://www.freerdp.com/2019/01/16/hi-freerdp-history ここ]をご覧ください。}}
[http://www.rdesktop.org/ rdesktop] は Microsoft のプロプライエタリな RDP プロトコルのフリーでオープンソースなクライアントで GNU General Public License の下でリリースされています。rdesktop を使って Windows 2000/XP/Vista/Win7 の RDP サーバーに接続して Windows PC をリモートで管理することができます。

2008年7月現在、rdesktop は RDP 5 の大部分を実装していて、以下のような機能が含まれます:

* ビットマップキャッシュ
* ファイルシステム、オーディオ、シリアルポート、プリンタポートのリダイレクト
* 多数の各国語キーボードのマッピング
* ストリーム圧縮と暗号化
* 自動認証
* スマートカードのサポート
* SeamlessRDP による RemoteApp のような"シームレス"モードのサポート

以下の機能はまだ実装されていません:

* リモートアシスタンスの要求
* USB デバイスのリダイレクト

RDP 5.1 や RDP 6 で追加された機能のサポート (マルチヘッドディスプレイ表示やウィンドウコンポジション) もまだ実装されていません。

== インストール ==

{{Pkg|rdesktop}} パッケージを[[pacman|インストール]]してください。

== 使用方法 ==

オプションの完全なリストについては {{man|1|rdesktop}} の man ページを見て下さい。下は典型的な使用例になります:
$ rdesktop -g 1440x900 -P -z -x l -r sound:off -u windowsuser 98.180.102.33:3389

左から右に意味を解説すると:

{| class="wikitable"
| -g 1440x900 || ディスプレイの解像度を 1440x900 に設定。
|-
| -P || ビットマップキャッシュの有効化・変換の高速化。
|-
| -z || RDP データストリームの圧縮を有効化。
|-
| -x l || "lan" 品質レベルを使う、他のオプションについては man ページを見て下さい。
|-
| -r sound:off || サーバーで生成されたサウンドを null にリダイレクト。
|-
| -u windowsuser || Windows PC にログインするときに使用するユーザー名を定義します。
|-
| 98.180.102.33:3389 || 対象マシンの IP アドレスとポート番号。
|}

== ヒントとテクニック ==

=== 自動スケーリング ===

画面にあわせて自動スケールするようにするには、rdekstop のコマンドラインに次を渡して下さい:
{{bc|<nowiki>
-g $(xrandr -q | awk '/Screen 0/ {print int($8/1.28) $9 int($10/1.2)}' | sed 's/,//g')
</nowiki>}}

"-g" フラグを使う方法もあります:
$ rdesktop -g 100% -P -z 98.180.102.33:3389

=== IP アドレスの代わりに NetBIOS 名を使う ===

ネットワークの Windows コンピュータの IP アドレスがわからない場合、wins サポートを有効にする必要があります。そのためには、[[samba]] をインストールしてください。samba で wins を有効にするのは驚くほど簡単です: {{ic|/etc/samba/smb.conf}} を編集して次の行を追加するか適当な行をアンコメントしてください:

wins support = yes

そして winbind をインストールして、{{ic|/etc/nsswitch.conf}} を編集してホストのリストに "wins" を追加してください。

{{ic|smb}} と {{ic|nmb}} サービスを再起動して Windows の NetBIOS ホストに ping を送信してテストしてください。

=== 表示されないカーソルを補う ===

[[カーソルテーマ#欠けているカーソルを補う]]を参照。

== 参照 ==

* [http://www.rdesktop.org/ rdesktop 公式ホームページ]
*{{Pkg|freerdp}}: ネットワークレベル認証 (Network Level Authentication, NLA) など RDP 7.1 の機能をサポートした rdesktop のフォーク。[https://askubuntu.com/a/97932/217269] も参照。

フォント

2024-03-14T09:03:43Z

がおびん: /* インストールした全てのフォントを一覧する */ font-manager による字体確認を追記。

[[Category:フォント]]
[[Category:グラフィックとデスクトップパブリッシング]]
[[de:Schriftarten]]
[[en:Fonts]]
[[es:Fonts]]
[[uk:Fonts]]
[[zh-hans:Fonts]]
{{Related articles start}}
{{Related|フォント設定}}
{{Related|Java 実行環境のフォント}}
{{Related|MS フォント}}
{{Related|メトリック互換フォント}}
{{Related articles end}}
[[Wikipedia:ja:フォント|Wikipedia]] より:
:「コンピュータのフォントは、グラフィカルなグリフのセットを含むデジタルデータファイルとして実装されている。コンピュータフォントは、フォントエディタを用いて設計・作成される。コンピュータの画面用に特別に設計されたフォントで、印刷用ではないものをスクリーンフォントという。」

なお、フォントのライセンスによっては、法的な制約を受ける場合があります。

== フォントフォーマット ==

今日使われるほとんどのコンピュータフォントは''ビットマップ''か''アウトライン''データフォーマットになっています。
;ビットマップフォント: ドットやピクセルのマトリックスで構成され、それぞれの文字のイメージを表示します。
;アウトラインまたは''ベクター''フォント: ベジェ曲線を使ってそれぞれの文字を表示します。文字はさまざまなサイズにスケールすることができます。

=== ビットマップフォーマット ===

* Adobe による [[Wikipedia:Glyph Bitmap Distribution Format|Bitmap Distribution Format]] (BDF)
* Xorg による [[Wikipedia:Portable Compiled Format|Portable Compiled Format]] (PCF)
* カーネルがコンソールフォントで使用する [[Wikipedia:PC Screen Font|PC Screen Font]] (PSF) (Xorg はサポートしておらず Unicode の PSF ファイルの拡張子は {{ic|psfu}} です)。

上記のフォーマットは gzip で圧縮することができます。利用可能なビットマップフォントは[[#ビットマップ]]を見てください。

=== アウトラインフォーマット ===

* Adobe による [[Wikipedia:ja:PostScriptフォント|PostScript フォント]] – 様々なフォーマットがあります。例: Printer Font ASCII (PFA) と Printer Font Binary (PPB)。
* Apple と Microsoft による [[Wikipedia:ja:TrueType|TrueType]] (ファイル拡張子: {{ic|ttf}})
* TrueType を基に Microsoft によって開発された [[Wikipedia:ja:OpenType|OpenType]] (ファイル拡張子: {{ic|otf}}, {{ic|ttf}})

多くの場合、TrueType と OpenType の技術的な差異は無視することができます。実際 {{ic|ttf}} 拡張子を持つフォントでも OpenType フォントであることがあります。

=== 他のフォーマット ===

組版アプリケーションの ''TeX'' と、それに組み合わせるフォントソフトウェアの ''Metafont'' は独自の方法で文字をレンダリングします。この2つのプログラムでフォントとして使われるファイル拡張子に {{ic|*pk}}, {{ic|*gf}}, {{ic|mf}} と {{ic|vf}} があります。

''FontForge'' はオープンソースのフォント作成プログラムであり、作られたフォントには {{ic|sfd}} (''s''pline ''f''ont ''d''atabase) というテキストベースのフォーマットが使われます。

[http://www.w3.org/TR/SVG/fonts.html SVG] フォーマットにも独自にフォントを表示するための機能があります。

== インストール ==

フォントをインストールする方法は複数あります。

=== Pacman ===

フォントとそのコレクションは [[pacman]] を使って(有効にした)リポジトリからインストールすることができます。利用できるフォントを探すには次を実行:
$ pacman -Ss font
また {{ic|ttf}} フォントのみを探す場合は:
$ pacman -Ss ttf

=== パッケージを作成 ===

pacman であなたのフォントを管理したいと思ったならば、あなた自身で Arch パッケージを作ることができます。作ったパッケージは [[AUR]] コミュニティで共有することもできます。既存の [https://git.archlinux.org/svntogit/packages.git/tree/trunk/PKGBUILD?h=packages/adobe-source-code-pro-fonts パッケージ] が参考になるでしょう。パッケージの作成について詳しく学びたいならば、[[パッケージの作成]]を読んでください。

ttf フォントからパッケージを簡単に作る方法として {{AUR|makefontpkg}} を使うこともできます。

フォントファイルのファミリー名は {{ic|fc-query}} を使うことで確認できます。例: {{ic|fc-query -f '%{family[0]}\n' /path/to/file}}。

=== 手動インストール ===

リポジトリにないフォントを追加するときに推奨されるのは[[#パッケージを作成|パッケージを作成]]することです。pacman によってフォントを削除・アップデートできるようになります。しかしながらフォントを手動でインストールすることも可能です。

または、フォントを手動でインストールすることもできます。

* シングルユーザーの場合、フォントは {{ic|~/.local/share/fonts/}} にインストールします。
** 多くの場合、他のユーザーとしてグラフィカルなアプリケーションを実行しない限り、これで十分です。
** 過去には {{ic|~/.fonts/}} が使われていましたが、現在は非推奨です。
* システム全体 (全ユーザー) にインストールする場合は、{{ic|/usr/local/share/fonts/}} の下にフォントを配置します。
** 先にディレクトリを作成する必要があるかもしれません: {{ic|mkdir -p /usr/local/share/fonts}}
** {{ic|/usr/share/fonts/}} はパッケージマネージャの権限下にあり、手動で変更するべきではありません。

サブディレクトリ構造の作成はユーザー次第であり、Linux ディストリビューションによって異なります。わかりやすくするために、各フォントをそれ自身のディレクトリに置くとよいでしょう。Fontconfig はデフォルトのパスを再帰的に検索し、ネストしたファイルを確実に拾います。

構造の例は次のとおりです:

{{bc|
/usr/local/share/fonts/
├── otf
│   └── SourceCodeVariable
│   ├── SourceCodeVariable-Italic.otf
│   └── SourceCodeVariable-Roman.otf
└── ttf
├── AnonymousPro
│   ├── Anonymous-Pro-B.ttf
│ ├── Anonymous-Pro-I.ttf
│   └── Anonymous-Pro.ttf
└── CascadiaCode
   ├── CascadiaCode-Bold.ttf
   ├── CascadiaCode-Light.ttf
└── CascadiaCode-Regular.ttf
}}

フォントファイルには、すべてのユーザーに対して十分な読み取り権限を与える必要があります。ファイルの場合は {{ic|444}} 、ディレクトリの場合は {{ic|555}} が必要です。

Xserver がフォントを直接読み込むためには (''フォントサーバ'' の使用とは対照的に)、新しく追加したフォントのディレクトリを FontPath エントリで追加する必要があります。このエントリは [[Xorg#設定|Xorg 設定ファイル]] の ''Files'' セクションにあります (例: {{ic|/etc/X11/xorg.conf}} や {{ic|/etc/xorg.conf}}) 詳しくは [[フォント#古いアプリケーション]] を見て下さい。

それから fontconfig フォントキャッシュをアップデートします (通常は fontconfig ライブラリを使用するアプリケーションが実行するため必要ありません):

$ fc-cache -vf

=== 古いアプリケーション ===

古いアプリケーション (例: GTK+ 1.x アプリケーション、{{ic|xfontsel}}) を使う場合、fontconfig をサポートしていないので、インデックスをフォントディレクトリに作る必要があります:

$ mkfontscale
$ mkfontdir

もしくは次のコマンドで複数のフォルダを含めます:

$ for dir in /font/dir1/ /font/dir2/; do xset +fp $dir; done && xset fp rehash

{{ic|/usr/share/fonts}} 下のバラバラのサブディレクトリにフォントをインストールした場合:

$ for dir in * ; do if [ -d "$dir" ]; then cd "$dir";xset +fp "$PWD" ;mkfontscale; mkfontdir;cd .. ;fi; done && xset fp rehash

X サーバーがフォントディレクトリの読み込みに失敗したときは全ての {{ic|fonts.dir}} ファイルを再スキャンしてください:

# xset +fp /usr/share/fonts/misc # Inform the X server of new directories
# xset fp rehash # Forces a new rescan

フォントが読み込まれたのかチェックするには:

$ xlsfonts | grep fontname

{{note|ほとんどのパッケージはインストール時に Xorg がフォントを使えるように自動的に設定を行います。その場合、この手順は不要です。}}

[[Xorg]] で新しくインストールしたフォントを使うには、フォントパスを {{ic|/etc/X11/xorg.conf}} (他の X.Org 設定ファイルでも動きます) に加える必要があります。

以下は {{ic|/etc/X11/xorg.conf}} に追加するセクションの例です。あなたの必要なフォントにあわせてパスを追加・削除してください。
# Let X.Org know about the custom font directories
Section "Files"
FontPath "/usr/share/fonts/100dpi"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/cantarell"
FontPath "/usr/share/fonts/cyrillic"
FontPath "/usr/share/fonts/encodings"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/truetype"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/util"
EndSection

=== Pango の Warning ===
[http://www.pango.org/ Pango] を使っていると、pango が [https://www.freedesktop.org/wiki/Software/fontconfig fontconfig] を読み込んでフォントを選ぼうとすることがあります。

(process:5741): Pango-WARNING **: failed to choose a font, expect ugly output. engine-type='PangoRenderFc', script='common'
(process:5741): Pango-WARNING **: failed to choose a font, expect ugly output. engine-type='PangoRenderFc', script='latin'

上記のようなエラーや、アプリケーションで文字の代わりに豆腐が表示された場合、フォントを追加してフォントキャッシュをアップデートする必要があります。この例では {{Pkg|ttf-liberation}} フォントがあげられていて root 権限でシステム全体で有効にします。

# pacman -S ttf-liberation
-- インストールが成功したと仮定して出力は省略します --

# fc-cache -vfs
/usr/share/fonts: caching, new cache contents: 0 fonts, 3 dirs
/usr/share/fonts/TTF: caching, new cache contents: 16 fonts, 0 dirs
/usr/share/fonts/encodings: caching, new cache contents: 0 fonts, 1 dirs
/usr/share/fonts/encodings/large: caching, new cache contents: 0 fonts, 0 dirs
/usr/share/fonts/util: caching, new cache contents: 0 fonts, 0 dirs
/var/cache/fontconfig: cleaning cache directory
fc-cache: succeeded

フォントが設定されたかテストするには:

# fc-match
LiberationMono-Regular.ttf: "Liberation Mono" "Regular"

==フォントパッケージ==
以下は、公式リポジトリや [[Arch User Repository|AUR]] から入手できる多くのフォントパッケージを精選したリストです。Unicode をサポートしているフォントには [[wikipedia:unicode|Unicode 対応]] と添えています。

{{Tip|[https://github.com/ternstor/distrofonts Archfonts] は公式リポジトリや AUR にあるすべての TTF フォントの概要を生成するために使用できる Python スクリプトです。}}

=== ビットマップ ===

{{Note|{{Pkg|pango}} 1.44 は、 [https://blogs.gnome.org/mclasen/2019/05/25/pango-future-directions/ FreeType のサポートをやめ HarfBuzz を採用したため、] [https://blogs.gnome.org/mclasen/2019/08/07/pango-1-44-wrap-up/ 従来の BDF/PCF ビットマップフォントへのサポートがなくなり] 一部のアプリケーション ({{Pkg|gnome-terminal}} など) では、グリフではなく矩形を表示してフォントが機能しなくなりました。 {{Bug|63297}}, [https://gitlab.gnome.org/GNOME/pango/issues/386 Pango issue #386] と [https://github.com/harfbuzz/harfbuzz/issues/1897 HarfBuzz issue #1897] を参照して下さい。}}
* Default 8x16
* [https://github.com/seraxis/pcf-spectrum-berry Berry] ({{AUR|pcf-spectrum-berry}}) – 8px
* [https://www.dcmembers.com/jibsen/download/61/ Dina] ({{Pkg|dina-font}}) – Proggy ベースの 8px, 10px, 12px
* [http://openlab.jp/efont/unicode/ Efont] ({{AUR|efont-unicode-bdf}}) – 10px, 12px, 14px, 16px, 24px, normal, bold italic
* [http://font.gohu.org/ Gohu] ({{AUR|gohufont}}) – 11px, 14px, normal, bold
* [http://artwizaleczapka.sourceforge.net/ Lime] ({{AUR|artwiz-fonts}})
* [https://tobiasjung.name/profont/ ProFont] ({{AUR|ttf-profont-iix}}) – 10px, 11px, 12px, 15px, 17px, 22px, 29px, normal
* [[Wikipedia:Proggy programming fonts|Proggy]] ({{AUR|proggyfonts}}) – 様々なタイプがあります
* [http://www.fial.com/~scott/tamsyn-font/ Tamsyn] ({{Pkg|tamsyn-font}})
* [http://terminus-font.sourceforge.net/ Terminus] ({{Pkg|terminus-font}})
* [https://github.com/lucy/tewi-font Tewi] ({{AUR|bdf-tewi-git}})
* [http://unifoundry.com/unifont.html Unifont] ([[Wikipedia:Unicode font#Comparison of fonts|Unicode のカバー率が最も高いフォント]]) ({{Pkg|bdf-unifont}})

=== ラテン文字 ===

==== ファミリー ====

* [[Wikipedia:ja:Bitstream Vera|Bitstream Vera]] ({{Pkg|ttf-bitstream-vera}}) – セリフ体・サンセリフ体・モノスペース
* [https://quoteunquoteapps.com/courierprime/ Courier Prime] ({{AUR|ttf-courier-prime}}) – スクリーンプレイ用に最適化された Courier フォント代替
* [[Wikipedia:Croscore fonts|Croscore フォント]] ({{Pkg|ttf-croscore}}) – Windows の Arial, Times New Roman, Courier New フォントの Google による代替フォント
* [[Wikipedia:ja:DejaVuフォント|DejaVu フォント]] ({{Pkg|ttf-dejavu}}) – Unicode の対応率を高めた Bitstream Vera
* [[Wikipedia:ja:Droid (書体)|Droid]] ({{Pkg|ttf-droid}}, {{AUR|ttf-google-fonts-git}} に含まれています) – 旧バージョンの Android のデフォルトフォント
* [[Wikipedia:ja:Roboto|Roboto]] ({{Pkg|ttf-roboto}}) – 新しいバージョンの Android のデフォルトフォント
* [[Wikipedia:ja:Noto|Google Noto]] ({{Pkg|noto-fonts}}) – Unicode 対応フォント
* [[Wikipedia:Liberation fonts|Liberation フォント]] ({{Pkg|ttf-liberation}}) – Windows の Arial, Arial Narrow, Times New Roman, Courier New フォントのフリー代替フォント
* [[Wikipedia:Ubuntu Font Family|Ubuntu フォントファミリー]] ({{Pkg|ttf-ubuntu-font-family}})
* [http://corefonts.sourceforge.net/ Microsoft フォント] ({{AUR|ttf-ms-fonts}}) – Andalé Mono, Courier New, Arial, Arial Black, Comic Sans, Impact, Lucida Sans, Microsoft Sans Serif, Trebuchet, Verdana, Georgia, Times New Roman
* Vista フォント ({{AUR|ttf-vista-fonts}}) – Consolas, Calibri, Candara, Corbel, Cambria, Constantia

==== モノスペース ====

他の等幅フォントは [[#ビットマップ]] や [[#ファミリー]] を参照してください。

* [http://www.marksimonson.com/fonts/view/anonymous-pro Anonymous Pro] ({{pkg|ttf-anonymous-pro}}: {{AUR|ttf-google-fonts-git}} に含まれています)
* [https://github.com/microsoft/cascadia-code Cascadia Code] ({{Pkg|ttf-cascadia-code}}) ⟶ – OpenFontLicense の下で Microsoft によってリリースされ、プログラミング合字を使用して Windows ターミナルの外観を向上させるように設計されています
* [https://quoteunquoteapps.com/courierprime/ Courier Prime] ({{AUR|ttf-courier-prime}}) – サンセリフフォントとプログラミング用に最適化されたバージョンで補完された Courier の代替品で、OpenFontLicense の下でリリースされています。
* [https://damieng.com/blog/2008/05/26/envy-code-r-preview-7-coding-font-released Envy Code R] ({{AUR|ttf-envy-code-r}})
* Fantasque Sans Mono ({{AUR|ttf-fantasque-sans-git}})
* [[Wikipedia:Fira Sans|Fira Mono]] ({{pkg|ttf-fira-mono}}, {{pkg|otf-fira-mono}}) – Firefox OS 用にデザインされたフォント
* [[Wikipedia:Fira_(typeface)#Fira_Code|Fira Code]] ({{Pkg|ttf-fira-code}}) ⟶ – 一般的なプログラミングの複数文字の組み合わせのためのプログラミング合字による FiraMono の拡張
* [https://sourcefoundry.org/hack/ Hack] ({{pkg|ttf-hack}}) KDE プラズマでデフォルトとして使用されるオープンソースの等幅フォント
* [https://github.com/i-tu/Hasklig Hasklig] ({{AUR|otf-hasklig}}) - 等幅合字のコードフォント
* [https://pcaro.es/p/hermit/ Hermit] ({{Pkg|otf-hermit}}) - プログラマーによるプログラマー向けフォント
* [[Wikipedia:Inconsolata|Inconsolata]] ({{Pkg|ttf-inconsolata}}: {{AUR|ttf-google-fonts-git}} に含まれています) - 可読性の高いプログラミングフォント
* [https://leonardo-m.livejournal.com/77079.html Inconsolata-g] ({{AUR|ttf-inconsolata-g}}) - プログラマ向けの改修が加えられています。
* [https://be5invis.github.io/Iosevka/ Iosevka] ({{Pkg|ttc-iosevka}}) ⟶ – Pragmata Pro、M+、および PF DIN Mono に触発された、プログラミングに理想的なフォントとして設計された細いサンセリフおよびスラブセリフ書体。プログラミング合字と2000以上のラテン語、ギリシャ語、キリル文字、音声、PowerLine グリフをサポートします
* [[Wikipedia:Lucida Typewriter|Lucida Typewriter]] ({{AUR|jre}} パッケージに含まれています)
* [[Wikipedia:Menlo (typeface)|Menlo]] (派生: {{AUR|ttf-meslo}}) - OS X のデフォルト等幅フォント
* [[Wikipedia:Monaco (typeface)|Monaco]] ({{AUR|ttf-monaco}}) - OSX 用に Apple がデザインしたフォント
* Monofur ({{Pkg|ttf-monofur}})
* [https://madmalik.github.io/mononoki Mononoki] ({{AUR|ttf-mononoki}})
* [[Wikipedia:Source Code Pro|Source Code Pro]] ({{pkg|adobe-source-code-pro-fonts}})

関連ウェブサイト:

* [http://hivelogic.com/articles/top-10-programming-fonts Dan Benjamin のプログラミングフォント Top 10]
* [http://www.lowing.org/fonts/ Trevor Lowing のフォントリスト]
* [https://www.slant.co/topics/67/~what-are-the-best-programming-fonts Slant: What are the best programming fonts?]
* [https://stackoverflow.com/questions/4689/recommended-fonts-for-programming Stack Overflow: Recommended fonts for programming]

==== ゴシック体 ====

* [http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=andika Andika] ({{AUR|ttf-andika}})
* [[Wikipedia:Cantarell (typeface)|Cantarell]] ({{Pkg|cantarell-fonts}}) – GNOME で提供されるデフォルトのフォント。GNOME および GTK3 関連のパッケージで必要です。
* [https://typedesigndead.coosucks.repl.co/ DMCA Sans Serif] ({{AUR|ttf-dmcasansserif}}) – 汎用サンセリフフォントメトリック - Microsoft Consolas と互換性があります
* [[Wikipedia:Fira (typeface)|Fira Sans]] ({{Pkg|ttf-fira-sans}}, {{Pkg|otf-fira-sans}}) – ErikSpiekermann が Mozilla および FirefoxOS 用に設計したサンセリフフォント。 FiraMono と FiraCode は、FiraSans の等幅コンパニオンです。 (こちらを参照 [[フォント#モノスペース|モノスペース]])
* [[Wikipedia:FreeSans|FreeSans]] ({{Pkg|gnu-free-fonts}}) – Helvetica と Arial の一般的な代替品。こちらを参照。[[フォント#ファミリー|ファミリー]]
* [https://github.com/rsms/inter Inter UI] ({{Pkg|inter-font}}) – ユーザーインターフェイス用に設計されたフォント
* [https://indestructibletype.com/Jost.html Jost*] ({{AUR|otf-jost}}) – [[Wikipedia:Futura (typeface)|Futura]] をベースにしたオープンソースの書体です。
* [[Wikipedia:ja:Linux Libertine|Linux Biolinum]] ({{Pkg|ttf-linux-libertine}}) – Times New Roman のフリー代替フォント
* [[Wikipedia:Liberation Sans|Liberation Sans]] ({{Pkg|ttf-liberation}}) – Helvetica と Arial の一般的な代替品。こちらを参照。[[フォント#ファミリー|ファミリー]]
* [https://fonts.google.com/specimen/Montserrat Montserrat] ({{AUR|montserrat-otf}}) – [[Wikipedia:Gotham (typeface)|Gotham]] と [[Wikipedia:Proxima Nova|Proxima Nova]] 類似点を共有するオープンソースフォント
* [https://fonts.google.com/specimen/Nunito Nunito] ({{AUR|ttf-nunito}}) – エッジが丸みを帯びたオープンソースフォント [[Wikipedia:Gotham_(typeface)#Variations|Gotham Rounded]] [https://fonts.adobe.com/fonts/proxima-soft Proxima Soft]
* [[Wikipedia:Open Sans|Open Sans]] ({{Pkg|ttf-opensans}}) – Google から委託されたサンセリフフォント。Droidsans に基づいていますが、少し幅が広くなっています
* [[Wikipedia:PT Sans|PT Sans]] ({{AUR|ttf-google-fonts-git}}) - 3書体: normal, narrow, caption - Unicode 対応: ラテン・キリル文字
* [[Wikipedia:ja:Source Sans Pro|Source Sans Pro]] ({{pkg|adobe-source-sans-pro-fonts}})
* [[Wikipedia:Tahoma (typeface)|Tahoma]] ({{AUR|ttf-tahoma}})

==== 明朝体 ====

* [[Wikipedia:Bitstream Charter|Bitstream Charter]] ({{AUR|ttf-bitstream-charter}}, {{AUR|otf-bitstream-charter}}) – 元々は [[Wikipedia:Matthew Carter|Matthew Carter]] によって設計された商用フォントであり、[[Wikipedia:Georgia_(typeface)|Georgia]] と類似点があります。バージョンは無料ライセンスの下でリリースされ、後で最新の形式に [https://practicaltypography.com/charter.html 変換] されました(前述のパッケージとして提供されます。)
* [https://indestructibletype.com/Bodoni.html Bodoni*] ({{AUR|otf-bodoni}}) – オープンソース [[Wikipedia:Bodoni|Bodoni]] リバイバル
* [https://github.com/skosch/Crimson Crimson] ({{Pkg|otf-crimson}}) – [[Wikipedia:Minion_(typeface)|Minion]] と類似点を共有するオープンソースフォント
* [[Wikipedia:EB_Garamond|EB Garamond]] ({{AUR|ebgaramond-otf}}) – オープンソースの [[Wikipedia:Garamond|Garamond]] の復活、前述のパッケージは [https://github.com/octaviopardo/EBGaramond12 Octavio Pardo] によって開発されたバージョンです。
* [[Wikipedia:FreeSerif|FreeSerif]] ({{Pkg|gnu-free-fonts}}) – [[Commons:File:FreeSerifDemonstration.png|Visually similar]] Times New Roman に似ていますが、[https://askubuntu.com/questions/346552/closest-alternative-to-times-new-roman/1148247#1148247 メトリックが異なります] こちを参照してください [[フォント#ファミリー|ファミリー]]
* [[Wikipedia:Gentium|Gentium]] ({{Pkg|gentium-plus-font}}) – Unicode:ラテン語、ギリシャ語、キリル文字、表音アルファベット
* [[Wikipedia:Utopia_(typeface)#Derived_typefaces|Heuristica]] ({{AUR|ttf-heuristica}}) – 無料ライセンスでリリースされた [[Wikipedia:Utopia (typeface)|Utopia]]
* [[Wikipedia:Liberation Serif|Liberation Serif]] ({{Pkg|ttf-liberation}}) – Times New Roman とメトリック互換ですが、[https://en.wikipedia.org/wiki/File:Times_New_Roman_Liberation_Serif_comparison.png 視覚的に区別されます]、[[フォント#ファミリー|ファミリー]] を参照してください。
* [https://fonts.google.com/specimen/Libre+Baskerville Libre Baskerville] ({{AUR|ttf-librebaskerville}}) – Impallari Type によって設計されたオープンソースの [[Wikipedia:Baskerville|Baskerville]] リバイバル
* [https://fonts.google.com/specimen/Libre+Caslon+Text Libre Caslon] ({{AUR|otf-libre-caslon}}) – Impallari Type によって設計されたオープンソースの [[Wikipedia:Caslon|Caslon]] リバイバル
* [[Wikipedia:ja:Linux Libertine|Linux Libertine]] ({{Pkg|ttf-linux-libertine}}) - Unicode 対応: ラテン・ギリシア・キリル・ヘブライ文字
* [http://www.gust.org.pl/projects/e-foundry/tex-gyre/index_html TeX Gyre Termes] ({{Pkg|tex-gyre-fonts}}) – Times New Roman と視覚的に似ています(ただし、メトリックに若干の違いがあります。) [[フォント#ファミリー|ファミリー]] を参照してください。
* [[Wikipedia:Croscore_fonts|Tinos]] ({{Pkg|ttf-croscore}}) – Times New Roman とメトリック互換ですが、視覚的に区別されます (Liberation Serif に似ています。) [[フォント#ファミリー|ファミリー]] を参照してください。

==== 未分類 ====

* {{Pkg|font-bh-ttf}} - X.Org Luxi フォント
* {{AUR|ttf-cheapskate}} - ''dustismo.com'' のフォントコレクション
* {{Pkg|ttf-junicode}} - 中世ラテン文字を多数収録している Junius フォント
* {{AUR|ttf-mph-2b-damase}} - 第1面を全てカバーするフォント
* {{Pkg|xorg-fonts-type1}} - [[Wikipedia:ja:PostScriptフォント|PostScript フォント]] の IBM Courier と Adobe Utopia のセット
* {{AUR|all-repository-fonts}} - 公式リポジトリの全てのフォントがインストールできるメタパッケージ
* {{AUR|ttf-google-fonts-git}} - フリーフォントの巨大コレクション (Ubuntu, Inconsolata, Droid など) 100種類以上のフォントがインストールされます。

=== 国際文字 ===

==== 古代文字 ====

*{{AUR|ttf-ancient-fonts}} - エーゲ文明やエジプト文明の文字、楔形文字、アナトリア半島の諸文明やマヤ文明の古代文字などの Unicode 記号が含まれているフォント。

====(ブライユ)点字 ====
*{{AUR|ttf-ubraille}} - ''点字'' の Unicode 記号が入っているフォント

====アラビア・ウルドゥー文字====
*{{AUR|ttf-amiri}} - Amiria Press によって作られたクラシカルなナスフ体のアラビア文字フォント
*{{AUR|ttf-arabeyes-fonts}} - フリーのアラビア文字フォントのコレクション
*{{AUR|ttf-qurancomplex-fonts}} - メディナの King Fahd Glorious Quran Printing Complex によるフォント
*{{AUR|ttf-sil-lateef}} - SIL による Unicode 対応アラビア文字フォント
*{{AUR|ttf-sil-scheherazade}} - SIL による Unicode 対応アラビア文字フォント

==== 漢字文化圏 ====

===== 汎 CJK =====
* Adobe Source Han フォント
巨大なフォントコレクション。簡体字、繁体字、日本語、韓国語を包括的にサポート。統一されたデザインと外観。
:*{{Pkg|adobe-source-han-sans-otc-fonts}} - 明朝体
:*{{Pkg|adobe-source-han-serif-otc-fonts}} - ゴシック体
* {{Pkg|noto-fonts-cjk}} - 簡体字中国語・台湾および香港の繁体字中国語・日本語・韓国語を包括的にサポートする巨大なフォントコレクション。{{Pkg|adobe-source-han-sans-otc-fonts}} のリブランド版。

====== 旧字体 ======

中国大陸では ''旧字形''、台湾・香港では ''伝統字形''、日本では ''旧字体'' と呼ばれる字体。
* {{AUR|ttf-i.bming}} - 明朝体。開発終了。
* {{AUR|ttf-i.ming}} - 明朝体。上記 i.bming の後継。

===== 中国語 =====
* Adobe Source Han フォント
** {{Pkg|adobe-source-han-sans-cn-fonts}} - 簡体字の OpenType/CFF ゴシック体フォント
** {{Pkg|adobe-source-han-sans-tw-fonts}} - 繁体字の OpenType/CFF ゴシック体フォント
** {{Pkg|adobe-source-han-serif-cn-fonts}} - 簡体字の OpenType/CFF 明朝体フォント
** {{Pkg|adobe-source-han-serif-tw-fonts}} - 簡体字の OpenType/CFF 明朝体フォント

* Noto フォント
** {{AUR|noto-fonts-sc}} - {{Pkg|noto-fonts-cjk}}から簡体字フォントだけを切り出したもの。
** {{AUR|noto-fonts-tc}} - {{Pkg|noto-fonts-cjk}}から台湾の繁体字フォントだけを切り出したもの。

* WenQuanYi フォント
** {{Pkg|wqy-zenhei}} - ゴシック体漢字アウトラインフォント、ビットマップの宋体も含まれる (日本語(の一部)とハングルもサポート)
** {{Pkg|wqy-bitmapfont}} - ビットマップ明朝体漢字フォント。

* Arphic フォント
** {{Pkg|ttf-arphic-ukai}} - ''Kaiti'' (筆文字) Unicode 対応フォント (アンチエイリアス推奨)
** {{Pkg|ttf-arphic-uming}} - ''Mingti'' (活字) Unicode 対応フォント。

* {{Pkg|opendesktop-fonts}} - ''New Sung'' フォント、旧 ttf-fireflysung パッケージ。

* {{Pkg|ttf-hannom}} - 中国語とベトナム語の漢字とチュノムに対応した TrueType フォント。

* 台湾教育部発行の標準フォント
** {{AUR|ttf-tw}} - 台湾教育部発行の楷書と明朝体の繁体字フォント。
** {{AUR|ttf-twcns-fonts}} - 台湾教育部発行の中国語 TrueType フォント。CNS11643 に対応し、楷書と明朝体が含まれる。

*Windows の中国語フォント
**{{AUR|ttf-ms-win8-zh_cn}} - Windows8 の簡体字フォント。
**{{AUR|ttf-ms-win8-zh_tw}} - Windows8 の繁体字フォント。
**{{AUR|ttf-ms-win10-zh_cn}} - Windows10 の簡体字フォント。
**{{AUR|ttf-ms-win10-zh_tw}} - Windows10 の繁体字フォント。

=====日本語=====

* Adobe Source Han フォント
**{{Pkg|adobe-source-han-sans-jp-fonts}} - 日本語 OpenType/CFF ゴシック体フォント。
**{{Pkg|adobe-source-han-serif-jp-fonts}} - 日本語 OpenType/CFF 明朝体フォント。
**{{AUR|otf-source-han-code-jp}} - 日本語 OpenType/CFF コーディング用フォント。

* IPA フォント
**{{Pkg|otf-ipafont}} - 日常的に使える日本語ゴシック体と明朝体のフォントセット。一番高品質なオープンソースフォントの一つ。openSUSE-ja のデフォルト。
**{{Pkg|otf-ipaexfont}} - 字幅が調整された IPA フォント。
**{{Pkg|otf-ipamjfont}} - 人名の異体字を収録した行政機関向けフォント。変体仮名対応。
**{{AUR|otf-takao}}, {{AUR|otf-takaoex}}, {{AUR|otf-takaomj}} - Ubuntu の日本コミュニティによる IPA 派生フォント。

*M+ フォント
**{{AUR|ttf-mplus}} - 近代的なゴシック体日本語アウトラインフォント。日本語の平仮名・片仮名、Basic Latin・Latin-1 Supplement・Latin Extended-A 文字セット、ほぼ全ての日本語の漢字(第一水準漢字まで完全に対応)と IPA 拡張、ギリシア文字、キリル文字、ベトナム語を収録。7 ウェイト(プロポーショナル)と 5 ウェイト(等幅)を用意。
**{{AUR|ttf-rounded-mplus}} - 丸ゴシック化した M+ フォント。

*モナーフォント
**{{AUR|ttf-mona}} - オリジナルのモナーフォント。
**{{AUR|ttf-monapo}} - [[wikipedia:ja:アスキーアート|2ちゃんねるのアスキーアート]]を正確に表示できる日本語フォント。

*{{Pkg|ttf-hanazono}} - フリーの日本語漢字フォント、明朝体。変体仮名対応。
*{{Pkg|ttf-sazanami}} - フリーの日本語 TrueType フォント。既にメンテナンスされていませんが、環境によってはフォールバックフォントとして使われています。
*{{AUR|ttf-ume}} - フリーのゴシック体・明朝体フォント。
*{{AUR|ttf-vlgothic}} - 日本語ゴシック体フォント。Debian/Fedora/Vine Linux のデフォルト。
*{{AUR|ttf-mikachan}} - 先駆的な手書き日本語フォント。
*{{AUR|ttf-oradano-mincho}} - 明治・大正時代の活字風のフォント。
*{{AUR|otf-aoyanagi-reisyo-simo}} - フリーの隷書体毛筆フォント。

*合成フォント
**{{AUR|ttf-kazesawa-git}} - 可読性が高くウェイトが豊富なフォント。
**{{AUR|otf-kingen}} - オールド系の錦明朝と源ノ明朝 Light の合成フォント。
**{{AUR|ttf-komatuna}} - 小夏フォントと M+ フォントの合成フォント。
**{{AUR|ttf-koruri}} - {{AUR|ttf-mplus}} と Open Sans をミックスして作られた日本語 TrueType フォント。
**{{AUR|ttf-migu}} と {{AUR|ttf-migmix}} - M+ と IPA の合成フォント。
**{{AUR|ttf-myrica}} と {{AUR|ttf-myricam}} - Ricty ベースのプログラマ用フォント。
**{{AUR|ttf-ricty}} - Inconsolata と Migu 1M フォントから生成される Linux プログラミング用フォント。
**{{AUR|ttf-vlkoruri}} - {{AUR|ttf-vlgothic}} と Open Sans をミックスして作られた日本語 TrueType フォント。
**{{AUR|ttf-umeplus}} - 梅フォントと M+ フォントの合成フォント。

*Windows の日本語フォント
**{{AUR|ttf-ms-win8-japanese}} - Windows8 の日本語フォント。
**{{AUR|ttf-ms-win10-japanese}} - Windows10 の日本語フォント。

===== 韓国語 =====
*{{Pkg|adobe-source-han-sans-kr-fonts}} - 韓国語 OpenType/CFF フォント。漢字を含む。
*{{Pkg|ttf-baekmuk}} - 韓国語 TrueType フォントのコレクション。明朝体・ゴシック体・丸ゴシック体。漢字を含む。
*{{AUR|spoqa-han-sans}} - Spoqa によってカスタマイズされた Source Han Sans 漢字を含む。
*{{AUR|ttf-d2coding}} - Naver によって作成された D2Coding 等幅 TrueType フォント。漢字を含む。
*{{AUR|ttf-nanum}} - Nanum シリーズ TrueType フォントコレクション。一部のフォントはハングルのみ。
*{{AUR|ttf-nanumgothic_coding}} - Nanum シリーズ幅調整 TrueType フォント

===== ベトナム語 =====
* {{Pkg|ttf-hannom}} - 中国語とベトナム語の漢字とチュノムに対応したTrueType フォント。

====キリル文字====
[[#ラテン文字]]も見てください。
*{{AUR|ttf-paratype}} - ParaType のフォントファミリー: sans, serif, mono, 拡張キリル・ラテン文字, OFL ライセンス
*{{AUR|otf-russkopis}} - キリル文字のフリーな OpenType 筆記体フォント

====ギリシア文字====
ほとんど全ての Unicode 対応フォントにはギリシア文字セットが(アクセント注記式も)含まれています。追加フォントパッケージには、Unicode 文字に完全には対応していないながらも高品質なギリシア文字(もちろんラテン文字も)活字を使えるパッケージがあります:
*{{AUR|otf-gfs}} - Greek Font Society による OpenType フォントのセレクション
*{{AUR|ttf-mgopen}} - Magenta によるプロフェッショナル TrueType フォント

====ヘブライ文字====
*{{AUR|culmus}} - フリーのヘブライ文字のコレクション

====インド系文字====
*{{AUR|ttf-freebanglafont}} - ベンガル文字フォント
*{{Pkg|ttf-indic-otf}} - インド系文字 OpenType フォントコレクション (ttf-freebanglafont を含む)
* {{AUR|lohit-fonts}} - Fedora プロジェクトによるインド系文字 TrueType フォント (Oriya フォントなどを含む)
* {{AUR|ttf-devanagarifonts}} - デーヴァナーガリー TrueType フォント (283個のフォントを含む)
* {{AUR|ttf-gurmukhi-fonts_sikhnet}} - TrueType グルムキー文字フォント (gurbaniwebthick, prabhki)
* {{AUR|ttf-gurmukhi_punjabi}} - TTF グルムキー文字/パンジャーブ語 (252個のフォントを含む)
* {{AUR|ttf-gujrati-fonts}} - TTF グジャラート語フォント (Avantika, Gopika, Shree768)
* {{AUR|ttf-kannada-font}} - カンナダ語、インドのカルナータカ州の公用語
* {{AUR|ttf-lklug}} - シンハラ文字 Unicode 対応フォント
*{{AUR|ttf-tamil}} - タミル文字 Unicode 対応フォント
* {{AUR|ttf-urdufonts}} - ウルドゥー語のためのフォント (Jameel Noori Nastaleeq (+kasheeda), Nafees Web Naskh, PDMS Saleem Quran Font) と Jameel Noori Nastaleeq をデフォルトフォントにするフォント設定。

====クメール文字====
*{{Pkg|ttf-khmer}} - クメール語で使われる文字のフォント
*[https://www.google.com/fonts/specimen/Hanuman Hanuman] ({{AUR|ttf-google-fonts-git}})

==== モンゴル・ツングース語族 ====

* {{AUR|ttf-abkai}} - シベ文字・満州文字・ダウール文字フォント (開発途中で不完全です)

==== ペルシア文字 ====

* {{AUR|persian-fonts}} - AUR に存在する全てのペルシア語フォントをインストールするためのメタパッケージ。
* {{AUR|borna-fonts}} - Borna Rayaneh Co. 製のペルシア文字 B フォントシリーズ。
* {{AUR|iran-nastaliq-fonts}} - フリーの Unicode 対応ペルシア文字筆記体フォント。
* {{AUR|iranian-fonts}} - Iranian-Sans と Iranian-Serif のペルシア文字フォントファミリー。
* {{AUR|ir-standard-fonts}} - イラン通信情報技術最高評議会 (SCICT) による標準ペルシア語フォント。
* {{AUR|persian-hm-ftx-fonts}} - X Series 2, Metafont, FarsiTeX フォントから派生して作られたカシーダが使えるペルシア文字フォントシリーズ。
* {{AUR|persian-hm-xs2-fonts}} - X Series 2 フォントから派生して作られたカシーダが使えるペルシア文字フォントシリーズ。
* {{AUR|sina-fonts}} - Sina Pardazesh Co. 製のペルシア文字フォントシリーズ。
* {{AUR|gandom-fonts}}, {{AUR|parastoo-fonts}}, {{AUR|sahel-fonts}}, {{AUR|samim-fonts}}, {{AUR|shabnam-fonts}}, {{AUR|tanha-fonts}}, {{AUR|vazir-fonts}}, {{AUR|vazir-code-fonts}} - Ali Rasti Kerdar によって作られた美麗なペルシア語フォント。
* {{AUR|ttf-yas}} - Yas Persian フォントシリーズ。
* {{AUR|ttf-x2}} - ペルシア語、アラビア語、ウルドゥー語、パシュトー語、ウズベク語、クルド語、ウイグル語、古代トルコ語 (オスマン語)、現代トルコ語 (ローマ字) までサポートしているフリーフォント。

==== タイ・カダイ語族 ====

* {{AUR|fonts-tlwg}} - スケーラブルなタイ語フォントのコレクション
* {{AUR|ttf-lao}} - ラオス語 TTF フォント (Phetsarath_OT)
* {{AUR|ttf-lao-fonts}} - ラオス語 TTF フォント、Unicode 版と Windows 用の非 Unicode 版

==== チベット・ビルマ語派 ====
*{{Pkg|ttf-tibetan-machine}} - チベット語 Machine TTFont
* {{AUR|ttf-myanmar-fonts}} - myordbok.com の121個のフォント

=== 絵文字と記号 ===

Unicode 規格には「絵文字」と呼ばれる画像文字のためにあてられたセクションが存在します。

* {{Pkg|noto-fonts-emoji}} - Android や Google ハングアウトなどで使用される Google の絵文字フォント。Unicode に新しく追加された絵文字は Noto フォントでは正しく表示されないことがあります。
* {{AUR|ttf-symbola}} - 多数の Unicode 記号が含まれており、絵文字も存在します。アウトラインフォント。
* {{AUR|ttf-emojione}}{{Broken package link|置換パッケージ: {{Pkg|ttf-joypixels}}}} - デザインの正確性が重視されているオープンソースの絵文字セット。
* {{AUR|ttf-twemoji-color}} - Twitter のオープンソース絵文字。

複数の文字からなる[[wikipedia:ja:顔文字#日本型の顔文字|顔文字]]は CJK やインド文字フォントなど様々な文字セットを使っています。次のパッケージは既存の顔文字の大部分をカバーします: {{Pkg|ttf-freefont}}{{Broken package link|パッケージが存在しません}}, {{Pkg|ttf-arphic-uming}}, {{Pkg|ttf-indic-otf}}

絵文字フォントを有効にしてメインのフォントファミリーの補助として絵文字ファミリーを追加したい場合、以下を[[フォント設定]]に追加してください:

{{hc|/etc/fonts/local.conf|<nowiki><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<match>
<test name="family">
<string>serif</string>
</test>
<edit name="family" mode="prepend" binding="weak">
<string>Emoji</string>
</edit>
</match>

<match>
<test name="family">
<string>sans-serif</string>
</test>
<edit name="family" mode="prepend" binding="weak">
<string>Emoji</string>
</edit>
</match>

<match>
<test name="family">
<string>monospace</string>
</test>
<edit name="family" mode="prepend" binding="weak">
<string>Emoji</string>
</edit>
</match>
</fontconfig></nowiki>}}

===数学===

* {{Pkg|font-mathematica}}{{Broken package link|パッケージが存在しません}} - Wolfram Research, Inc による Mathematica フォント
* {{Pkg|texlive-core}} と {{Pkg|texlive-fontsextra}} - Latin Modern Math や [[Wikipedia:STIX Fonts project|STIX フォント]] などの多数の数式フォントが含まれています。設定方法は [[TeX Live#フォント]]を見てください。
* {{AUR|otf-stix}} - 右から左に書かれる数式に対応する STIX の最新・スタンドアロン版
* {{Pkg|otf-latin-modern}}, {{Pkg|otf-latinmodern-math}} - LaTeX で使われている Computer Modern フォントの改良版
* {{AUR|ttf-computer-modern-fonts}}, {{AUR|otf-cm-unicode}} - [[wikipedia:ja:Computer Modern|Computer Modern]] (of TeX fame) フォント
* {{AUR|ttf-mathtype}} - MathType フォント

=== 他のオペレーティングシステムのフォント ===
* {{AUR|ttf-mac-fonts}} - macOS の TrueType フォント

Windows のフォントについては [[MS フォント]]や[[メトリック互換フォント]]を見てください。

== X11 でのフォント順序 ==
Fontconfig は自動的に要求にあったフォントを選びだします。例えば、英語と日本語が含まれるウィンドウを表示しようとすると、デフォルトのフォントが日本語をサポートしていない場合、日本語を表示できるフォントに切り替わります。

Fontconfig はユーザーに {{ic|$XDG_CONFIG_HOME/fontconfig/fonts.conf}} を使って好きな順番を設定するように定めています。
他の Serif フォントが表示できない場合、特定の日本語フォントを選ぶようにしてほしいときは、ファイルを次のようにします:
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<alias>
<family>serif</family>
<prefer>
<family>好みのラテン文字 Serif フォント名</family>
<family>日本語フォント名</family>
</prefer>
</alias>
</fontconfig>

同じように Sans-serif や monospaced 用のセクションを作ることもできます。詳しくは fontconfig マニュアルを見て下さい。

[[フォント設定#フォントの置き換え]]も参照。

== フォントエイリアス ==
Linux では、アプリケーションが似たフォントを使えるようにするために、他のフォントを表すフォントエイリアスが複数用意されています。一般的なエイリアス: {{ic|serif}} はセリフ体のフォントを表します (例: DejaVu Serif); {{ic|sans-serif}} はサンセリフ体のフォントを表します (例: DejaVu Sans); {{ic|monospace}} は等幅フォントを表します (例: DejaVu Sans Mono)。しかし、エイリアスが表すフォントは変わることがあり、[[KDE]] などの[[デスクトップ環境]]にあるようなフォント管理ツールでは対応関係が示されないことがしばしばです。

エイリアスがどのフォントを示しているのか調べるには次を実行します:
{{hc|$ fc-match monospace|DejaVuSansMono.ttf: "DejaVu Sans Mono" "Book"}}

この場合 {{ic|DejaVuSansMono.ttf}} が monospace エイリアスによって表示されるフォントです。

== ヒントとテクニック ==

=== インストールした全てのフォントを一覧する ===
次のコマンドを使うことであなたのシステムで利用できる全てのインストール済みフォントを一覧できます。

$ fc-list

{{Pkg|font-manager}} パッケージを使用すると、GUIベースでフォントごとの字体を確認することができます。

$ font-manager

=== 特定の言語のフォントを一覧する ===

アプリケーションやブラウザは fontconfig の設定に基づいて、Unicode のテキストを表示するためのグリフが入っているフォントを選択します。インストールしたフォントの中で特定の言語のフォントをリストアップするには、{{ic|<nowiki>fc-list :lang="two letter language code"</nowiki>}} コマンドを実行してください。例えば、日本語フォントまたは日本語をサポートしているフォントを確認するには:
{{hc|$ fc-list :lang=ja | cut -d: -f1|2=
<nowiki>
/usr/share/fonts/TTF/ipam-mona.ttf
/usr/share/fonts/TTF/ipamp-mona.ttf
/usr/share/fonts/TTF/ipagui-mona.ttf
/usr/share/fonts/OTF/ipamp.ttf
/usr/share/fonts/wenquanyi/wqy-microhei/wqy-microhei.ttc
/usr/share/fonts/TTF/ipag-mona.ttf
/usr/share/fonts/OTF/ipam.ttf
/usr/share/fonts/TTF/ipagp-mona.ttf
/usr/share/fonts/OTF/ipagp.ttf
/usr/share/fonts/wenquanyi/wqy-microhei/wqy-microhei.ttc
/usr/share/fonts/OTF/ipag.ttf
</nowiki>
}}

=== アプリケーション固有のフォントキャッシュ ===

Matplotlib ({{pkg|python-matplotlib}} や {{AUR|python2-matplotlib}}) は自身のフォントキャッシュを使っているため、フォントを更新した後は、{{ic|~/.matplotlib/fontList.cache}} を削除してキャッシュを再生成させてください [http://matplotlib.1069221.n5.nabble.com/getting-matplotlib-to-recognize-a-new-font-td40500.html]。

== 参照 ==

* [http://behdad.org/text/ State of Text Rendering]
* [https://fontlibrary.org/ Font Library] - フリーライセンスのフォントライブラリ
* [https://screenshots.debian.net/packages?search=fonts&show=with screenshots.debian.net のフォント一覧]

Bluetooth ヘッドセット

2022-09-19T14:14:04Z

がおびん: /* AuthenticationFailed でペアリングが失敗する */ hciconfig は廃止されたため英語版の記述を翻訳して追記した。

[[Category:サウンド]]
[[Category:Bluetooth]]
[[en:Bluetooth headset]]
[[ru:Bluetooth headset]]
[[zh-hans:Bluetooth headset]]
{{Related articles start}}
{{Related|Bluetooth}}
{{Related|Bluez4}}
{{Related articles end}}

現在、Arch Linux のデフォルト環境ではリモートオーディオ再生の A2DP プロファイル (Audio Sink) をサポートしています。

{{Note|Bluez5 は [[PulseAudio]] しかサポートしておらず [[ALSA]] はサポートしていません。PulseAudio を使いたくない場合は AUR から {{AUR|bluez-alsa-git}} をインストールする必要があります。}}

== Bluez5/PulseAudio ==

PulseAudio 5.x はデフォルトで A2DP をサポートしています。以下のパッケージを[[インストール]]してください: {{Pkg|pulseaudio-alsa}}, {{Pkg|pulseaudio-bluetooth}}, {{Pkg|bluez}}, {{Pkg|bluez-libs}}, {{Pkg|bluez-utils}}, {{AUR|bluez-firmware}}。{{Pkg|pulseaudio-bluetooth}} がないとペアリングした後に接続することができなくなります。エラーメッセージは表示されません。

Bluetooth システムを起動:

# systemctl start bluetooth

''bluetoothctl'' コマンドラインユーティリティを使うことでペアリングと接続が行えます。''bluetoothctl'' に関する詳細やトラブルシューティングは [[Bluetooth]] の記事を見てください。次のコマンドを実行することでコマンドプロンプトを開きます:

# bluetoothctl

そして以下を入力:

# power on
# agent on
# default-agent
# scan on

ヘッドセットをペアリングモードにします。ヘッドセットは簡単に確認できます。例えば:
[NEW] Device 00:1D:43:6D:03:26 Lasmex LBT10
上記の場合、デバイスの名前は "Lasmex LBT10" で MAC アドレスは ''00:1D:43:6D:03:26'' です。この MAC アドレスを使ってペアリングを開始します:

# pair 00:1D:43:6D:03:26

ペアリングが完了したら、デバイスを明示的に接続する必要があります (every time?):

# connect 00:1D:43:6D:03:26

全てが上手くいけば、[[PulseAudio]] にアウトプットデバイスが新しく作られます。
{{Note|デバイスはデフォルトではオフになっています。{{Pkg|pavucontrol}} の "Configuration" タブでオーディオプロファイル (''OFF'', A2DP, HFP) を選択してください。}}
{{Pkg|pavucontrol}} の "Playback" や "Recording" タブを使うことでデバイスに音声を転送することができます。

スキャンを無効化してプログラムを終了:
# scan off
# exit

=== 自動接続の設定 ===

ヘッドセットを自動接続するには、PulseAudio の switch-on-connect モジュールを有効にする必要があります。以下を追加してください:
{{hc|/etc/pulse/default.pa|
# automatically switch to newly-connected devices
load-module module-switch-on-connect
}}

それから Bluetooth ヘッドセットを信頼するように ''bluetoothctl'' を使用しないと、以下のようなエラーが表示されます:
bluetoothd[487]: Authentication attempt without agent
bluetoothd[487]: Access denied: org.bluez.Error.Rejected

[bluetooth]# trust 00:1D:43:6D:03:26

再起動後、Bluetooth アダプタはデフォルトでは電源が入らないようになります。udev ルールを追加して電源を入れてください:
{{hc|/etc/udev/rules.d/10-local.rules|2=
# Set bluetooth power up
ACTION=="add", SUBSYSTEM=="bluetooth", KERNEL=="hci[0-9]*", RUN+="/usr/bin/hciconfig %k up"
}}

=== トラブルシューティング ===

A2DP/Bluetooth ヘッドセットが動作しないという報告は多数存在します。

==== 音声プロファイルを選択しても、ヘッドセットが機能せず音声が転送できない ====

一見、デバイスを接続する前に音声プロファイルが選択できるようにみえますが、残念ながら何の効果もありません。メニューはレシーバーがデバイスを認識するとすぐに作成されます。

bluetoothctl を (sudo あるいは root で) 実行して手動でデバイスを接続してください。毎回接続する手間を省くような設定オプションが存在するかもしれませんが、自動接続は上手くいきません。

==== AuthenticationFailed でペアリングが失敗する ====

ペアリングが失敗する場合、次のコマンドで [https://stackoverflow.com/questions/12888589/linux-command-line-howto-accept-pairing-for-bluetooth-device-without-pin SSPMode を無効化] または有効化してみてください:
# btmgmt ssp off
または
# btmgmt ssp on

これらのコマンドを実行する間、Bluetooth 機器の電源をOFFにする必要がある可能性があります。

==== ペアリングは成功するが、接続が失敗する ====

''bluetoothctl'' で以下のエラーが表示される場合:

[bluetooth]# connect 00:1D:43:6D:03:26
Attempting to connect to 00:1D:43:6D:03:26
Failed to connect: org.bluez.Error.Failed

以下のようなコマンドを使ってログを確認してみてください:

# systemctl status bluetooth
# journalctl -n 20

以下のようなメッセージが確認できる場合:

bluetoothd[5556]: a2dp-sink profile connect failed for 00:1D:43:6D:03:26: Protocol not available

おそらく {{Pkg|pulseaudio-bluetooth}} パッケージがインストールされていないのが原因です。インストールしたら、pulseaudio を再起動してください。

パッケージが欠けていることが問題ではない場合、PulseAudio が上手く起動していないのが原因です。一般的に PulseAudio を再起動することで問題は解決します。PulseAudio をユーザーで実行している場合に ''bluetoothctl'' を root で実行することは全く問題ありません。PulseAudio の再起動後、接続を再試行してください。ペアリングを繰り返す必要はありません。

PulseAudio の再起動で問題が直らないときは、module-bluetooth-discover をロードしてください:

# pactl load-module module-bluetooth-discover

上記の load-module コマンドは {{ic|/etc/pulse/default.pa}} に追加することができます。

それでも問題が修正されない場合、あるいは PulseAudio の system-wide モードを使っていない場合、以下の PulseAudio モジュールもロードしてください (以下のモジュールも {{ic|default.pa}} や {{ic|system.pa}} でロードすることができます):

module-bluetooth-policy
module-bluez5-device
module-bluez5-discover

==== 接続は成功するが、音が聞こえない ====

システムログに以下のメッセージが記録されてないか確認してください:

bluetoothd[5556]: Endpoint registered: sender=:1.83 path=/MediaEndpoint/A2DPSource
bluetoothd[5556]: Endpoint registered: sender=:1.83 path=/MediaEndpoint/A2DPSink

上記のようなメッセージがある場合、PulseAudio の設定を確認してください。もしくは、一度戻って接続が成功するかどうか確かめてください。

[[GDM]] を使っている場合、PulseAudio のインスタンスが起動して、bluetooth デバイスの接続を奪っている可能性があります。以下のコマンドを実行して GDM ユーザーで pulseaudio ソケットを[[systemd#ユニットを使う|マスク]]することで問題は解決します:

# mkdir -p ~gdm/.config/systemd/user
# ln -s /dev/null ~gdm/.config/systemd/user/pulseaudio.socket

再起動すれば PulseAudio のインスタンスが起動しなくなるはずです。

bluez がヘッドセットを a2dp に対応していると認識してくれない場合もあります。そのようなときは、以下のコマンドで bluetooth デバイスのインデックスを検索してください:

$ pacmd ls

以下のように bluetooth ヘッドセットに関連するセクションが出力されます:

{{hc
|1=pacmd ls
|2=index: 2
name: <bluez_card.XX_XX_XX_XX_XX_XX>
driver: <module-bluez5-device.c>
owner module: 27
properties:
device.description = "SONY MDR-100ABN"
device.string = "XX:XX:XX:XX:XX:XX"
device.api = "bluez"
device.class = "sound"
...}}

プロファイルを手動で設定するには、以下のコマンドを実行 ({{ic|2}} は {{ic|pacmd ls}} で確認したデバイスのインデックスに置き換えてください):

$ pacmd set-card-profile 2 a2dp_sink

==== UUIDs has unsupported type ====

ペアリング中に ''bluetoothctl'' で以下のような出力がされることがあります:

[CHG] Device 00:1D:43:6D:03:26 UUIDs has unsupported type

このメッセージは無視してかまいません。

==== PC からはデバイスがペアリング済みと認識されるがデバイスから PC が認識されていない ====

デバイスが bluetooth LE のペアリングに対応していない可能性があります。

{{ic|/etc/bluetooth/main.conf}} で {{ic|1=ControllerMode = bredr}} を設定してみてください。詳しくは [https://unix.stackexchange.com/questions/292189/pairing-bose-qc-35-over-bluetooth-on-fedora] を参照。

== 旧式の方法: ALSA-BTSCO ==

今日、bluez 3.16 以上では簡単に bluetooth ヘッドセットをセットアップすることができます。しかしながら [http://fosswire.com/2008/01/11/a2dp-stereo-linux/ このブログ] にある古い python スクリプトを使用するという方法もあります (gconftool-2 で動作するようにスクリプトを編集してください)。また、同じ機能の bash スクリプトが [http://lymanrb.blogspot.com/2008/05/linux.html こちら] に存在します。

ヘッドセットの bdaddr が必要です。bdaddr は ''12:34:56:78:9A:BC'' という形式になります。ヘッドセットのドキュメントを読んで探すか、'''hcitool scan''' コマンドを実行してください。

{{AUR|btsco}} をインストールしてください。

次のコマンドでカーネルモジュールをロード:
# modprobe snd-bt-sco
これで新しい音声デバイスが作成されます。{{ic|alsamixer -cN}} (N は基本的に 1 になります) を使ってボリュームを設定してください。''BT headset'' デバイスを選択することで alsa 対応のアプリケーションからデバイスを使用することができます。あるいは OSS アプリケーションでは音声デバイスとして {{ic|/dev/dspN}} を使用します。

実際に音を流すには、先にヘッドセットをコンピュータに接続する必要があります。

=== ヘッドセットを接続 ===

初めてヘッドセットを接続する場合、まずペアリングのセクションを読んでください。ヘッドセットをコンピュータに接続するには、次のコマンドを使用します:
$ btsco -f <bdaddr>
例:
$ btsco -f 12:34:56:78:9A:BC

==== ヘッドセットとコンピュータをペアリング ====

ヘッドセットとの最初の接続時に、コンピュータとペアリングする必要があります。ペアリングするときは、ヘッドセットの PIN が必要です。使用するヘッドセットによっては、ヘッドセットをリセットする必要があり、別の bluetooth デバイスでヘッドセットを使うときは毎回ペアリングしなくてはなりません。

ヘッドセットとコンピュータをペアリングする方法は2つあります:

===== ''bluez-gnome'' を使う =====

community リポジトリから ''bluez-gnome'' パッケージをインストールしてください。そして '''bt-applet''' プログラムを起動してください。ヘッドセットに接続しようとすると、ウィンドウが開いて PIN を要求します。

===== ''passkey-agent'' を使う =====

ヘッドセットに接続する前に、次のコマンドを実行:
$ passkey-agent --default <pin>
''<pin>'' はヘッドセットの PIN に置き換えてください。それからヘッドセットに接続してください。

=== ヘッドセットと ALSA デバイス ===

1. まず[[公式リポジトリ]]から {{Pkg|bluez}} を[[インストール]]してください。

2. デバイスをスキャン:
$ hcitool (-i <optional hci#>***) scan

3. ヘッドセットとデバイスをペアリング:
$ bluez-simple-agent (optional hci# ***) XX:XX:XX:XX:XX:XX
そして pin を入力 (0000 や 1234 など)。

4. {{ic|/etc/bluetooth/audio.conf}} から A2DP Audio Sink を許可してください。[General] の下に以下の行を記述:
Enable=Source,Sink,Media,Socket

5. 以下を {{ic|/etc/asound.conf}} ファイルに追加:
#/etc/asound.conf

pcm.btheadset {
type plug
slave {
pcm {
type bluetooth
device XX:XX:XX:XX:XX:XX
profile "auto"
}
}
hint {
show on
description "BT Headset"
}
}
ctl.btheadset {
type bluetooth
}

6. alsa デバイスに追加されたかどうか確認:
$ aplay -L

7. aplay で再生:
$ aplay -D btheadset /path/to/audio/file

または Mplayer を使用:
$ mplayer -ao alsa:device=btheadset /path/to/audio/or/video/file

{{Tip|usb ドングルの hci# を確認するには、次を実行: {{ic|$ hcitool dev}}。}}

=== ヘッドセットのマルチメディアボタン ===

bluetooth ヘッドセットのマルチメディアボタン (再生・停止・次へ・前へ) を使うには、{{ic|/etc/modules-load.d/uinput.conf}} を作成して {{ic|uinput}} と記述する必要があります。

== 旧式の方法: PulseAudio ==

もっと簡単な方法です。PulseAudio はヘッドセットが有効になったときにシームレスに出力デバイスを切り替えます。サウンドサーバーとして ALSA を使っている場合、次のパッケージをインストールしてください: {{Pkg|pulseaudio}} と {{Pkg|pulseaudio-alsa}}。

bluetooth を使うように音声出力を設定するため、{{Pkg|pavucontrol}} をインストールして実行してください:
$ pavucontrol
PulseAudio の設定については [[PulseAudio]] の記事を確認してください (特に KDE を使っている場合)。

=== トラブルシューティング ===

==== Audio sink fails ====

Bluetooth ヘッドセットを接続しても ALSA/PulseAudio が接続されたデバイスを使用しないことがあります。"Audio sink fails" と表示されます。[https://wiki.gentoo.org/wiki/Bluetooth_Headset gentoo wiki] によれば、{{ic|/etc/bluetooth/audio.conf}} の {{ic|[General]}} セクションの下に {{ic|<nowiki>Enable=Socket</nowiki>}} が必要です。

設定したら {{ic|# systemctl restart bluetooth}} を実行して適用してください。

==== Page timeout issue ====

bluez-simple-agent を使用してヘッドセットとシステムをペアリングしたときにこのエラーが表示される場合、システムを再起動してデスクトップ環境に付属している bluez のグラフィカルアプレットを使ってみてください。

== 旧式のドキュメント: ALSA, bluez5, PulseAudio の方法 ==

[[ALSA]], [[bluez|bluez5]], [[PulseAudio]] を使うことでワイヤレス [[Bluetooth]] ヘッドセットで音声を再生することができます。以下の方法は Lenovo T61p ノートパソコンと SoundBot SB220 ワイヤレス bluetooth ヘッドセットで確認しています。大量のソフトウェアスタックが必要で、全てのソフトウェアがインストールされていないと謎のエラーが発生するかもしれません。以下のソフトウェアパッケージのリストは最小限必要なセットとは限りません。

Bluez5 にリグレッションが存在し HSP/HFP Telephone プロファイルを使うことができません。このリグレッションは [https://www.freedesktop.org/wiki/Software/PulseAudio/Notes/5.0/ Pulseaudio 5.0 のリリースノートのドラフト版] に次のように記述されています ("Notes for packagers"): "PulseAudio は BlueZ 5 をサポートしますが A2DP プロファイルだけです。HSP/HFP を使用するには BlueZ 4 が必要になります" ([https://fedoraproject.org/wiki/Common_F20_bugs#bluez5-profile 参照])。

=== ソフトウェアパッケージのインストール ===

中心となるソフトウェアコンポーネントは [[ALSA]], Bluez5, [[PulseAudio]] です。ただし、他にも必要なライブラリが存在します。また、音声ファイルを再生するプレイヤーも必要です。以下のセクションではヘッドセットを接続してヘッドセットから音声を流すためにインストールする必要があるソフトウェアパッケージを記載しています。

==== ALSA と関連ライブラリのインストール ====

[[ALSA]] は Linux カーネルと一緒に動作してユーザーモードソフトウェアにオーディオサービスを提供します。[[Bluetooth]] ヘッドセットでは次のパッケージが使われます: {{Pkg|alsa-utils}}, {{Pkg|alsa-plugins}}, {{Pkg|alsa-tools}}。

==== Bluez5 のインストール ====

Bluez5 は最新の [[Bluetooth]] スタックです。[[PulseAudio]] で無線ヘッドセットを使うのに必要になります。必要なパッケージ: {{Pkg|bluez}}, {{Pkg|bluez-utils}}, {{Pkg|bluez-libs}}。

==== Audacious のインストール ====

[[Audacious]] は音声ファイルを再生するプログラムです。[[ALSA]] や [[PulseAudio]] で直接機能します。必要なパッケージ: {{Pkg|audacious}}, {{Pkg|audacious-plugins}}。

=== 手順 ===

必要なパッケージをインストールしたら、以下の手順で Bluetooth ヘッドセットを使うことができます。ヘッドセットをペアリングして、接続し、プレイヤーを設定して、PulseAudio を設定して、音声を流します。

bluetooth サービスを root で起動:
# systemctl start bluetooth

Bluetooth が起動したことを確認:
# systemctl status bluetooth
bluetooth.service - Bluetooth service
Loaded: loaded (/usr/lib/systemd/system/bluetooth.service; disabled)
Active: active (running) since Sat 2013-12-07 12:31:14 PST; 12s ago
Docs: man:bluetoothd(8)
Main PID: 3136 (bluetoothd)
Status: "Running"
CGroup: /system.slice/bluetooth.service
└─3136 /usr/lib/bluetooth/bluetoothd

Dec 07 12:31:14 t61p systemd[1]: Starting Bluetooth service...
Dec 07 12:31:14 t61p bluetoothd[3136]: Bluetooth daemon 5.11
Dec 07 12:31:14 t61p systemd[1]: Started Bluetooth service.
Dec 07 12:31:14 t61p bluetoothd[3136]: Starting SDP server
Dec 07 12:31:14 t61p bluetoothd[3136]: Bluetooth management interface 1.3 i...ed
Hint: Some lines were ellipsized, use -l to show in full.

PulseAudio デーモンを起動。X が起動してから通常ユーザーで実行してください:
$ pulseaudio -D

PulseAudio デーモンが動作していることを確認してください:
$ pulseaudio --check -v
I: [pulseaudio] main.c: Daemon running as PID 3186

Start up bluetoothctl as root and pair and connect your headset. As a regular user, bluetoothctl will pair but not connect. Perhaps this is related to the config file (shown below) which is setup for what appears to be the root user.
Note: the procedure shown below is for an initial pair and connect of the headphone. If the headset is already paired, then the procedure below can be shortened to: power on, agent on, default-agent, connect <mac address>. The mac address can be seen from the devices command output.

$ bluetoothctl
[NEW] Controller 00:1E:4C:F4:98:5B t61p-0 [default]
[NEW] Device 00:1A:7D:12:36:B9 SoundBot SB220
[bluetooth]# show
Controller 00:1E:4C:F4:98:5B
Name: t61p
Alias: t61p-0
Class: 0x000000
Powered: no
Discoverable: no
Pairable: yes
UUID: PnP Information (00001200-0000-1000-8000-00805f9b34fb)
UUID: Generic Access Profile (00001800-0000-1000-8000-00805f9b34fb)
UUID: Generic Attribute Profile (00001801-0000-1000-8000-00805f9b34fb)
UUID: A/V Remote Control (0000110e-0000-1000-8000-00805f9b34fb)
UUID: A/V Remote Control Target (0000110c-0000-1000-8000-00805f9b34fb)
UUID: Audio Source (0000110a-0000-1000-8000-00805f9b34fb)
UUID: Audio Sink (0000110b-0000-1000-8000-00805f9b34fb)
Modalias: usb:v1D6Bp0246d050B
Discovering: no
[bluetooth]# power on
[CHG] Controller 00:1E:4C:F4:98:5B Class: 0x0c010c
Changing power on succeeded
[CHG] Controller 00:1E:4C:F4:98:5B Powered: yes
[bluetooth]# agent on
Agent registered
[bluetooth]# default-agent
Default agent request successful

<power on your headset in pairing mode. Eventually you will see what appears to be a mac address.>
[bluetooth]# scan on
Discovery started
[CHG] Controller 00:1E:4C:F4:98:5B Discovering: yes
[CHG] Device 00:1A:7D:12:36:B9 RSSI: -61
[bluetooth]# pair 00:1A:7D:12:36:B9
Attempting to pair with 00:1A:7D:12:36:B9
[CHG] Device 00:1A:7D:12:36:B9 Connected: yes
[CHG] Device 00:1A:7D:12:36:B9 UUIDs has unsupported type
[CHG] Device 00:1A:7D:12:36:B9 Paired: yes
Pairing successful
[bluetooth]# connect 00:1A:7D:12:36:B9
[CHG] Device 00:1A:7D:12:36:B9 Connected: yes
Connection successful
[bluetooth]# info 00:1A:7D:12:36:B9
Device 00:1A:7D:12:36:B9
Name: SoundBot SB220
Alias: SoundBot SB220
Class: 0x240404
Icon: audio-card
Paired: yes
Trusted: no
Blocked: no
Connected: yes
LegacyPairing: yes
UUID: Headset (00001108-0000-1000-8000-00805f9b34fb)
UUID: Audio Sink (0000110b-0000-1000-8000-00805f9b34fb)
UUID: A/V Remote Control Target (0000110c-0000-1000-8000-00805f9b34fb)
UUID: A/V Remote Control (0000110e-0000-1000-8000-00805f9b34fb)
UUID: Handsfree (0000111e-0000-1000-8000-00805f9b34fb)

Start up alsamixer, for simplicity un-mute all your outputs. Oddly enough some can be muted though. The ones I had muted during playback were:
* Headphones
* SPIDF

Start up audacious. Use the menu to select PulseAudio as your output. Somewhere I read that bluez5 requires pulseaudio-git and this jives with my experience.

Start up pavucontrol in a terminal. In the Outputs tab select the bluetooth headset.

[http://netskink.blogspot.com/2013/12/pulseaudio-pavucontrol-and-audacious.html screenshot of application settings]

==== 設定ファイル ====

For reference, these settings were also done.

===== ALSA の /etc/asound.conf =====

The settings shown at the top of this page was used, but the additional modification for Intel laptop sound cards.

{{bc|<nowiki>
pcm.btheadset {
type plug
slave {
pcm {
type bluetooth
device 00:1A:7D:12:36:B9
profile "auto"
}
}
hint {
show on
description "BT Headset"
}
}
ctl.btheadset {
type bluetooth
}
options snd-hda-intel model=laptop
</nowiki>}}

===== /etc/dbus-1/system.d/bluetooth.conf =====

The settings here seem to be enabled for root only. See the policy user="root" section. However, if a regular user is specified here, the system fails to start. Someone with more knowledge could explain why.

{{hc|/etc/dbus-1/system.d/bluetooth.conf|<nowiki>


<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
"https://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>



<policy user="root">
<allow own="org.bluez"/>
<allow send_destination="org.bluez"/>
<allow send_interface="org.bluez.Agent1"/>
<allow send_interface="org.bluez.MediaEndpoint1"/>
<allow send_interface="org.bluez.MediaPlayer1"/>
<allow send_interface="org.bluez.ThermometerWatcher1"/>
<allow send_interface="org.bluez.AlertAgent1"/>
<allow send_interface="org.bluez.Profile1"/>
<allow send_interface="org.bluez.HeartRateWatcher1"/>
<allow send_interface="org.bluez.CyclingSpeedWatcher1"/>
</policy>

<policy at_console="true">
<allow send_destination="org.bluez"/>
</policy>


<policy group="lp">
<allow send_destination="org.bluez"/>
</policy>

<policy context="default">
<deny send_destination="org.bluez"/>
</policy>

</busconfig>
</nowiki>}}

===== テスト済みのアプリケーション =====

As noted above this will work easily with audacious. YouTube videos with Chromium and Flash Player will work on some videos. If the video has ads it will not work, but if the video does not have ads it will work. Just make sure that after audacious is working with Bluetooth headset, start Chromium, and navigate to YouTube. Find a video without leading ads, and it should play the audio. If the settings icon has the a menu with two drop-down combo boxes for Speed and Quality it will play.

== HSV と A2DP の設定の切り替え ==

以下のコマンドを実行することで簡単に切り替えられます (2 は適切なデバイス番号に置き換えて下さい):

pacmd set-card-profile 2 a2dp_sink

=== PulseAudio で A2DP が動作しない ===

==== Socket インターフェイスの問題 ====

bluez 4.1+ と PulseAudio 3.0+ を使っていて、PulseAudio でプロファイルを A2DP に切り替えられない場合、{{ic|/etc/bluetooth/audio.conf}} を編集して {{ic|1=Enable=Socket}} という行を削除して {{ic|1=Disable=Socket}} という行を追加することで Socket インターフェイスを無効化できます。

==== Gnome と GDM ====
{{Note|以下は Gnome 3.16.2 と PulseAudio 7.0 で確認済みです。}}

GNOME と GDM を使っている場合にプロファイルを A2DP に変更すると PulseAudio が動作しなくなる場合、GDM が PulseAudio のインスタンスを起動しないように設定する必要があります。[[#接続は成功するが、音が聞こえない]]に書かれている修正を試してください。

{{Note|1=この問題に関する議論は [https://bbs.archlinux.org/viewtopic.php?id=194006 こちら] や [https://bbs.archlinux.org/viewtopic.php?id=196689 こちら] にあります。}}

== Bluez5/bluez-alsa ==

以下の方法を使うのは PulseAudio を使えない、あるいは使いたくない場合に限ります。

まずはヘッドセットがペアリング・接続できることを確認してください。PulseAudio で {{ic|bluetoothctl}} を使用するのと同じです。

{{AUR|bluez-alsa-git}} をインストールして {{ic|bluealsa}} サービスを[[起動]]・[[有効化]]してください。

{{ic|/etc/dbus-1/system.d/bluetooth.conf}} ファイルを編集して以下を {{ic|</busconfig>}} の前に追加してください:

{{bc|
<policy user="bluealsa">
<allow send_destination="org.bluez"/>
</policy>
}}

最後に {{ic|bluealsa}} を使うために、使用しているユーザーを {{ic|audio}} グループに追加してください。

以下のコマンドでヘッドセットをテストできます (MAC アドレスや音声ファイルは適当に置き換えてください):
$ aplay -D bluealsa:HCI=hci0,DEV=00:1D:43:6D:03:26,PROFILE=a2dp ./testme.wav

音が鳴るのであれば HCI, DEV, PROFILE をデフォルトに設定できます。以下を {{ic|.asoundrc}} に追加してください:

{{bc|
defaults.bluealsa {
interface "hci0"
device "00:1D:43:6D:03:26"
profile "a2dp"
}
}}

これで bluealsa を使ってヘッドセットが使用できます。{{ic|alsamixer}} を使ってボリュームを設定することもできます ({{ic|alsamixer -D bluealsa}})。

== テスト済みのヘッドセット ==

{| class="wikitable"
! 機種
! バージョン
! コメント
! 対応状況
|-
| '''Philips SHB3060'''
| bluez 5.40, PulseAudio 9.0
| ボタンが機能しません。対応プロファイル: HSP (マイクロフォンも動作) と A2DP。
| {{Yes}}
|-
| '''Philips SHB4000WT'''
| bluez5
| A2DP で動作、HDP は問題あり。
| {{Yes}}
|-
| '''Philips SHB5500BK/00'''
| bluez 5.28, PulseAudio 6.0
| 停止・再生が機能せず。
| {{R|Limited}}
|-
| '''Philips SHB7000'''
|
| 停止・再生がおかしい。
| {{R|Limited}}
|-
| '''Philips SHB7100'''
| bluez 5.32, pulseaudio 6.0
| 次へ・前へボタンも動作。停止・再生は微妙 (VLC では動くこともあるが、Audacious では全く機能しない)。A2DP と Handsfree の音声出力のみで確認。マイクは機能せず。
| {{R|Limited}}
|-
| '''Philips SHB7150'''
| bluez 5.32, pulseaudio 6.0
| 次へ・前へボタンも動作。停止・再生は VLC では動作。A2DP プロファイルでのみ確認。
| {{Yes}}
|-
| '''Philips SHB9100'''
|
| 停止・再生がおかしい。音質を改善する一時的な方法は [https://bbs.archlinux.org/viewtopic.php?pid=1315428#p1315428] を参照。
| {{R|Limited}}
|-
| '''Philips SHB9150'''
| bluez5, pulseaudio 9
|
| {{Yes}}
|-
| '''Philips AEA2000/12'''
| bluez5
|
| {{Yes}}
|-
| '''Parrot Zik'''
|
| マイクは認識されますが機能しません (HSP プロファイルは使えません)。Bluetooth 接続が切れると、音声に遅延が発生します。Bluetooth 接続を初期化することで解決します。
| {{R|Limited}}
|-
| '''Parrot Zik 2.0'''
|
| マイクは認識されますが機能しません (HSP プロファイルは使えません)。Bluetooth 接続が切れると、音声に遅延が発生します。Bluetooth 接続を初期化することで解決します。
| {{R|Limited}}
|-
| '''Parrot Zik 3.0'''
|
| マイクは認識されますが機能しません (HSP プロファイルは使えません)。遅延の問題はありません。
| {{R|Limited}}
|-
| '''Sony DR-BT50'''
| bluez{4,5}
| a2dp で動作。[http://vlsd.blogspot.com/2013/11/bluetooth-headphones-and-arch-linux.html] を参照。アダプタ: D-Link DBT-120 USB ドングル。
| {{Yes}}
|-
| '''Sony SBH20'''
| bluez 5.30, pulseaudio 6.0
| A2DP プロファイルで問題なく動作。
| {{Yes}}
|-
| '''Sony SBH50'''
| bluez5
| a2dp で動作。アダプタ: Broadcom Bluetooth 2.1 Device (Vendor=0a5c ProdID=219b Rev=03.43)。{{ic|btusb}} [[modprobe|モジュール]]が必要。
| {{Yes}}
|-
| '''Sony SBH80'''
| bluez 5.36, pulseaudio 7.1
| メディアボタンは機能せず。blueman でプロファイルを無効化して A2DP を有効化することで動作。
| {{Yes}}
|-
| '''Sony MDR-XB950BT'''
| pulseaudio
| a2dp でテスト済み。アダプタ: Grand-X BT40G。自動で接続されない場合、手動で接続する必要があります。他の機能は問題なく動作。
| {{R|Limited}}
|-
| '''Sony MDR-ZX330BT'''
| bluez 5.31, pulseaudio 6.0
| 何も設定しなくても動作 (HSP/HFP と A2DP)。ボタンは特定のアプリで動作。
| {{Yes}}
|-
| '''Sony MUC-M1BT1'''
| bluez5, {{AUR|pulseaudio-git}}
| A2DP & HSP/HFP どちらも問題なく動作。
| {{Yes}}
|-
| '''Sony WH-1000XM3'''
| bluez5, {{AUR|pulseaudio-git}}
| A2DP & HSP/HFP どちらも動作するが、マイクの使用はできず。右側面のタッチコントロールは音量操作のみ使用できます。
| {{R|Limited}}
|-
| '''SoundBot SB220'''
| bluez5, {{AUR|pulseaudio-git}}
|
| {{Yes}}
|-
| '''Auna Air 300'''
| bluez5, pulseaudio-git
| 何らかの理由で、再起動が必要ですが、それで問題なく起動します。
| {{R|Limited}}
|-
| '''Sennheiser MM 400-X'''
| bluez5, pulseaudio 4.0-6
|
| {{Yes}}
|-
| '''Sennheiser MM 550-X Travel'''
| bluez 5.27-1, pulseaudio 5.0-1
| 次・前ボタンは何も設定しなくても動作しますが、再生・停止ボタンは動作しません。
| {{Yes}}
|-
| '''Sennheiser URBANITE XL Wireless'''
| bluez 5.37-2, pulseaudio 7.1-3
| A2DP 高音質再生。再生・停止・次へ・前へも問題なく動作。
| {{Yes}}
|-
| '''Sennheiser Momentum 2'''
| bluez5, pulseaudio 9.0-1
| GDM で起動できない問題を解決しないと A2DP プロファイルの変更に失敗することがあります。
| {{Yes}}
|-
| '''Audionic BlueBeats (B-777)'''
| bluez5, pulseaudio 4.0-6
|
| {{Yes}}
|-
| '''Logitech Wireless Headset'''
| bluez 5.14, pulseaudio-git
| 製造番号 PN 981-000381。iPad 用と喧伝されているヘッドセット。
| {{Yes}}
|-
| '''Logitech UE9000'''
| bluez 5.37, pulseaudio 7.1, gnome 3.18.2
| [[#接続は成功するが、音が聞こえない|gnome/gdm の修正]]をすることで再生可能。音声プロファイルのデフォルトは HSP/HFP。マイクは HSP/HFP と A2DP プロファイルのどちらでも動作。再生・停止や次へ・前へは Spotify や VLC で機能する。
| {{Yes}}
|-
| '''HMDX Jam Classic Bluetooth'''
| bluez, pulseaudio-git
|
| {{Yes}}
|-
| '''PT-810'''
| bluez 5.14, pulseaudio-git
| 汎用の USB 給電 Bluetooth 音声レシーバー。3.5mm ヘッドセットジャックと a2dp プロファイルで機能。"USB Bluetooth Receiver" ID として PT-810 は広く使えます。
| {{Yes}}
|-
| '''Nokia BH-104'''
| bluez4
|
| {{Yes}}
|-
| '''Creative AirwaveHD'''
| bluez 5.23
| Bluetooth アダプタ Atheros Communications usb: 0cf3:0036
| {{Yes}}
|-
| '''Creative HITZ WP380'''
| bluez 5.27, pulseaudio 5.0-1
| A2DP プロファイルのみ。ボタンも動作 (再生, 停止, 次へ, 前へ)。ボリュームボタンはハードウェアのみ。自動接続もできるが bluetooth モジュールを "pulseaudio" に組み込んで自動的に切り替えさせる必要がある。ハイレゾ再生もクリア (デバイスとしては APTx コーデックをサポートしていますが Linux ではまだ対応されていません)。遅延の問題が発生するときは pulseaudio を再起動する必要あり。
| {{Yes}}
|-
| '''deleyCON Bluetooth Headset'''
| bluez 5.23
| アダプタ: CSL - USB nano Bluetooth-Adapter V4.0。a2dp プロファイルでテスト。マイクは未テスト。(ペアリングしても) 自動接続は行われないため、手動で接続する必要あり。再生/停止ボタンを押すとヘッドフォンがミュート/アンミュートになるが、再生には影響なし。次に進む/前に戻るボタンは動作せず (''xev'' で変化なし)。
| {{R|Limited}}
|-
| '''UE BOOM'''
| bluez 5.27, pulseaudio-git 5.99
| 最新の UE BOOM fw 1.3.58 にアップデート。動画再生における音声の遅延は pavucontrol を設定することで解決できる。UE BOOM x2 で動作。
| {{Yes}}
|-
| '''LG HBS-730'''
| bluez 5.30, pulseaudio 6.0
| A2DP プロファイルで何も設定しなくても動作。
| {{Yes}}
|-
| '''LG HBS-750'''
| bluez 5.30, pulseaudio-git 6.0
| A2DP プロファイルで何も設定しなくても動作。
| {{Yes}}
|-
| '''Beats Studio Wireless'''
| bluez 5.28, pulseaudio 6.0
| 何も設定しなくても動作。マルチメディアボタンは未テスト。
| {{Yes}}
|-
| '''AKG Y45BT'''
| bluez 5.30, pulseaudio 6.0
| 停止・再生が動作せず。{{ic|/etc/bluetooth/audio.conf}} に {{ic|1=Enable=Socket}} を、{{ic|/etc/pulse/default.pa}} に {{ic|load-module module-bluetooth-discover}} を設定する必要あり。
| {{Yes}}
|-
| '''Bluedio Turbine/Turbine 2+'''
| bluez 5.3, pulseaudio 6.0
| HSP/HFP で動作、A2DP も問題なく動作。
| {{Yes}}
|-
| '''Nokia BH-111'''
| bluez 5.30, pulseaudio 6.0
| HSP/HFP と A2DP どちらでも動作。ボタンは特定のアプリで動作。
| {{Yes}}
|-
| '''Samsung Level Link'''
| bluez 5.33, pulseaudio 6.0
| 何も設定しなくても動作 (HSP/HFP と A2DP)。ボタンは特定のアプリで動作。
| {{Yes}}
|-
| '''Bernafon Soundgate 3'''
| bluez 5.34-2, pulseaudio 7.0-1
| blueman-git 2.0.r53.g2a812a8-1 をインストールすることで動作 (A2DP)。
| {{Yes}}
|-
| '''JBL E40 BT'''
| bluez 5.35, pulseaudio 7.0
| blueberry と blueman をインストールすることで接続可能。{{ic|1=Disable=Socket}} を {{ic|/etc/bluetooth/audio.conf}} に追加することで A2DP が動作。メディアボタンも動作。
| {{Yes}}
|-
| '''JBL Everest 300'''
| bluez 5.37, pulseaudio 8.0
| 全てが問題なく動作。HSP/HFP プロファイルでヘッドフォンを接続すると音質が悪いが、'''pavucontrol''' でプロファイルを A2DP sink に切り替えることで音質はかなり改善する。ペアリングに問題なし。
| {{Yes}}
|-
| '''Kitsound Manhattan'''
| bluez 5.37, pulseaudio 7.13
| 全て問題なし。Pulseaudio をユーザーでなく root で ( --system) 動作させた場合、ペアリングしても接続できなかったり、(アクセス PIN を要求して) システムがフリーズしてしまう可能性あり。注意が必要。
| {{Yes}}
|-
| '''Jawbone Jambox'''
| bluez 5.38, pulseaudio 8.0
|
| {{Yes}}
|-
| '''Plantronics BackBeat FIT'''
| bluez5, pulseaudio 8.0
| ヘッドセットと a2dp プロファイルどちらも完全に動作。停止ボタンでプレイヤーを停止できます ([[mpv]] で確認)。
| {{Yes}}
|-
| '''Plantronics BackBeat Pro'''
| bluez5, pulseaudio 9.0
| ヘッドセットと a2dp プロファイルどちらも完全に動作。停止ボタンを押したりヘッドセットを外すとプレイヤーが停止します。
| {{Yes}}
|-
| '''Aukey EP-B26'''
| bluez 5.39-1, pulseaudio 8.0-3
| ヘッドセット (低品質) と a2dp (高品質) プロファイルどちらも完全に動作。停止ボタンでプレイヤーを停止したり、次・前ボタンで曲を変えられます。マイクは HSP/HFP モードでのみ動作。
| {{Yes}}
|-
| '''Bose AE2 SoundLink'''
| bluez 5.36, pulseaudio 7.1
| 停止・再生ボタンが動作しません。マイクも使えません。
| {{R|Limited}}
|-
| '''Bose QuietComfort 35'''
| bluez 5.41, pulseaudio 9.0
| {{ic|1=ControllerMode=bredr}} を設定することでペアリングできます。
| {{Yes}}
|-
| '''Blue Tiger Dual Elite'''
| bluez-5.42-1, pulseaudio 9.0-1
| {{ic|1=pulseaudio-bluetooth}} パッケージで接続できます。マイクや操作ボタンは未確認。
| {{Yes}}
|}

== 参照 ==

Windows と Linux でペアリングを解除しないでデバイスを共有する方法:

* [https://ubuntuforums.org/showthread.php?p=9363229#post9363229 Dual booting with a Bluetooth keyboard]

Xinit

2022-08-23T12:46:49Z

がおびん: /* xinitrc */ 英語部分を日本語に翻訳

{{Lowercase title}}
[[Category:Xorg コマンド]]
[[de:Xinitrc]]
[[en:Xinit]]
[[es:Xinit]]
[[fr:Xinit]]
[[it:Xinit]]
[[pt:Xinit]]
[[ru:Xinit]]
[[zh-hans:Xinit]]
{{Related articles start}}
{{Related|ディスプレイマネージャ}}
{{Related|Xorg}}
{{Related|xprofile}}
{{Related|X resources}}
{{Related articles end}}

{{ic|~/.xinitrc}} ファイルは {{ic|xinit}} や {{ic|startx}} によって読み込まれるシェルスクリプトです。主として、X サーバーが起動した時に[[デスクトップ環境]]や[[ウィンドウマネージャ]]などのプログラムを起動するのに使われます (デーモンの起動や環境変数のセットなど)。{{ic|xinit}} と {{ic|startx}} プログラムは [[Xorg|X Window System]] を起動させ、X を直接 {{ic|/etc/init}} から起動できないシステムや複数のウィンドウシステムを使っている環境で、一番最初のクライアントプログラムとして動作します。

{{ic|~/.xinitrc}} の主要な仕事の一つは、{{ic|/usr/bin/startx}} や {{ic|/usr/bin/xinit}} プログラムが実行されたときに X Window System のためにどのクライアントを呼び出すか指定することです。様々な追加の記述やコマンドが存在しており、それらを {{ic|~/.xinitrc}} に追加して、その後のシステムのカスタマイズも行えます。

ほとんどの DM は xinit の前に同じようなファイルである [[xprofile]] も読み込みます。

== インストール ==

{{Pkg|xorg-xinit}} を[[インストール]]してください。

== 設定 ==

''xinit'' と ''startx'' はオプションでクライアントプログラムの引数を取ります。[[#Override xinitrc]] を参照してください。もし、引数を与えなければ、クライアントプロラムを起動するシェルスクリプトとして、{{ic|~/.xinitrc}} を探します。

=== xinitrc ===

{{ic|~/.xinitrc}} は X に応じてプログラムを実行し、X サーバーの起動時に環境変数を設定するのに便利です。ユーザーのホームディレクトリに存在する場合は、''startx'' と ''xinit'' が実行します。それ以外の場合、''startx'' はデフォルトの {{ic|/etc/X11/xinit/xinitrc}} を実行します。

{{note|''Xinit'' には、ファイルを実行する代わりに独自のデフォルトの動作があります。詳細については、{{man|1|xinit}} を参照してください。}}

デフォルトの xinitrc は [[Twm]] と, {{Pkg|xorg-xclock}}, [[Xterm]] とで基本的な環境をスタートします（必要なパッケージはインストールされているとして。）そのため、別のウィンドウマネージャやデスクトップ環境を始めるには、まずデフォルトの {{ic|xinitrc}} のコピーをホームディレクトリに作成します。

$ cp /etc/X11/xinit/xinitrc ~/.xinitrc

それからそのファイルを編集して、デフォルトのプログラムを必要なコマンドに置き換えます。 {{ic|exec}} で実行するコマンドに続く行は無視されることを覚えておいてください。たとえば、{{ic|xscreensaver}} をバックグラウンドで開始してから [[Openbox#Standalone|openbox]] を開始するには、以下のように記述します:

{{hc|~/.xinitrc|
...
xscreensaver &
exec openbox-session}}

{{Note|最低限、{{ic|/etc/X11/xinit/xinitrc}} にある最後の {{ic|if}} ブロックが、あなたの {{ic|~/.xinitrc}} ファイルにあることを確認してください。これにより、 {{ic|/etc/X11/xinit/xinitrc.d}} にあるスクリプトが読み込まれることを確認できます。}}

スクリーンセーバーや壁紙アプリケーションといった、長く実行されるプログラムがウィンドウマネージャの前に開始される場合、それらをフォークするか {{ic|&}} 記号をつけてバックグラウンドで実行しなければなりません。そうしないと、スクリプトはウィンドウマネージャやデスクトップ環境を実行する前に停止し、それらのプログラムが終了するのを待ちます。いくつかのプログラムは、 [[xrdb]] のように、レースバグを回避するためフォークしないでください。{{ic|exec}} を前につけることで、スクリプトプロセスをウィンドウマネージャプロセスへ入れ替えることができます。これにより、たとえこのプロセスがバックグランドへフォークされても X が終了しないようにできます。

=== xserverrc ===

{{ic|xserverrc}} ファイルは、X サーバーの起動を担当するシェルスクリプトです。''startx'' と ''xinit'' はどちらも {{ic|~/.xserverrc}} が存在すればそれを実行し、 ''startx'' はそうでなければ {{ic|/etc/X11/xinit/xserverrc}} を使用します。

{{ic|logind}} で [[一般的なトラブルシューティング#セッションのパーミッション|セッションのパーミッション]] を維持し、端末を切り替えてスクリーンロッカーを回避するのを防ぐために、ログインしたのと同じ仮想端末で [[Xorg]] を起動しなければなりません [http://blog.falconindy.com/articles/back-to-basics-with-x-and-systemd.html]。そのため、{{ic|~/.xserverrc}} ファイルで {{ic|vt$XDG_VTNR}} を指定することが推奨されます。

{{hc|~/.xserverrc|
#!/bin/sh

exec /usr/bin/Xorg -nolisten tcp "$@" vt$XDG_VTNR
}}

全てのコマンドラインオプションの一覧は {{man|1|Xserver}} を参照してください。

{{Tip|{{ic|-nolisten local}} を {{ic|-nolisten tcp}} の後に追加すると、X11 の抽象ソケットを無効にして分離を助けることができます。これが X11 のセキュリティにどのように影響するかについては、[https://tstarling.com/blog/2016/06/x11-security-isolation/ quick background] があります。}}

また、サーバを起動するコンソールとは別のコンソールで X を表示させたい場合は、 {{ic|/usr/lib/systemd/systemd-multi-seat-x}} が提供する X サーバラッパーを使って表示させることも可能です。便利なように、 ''xinit'' と ''startx'' は {{ic|~/.xserverrc}} を修正することでこのラッパーを使うようにセットアップすることができます。

{{Note|X セッションから Xorg ログファイルへの出力のリダイレクトを再び有効にするには、{{ic|-keeptty}} オプションを追加してください。詳しくは [[Xorg#セッションログのリダイレクト]] を見て下さい。}}

== 使用方法 ==

Xorg を通常のユーザーとして実行するには、次のように実行します。

$ startx

または、[[#xserverrc]] が設定されている場合は:

$ xinit -- :1

{{Note|''xinit'' は他の X サーバーがすでに起動している場合は、複数の表示を処理しません。その場合は、{{ic|-- :''display_number''}} ({{ic|''display_number''}} は {{ic|1}} 以上) を付けてディスプレイを指定してください。}}

これでお好みのウィンドウマネージャー(またはデスクトップ環境)が正しく起動するはずです。

X を終了するには、ウィンドウマネージャーの exit 関数を実行してください(exit 関数があれば)。そのような機能がない場合は次のように実行します。

$ pkill -15 Xorg

{{Note|''pkill'' は実行中の X インスタンスを全て kill します。現在の仮想端末上のウィンドウマネージャーを kill するには、次のように実行します:

$ pkill -15 -t tty"$XDG_VTNR" Xorg
}}

{{man|7|signal}} も参照してください。

== ヒントとテクニック ==

=== コマンドラインから xinitrc を上書きする ===

{{ic|~/.xinitrc}} は既に記述しているが、他の WM/DE を試してみたい場合、ウィンドウマネージャのパスを加えて {{ic|startx}} を実行することができます:

$ startx /full/path/to/window-manager

フルパスが必要なので注意してください。

ウィンドウマネージャに引数を指定する場合、''startx'' のパラメータとしてクォートで囲う必要があります:
$ startx "/full/path/to/window-manager --key value"

また、{{ic|--}} の後にカスタムオプションを指定して (デフォルトの X サーバーオプションが入っている) {{ic|/etc/X11/xinit/xserverrc}} を上書きすることもできます。例:

$ startx /usr/bin/enlightenment -- -nolisten tcp -br +bs -dpi 96 vt$XDG_VTNR

または:

$ xinit /usr/bin/enlightenment -- -nolisten tcp -br +bs -dpi 96 vt$XDG_VTNR

{{ic|man startx}} を参照してください。

{{Tip|通常の GUI プログラムを起動するのに使うこともできます。[[#ウィンドウマネージャを使わずにアプリケーションを起動]] や [[ゲーム#別の X サーバーでゲームを起動する]] を参照。}}

=== ログイン時に X を自動起動 ===

''startx'' が正しく [[xinit#設定|設定]] されていることを確認します。

[[コマンドラインシェル#ログインシェル|ログインシェル]] の初期化ファイル (例: [[Bash]] の場合は {{ic|~/.bash_profile}}, [[Zsh]] の場合は {{ic|~/.zprofile}}) に以下の内容を記述してください。

{{bc|1=<nowiki>
if [ -z "${DISPLAY}" ] && [ "${XDG_VTNR}" -eq 1 ]; then
exec startx
fi
</nowiki>}}

複数の仮想端末でグラフィカルログインを使用したい場合は、{{ic|-eq}} の比較を {{ic|-le 3}} (vt1 から vt3 まで) のようなものに置き換えることが可能です。

仮想端末を検出する別の条件として、{{ic|<nowiki>"$(tty)" = "/dev/tty1"</nowiki>}} は {{ic|-le}} との比較が出来ません、 {{ic|<nowiki>"$(fgconsole 2>/dev/null || echo -1)" -eq 1</nowiki>}} は [[シリアルコンソール]] では機能しないことが挙げられます。

X セッションが終了してもログインしたままにしたい場合は、{{ic|exec}} を削除してください。

{{Warning|{{ic|exec}} がなければ、X を Kill することができます、これであなたのホームディレクトリのシェルとファイルへのアクセスを取得することができます。このことがあなたにとって重要かどうか、上記のことを実行する前に判断してください}}

[[Fish# ログイン時に X を起動|ログイン時に X を起動]] と [[systemd/ユーザー#ディスプレイマネージャを使わずに Xorg に自動ログイン]] も参照してください。

{{Tip|この方法は [[getty#仮想端末に自動ログイン|仮想端末に自動ログイン]] と組み合わせることができます}}

=== DE/WM の選択 ===

様々な DE/WM を頻繁に切り替えて使っている場合、[[ディスプレイマネージャ]]を使うか、以下のコードを {{ic|.xinitrc}} に追加することを推奨します。引数を使って起動したいデスクトップ環境やウィンドウマネージャをロードします:

{{hc|~/.xinitrc|<nowiki>
...

# Here Xfce is kept as default
session=${1:-xfce}

case $session in
awesome ) exec awesome;;
bspwm ) exec bspwm;;
catwm ) exec catwm;;
cinnamon ) exec cinnamon-session;;
dwm ) exec dwm;;
enlightenment ) exec enlightenment_start;;
ede ) exec startede;;
fluxbox ) exec startfluxbox;;
gnome ) exec gnome-session;;
gnome-classic ) exec gnome-session --session=gnome-classic;;
i3|i3wm ) exec i3;;
icewm ) exec icewm-session;;
jwm ) exec jwm;;
kde ) exec startkde;;
mate ) exec mate-session;;
monster|monsterwm ) exec monsterwm;;
notion ) exec notion;;
openbox ) exec openbox-session;;
unity ) exec unity;;
xfce|xfce4 ) exec startxfce4;;
xmonad ) exec xmonad;;
# No known session, try to run it as command
*) exec $1;;
esac
</nowiki>}}

{{ic|/etc/X11/xinit/xserverrc}} ファイルをホームディレクトリにコピーしてください:

$ cp /etc/X11/xinit/xserverrc ~/.xserverrc

その後、引数を指定して特定の DE/WM を起動することができます:

$ xinit
$ xinit gnome
$ xinit kde
$ xinit wmaker

または:

$ startx
$ startx ~/.xinitrc gnome
$ startx ~/.xinitrc kde
$ startx ~/.xinitrc wmaker

=== ウィンドウマネージャを使わずにアプリケーションを起動 ===

ウィンドウマネージャを使わずに特定のアプリケーションだけを起動することも可能です。フルスクリーンモードで何か一つのアプリケーションを表示したいときに有用です。例:

{{hc|~/.xinitrc|
...

exec chromium
}}

この方法を使うときはアプリケーションのウィンドウの配置を、アプリケーションの設定ファイルで設定しておく必要があります。

{{Tip|この方法を使ってグラフィカルなゲームを起動することも可能です。特に、ウィンドウマネージャやデスクトップ環境、またはデスクトップアクセサリといったアプリケーションによるメモリと CPU の消費を抑えて、ゲームの実行パフォーマンスを底上げすることができます。}}

[[ディスプレイマネージャ#ウィンドウマネージャを使わずにアプリケーションを起動]]も見て下さい。

=== startx 使用時の出力のリダイレクト ===

詳細は、[[Xorg#Session log redirection]] を参照してください。

Emacs

2021-12-03T13:40:36Z

がおびん: /* トラブルシューティング */ 英語の記述を日本語に翻訳した。

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[Category:GNU]]
[[de:Emacs]]
[[en:Emacs]]
[[es:Emacs]]
[[fr:Emacs]]
[[sr:Emacs]]
[[zh-hans:Emacs]]
[[Wikipedia:ja:Emacs|Emacs]] は拡張性があり、カスタマイズ可能な、セルフドキュメント方式のリアルタイム表示エディタです。Emacs のコアには、多数の Emacs の内蔵機能や拡張を実装するのに使われている言語である、[[Wikipedia:ja:Emacs Lisp|Emacs Lisp]] のインタプリタが存在します。GNU Emacs 22 から GTK がデフォルトの X ツールキットとして使われていますが、CLI 環境でも負けず劣らずに機能します。

== インストール ==

Emacs には複数の種類があります (時々 ''emacsen'' と呼ばれます)。その中で最も一般的なのは [https://www.gnu.org/software/emacs/ GNU Emacs] です。

{{Pkg|emacs}} パッケージを[[インストール]]してください。いつもターミナルで作業をする場合は、GTK+ がいらない {{Pkg|emacs-nox}} の方が良いでしょう (サウンドなどの装飾的な機能もありません)。
ただしテキストバージョンにはいくつか欠点が存在します: サポートしている色やフォント処理の機能 (実行中にサイズを変更したり、単一の文章で複数のサイズを使うなど) が少なくなっています。その上、emacs-nox には Speedbar や GUD (デバッグ環境) などの高度な機能について制限があり、複雑なフェイスを使おうとするとやや遅くなります ("フェイス"とは Emacs におけるテキストの外観のことです)。

== Emacs の実行 ==

emacs を起動する前に、終了の方法を知っておきましょう (特にターミナルで実行する場合): {{ic|Ctrl+x}}{{ic|Ctrl+c}} キーシーケンスを使って下さい。

Emacs を起動するには次を実行:

$ emacs

また、コンソールから使うには:

$ emacs -nw

(.emacs を使わずに) 高速でロードして CLI で編集するには:

$ emacs -Q -nw

nox バージョンをインストールしている場合、'emacs' と 'emacs -nw' は同じになります。

ファイル名を指定することですぐにファイルを開くこともできます:

$ emacs filename.txt

=== 色無し ===

デフォルトでは、Emacs はハイパーリンクが濃青で表示されるカラーテーマで起動します。Emacs をカラーテーマやスキームを使わずに起動するには:

$ emacs -nw --color=no

このコマンドでは全てのテキストがターミナルの前景色だけで表示されます。通常は黒背景に白字か、白背景に黒字となります。

=== デーモンとして ===

毎回 {{ic|.emacs}} ファイルをロードするため Emacs を起動するときには時間が多少かかります。また、別のインスタンスから同じファイルにアクセスしたいと思うときもあるかもしれません。バージョン23から、Emacs はユーザーが接続できるデーモンとして起動することが可能になっています。Emacs をデーモンとして実行するには:

$ emacs --daemon

起動時にデーモンを実行してウィンドウをデーモンに接続すると良いでしょう。さらに、グラフィカル・コンソールクライアント''両方を''同意時にデーモンに接続して GUI を素早く起動することも可能です。

デーモンに接続したいときは場合は次のコマンドを使って下さい (グラフィカル環境から実行したときはグラフィカルクライアントが、tty などのコンソールから実行したときはコンソールクライアントが起動します):

$ emacsclient

グラフィカル環境にいるときもコンソールクライアントを使いたい場合は次のコマンドを使って下さい:

$ emacsclient -t

さらに、{{ic|-a ""}} パラメータを追加することもできます。
これで、最初にコマンドを実行したときは、デーモンとして emacs が起動します。バックグラウンドで動き続けるので後で呼び出した時に起動時間が早くなります (バッファも残り続けます)。

ターミナルや他のプログラムからクライアントを起動した場合、呼び出すプログラムを使うことで Emacs クライアントを閉じなくてもクライアントを使い続けることができます。そのためには、 {{ic|-n}} ({{ic|--no-wait}}) パラメータを使ってクライアントを起動します:
$ emacsclient -nc

Mutt や Git などのプログラムは (コミットメッセージを読むための) エディタが終了するまで待機するため、{{ic|-n}} パラメータを使うことはできません。デフォルトエディタが設定されている場合、他のエディタを指定する必要があるかもしれません (例: {{ic|emacsclient -a "" -t}})。

以下のシェル設定が利用できます:

{{bc|1=
alias emt='emacsclient -nc -a ""'
alias emc='emacsclient -t -a ""'
EDITOR='emacsclient -a ""'
}}
ただしこれには注意事項があります: コマンドのスペースの関係で多数のプログラムが外部エディタをロードすることはできません。

スクリプトを書くほうがもっと使い勝手が良く信頼性があります:
{{hc|/usr/local/bin/emc|<nowiki>
#!/bin/sh
if [ -z "$DISPLAY" ]; then
IS_GRAPHICAL=true
else
IS_GRAPHICAL=$(emacs --batch -Q --eval='(if (fboundp '"'"'tool-bar-mode) (message "true") (message "false"))' 2>&1)
fi

if $IS_GRAPHICAL; then
emacsclient -a "" -nc "$@"
else
emacsclient -a "" -t "$@"
fi
</nowiki>}}
スクリプトは実行可能属性を付けて下さい:
# chmod 755 /usr/local/bin/emc

これで 'emc' が期待通りに動作するようになります。このクライアントをデフォルトのエディタにしたいときは上記のスクリプトで {{ic|EDITOR}} 環境変数を設定すれば OK です。

=== systemd ユニットとして ===

Emacs 26.1 から systemd ユニットが含まれています。Emacs のインストール後に以下のように有効化してください:

$ systemctl --user enable --now emacs

Emacs サーバーを実行したいユーザーで上記のコマンドを実行してください。サービスの起動後、Emacs の準備ができます。ユニットファイルは {{ic|/usr/lib/systemd/user/emacs.service}} に存在します。ユニットファイルの中身は以下のようになっています:

{{hc|/usr/lib/systemd/user/emacs.service|<nowiki>
[Unit]
Description=Emacs text editor
Documentation=info:emacs man:emacs(1) https://gnu.org/software/emacs/

[Service]
Type=simple
ExecStart=/usr/bin/emacs --fg-daemon
ExecStop=/usr/bin/emacsclient --eval "(kill-emacs)"
Environment=SSH_AUTH_SOCK=%t/keyring/ssh
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

systemd のユーザーユニットはログインシェル ({{ic|~/.bash_profile}} など) から環境変数を継承しないため、{{ic|~/.pam_environment}} に変数を設定すると良いでしょう。詳しくは [[Systemd/ユーザー]]を参照。

emacs をデーモンとして起動する場合、{{ic|VISUAL}} と {{ic|EDITOR}} 環境変数を {{ic|emacsclient}} に設定することでプログラムからエディタを起動するときにエディタの新しいインスタンスを起動するかわりに emacsclient が使われるようになります。外部エディタを使用するプログラムとしてメールプログラム (メッセージを編集するため) や Git (コミットメッセージを編集するため)、less ({{ic|v}} コマンドで表示されたファイルを編集するため) などが存在します。emacsclient の {{ic|-n}} ({{ic|--nowait}}) オプションは使用しないでください。基本的にプログラムはエディタが終了したときに編集が完了したと認識するためです。

GUI の Emacs のスタートメニューエントリなども emacs ではなく emacsclient が使われるように変更することを推奨します。

== クイックスタート ==

Emacs は複雑ですが、そのカスタマイズと拡張性のレベルによってもたらされる利益を理解し始めるのにそう時間はかからないでしょう。さらに、幅広い拡張を利用することで Emacs はあらゆる種類の文章編集のための強力な環境に姿を変えることができます。

Emacs には素晴らしいチュートリアルが内蔵されており、スプラッシュ画面の最初のリンクをクリックしてアクセスできます。メニューから ''Help->Emacs Tutorial'' を選択するか 'F1' の後に 't' を押して下さい。このページは Emacs を始めるのに追加的なリソースになるように書かれています。

初心者にもエキスパートにも役立つ、リファレンスカードのセットも Emacs に含まれています、{{ic|/usr/share/emacs/<version>/etc/refcards/}} を見て下さい (<version> はあなたの emacs のバージョンに置き換えて下さい)。

=== 基本的な用語と慣習 ===

始めは慣れないと思うかもしれませんが Emacs にはいくつか特別な用語法と約束事があり、必要に応じて紹介していきます。ただ、Emacs を使うにあたって当然知ってるべきとされるような、基本的な用語についてはあらかじめ説明しておいたほうが良いでしょう。

真っ先に知るべきは''バッファ''の概念です。バッファは Emacs の中のデータを表します。例えば、Emacs でファイルを開いたとき、ディスクからファイルから読み込まれてバッファに中身が保存され、バッファを編集して後でディスクに上書き保存することができます。バッファはテキストに限られず、画像やウィジェットなども含めます。作業中でもバッファでアプリケーションを表示することすらできます。こういう考え方もできます: ディスク上のデータは'ファイル'であり、一方、Emacs 上のデータは'バッファ'である。

Emacs におけるキーシーケンスの決まり事も見慣れないかもしれません。即ち:

'''C-x''' は Control-x を示します

'''M-x''' は Meta-x を示します

{{Note|'Meta' は多くの場合 Alt キーに相当します。また、Esc キーを使うことも可能です。}}

例えば、Emacs を終了するには次のキーシーケンスを使います: '''C-x C-c'''。これは "Control を押しながら 'x' を押す。手を離す。Control を押しながら 'c' を押す" と読み替えることができます。Emacs にはメニューバーが存在しますが、キーシーケンスを使いこなせるように練習することを推奨します。以下から、Emacs で使われるキーバインディングと慣習について説明します。

=== 移動 ===

カーソルの移動は他のグラフィカルエディタとよく似ています。マウスや方向キーを使ってカーソルの位置 (Emacs では''ポイント''と呼ばれます) を変更することができます。一般的な移動コマンドは方向キーで出来ますが、Emacs には他にも便利なバインディングが存在します。1文字先に移動するには '''C-f''' を使用して、1文字前に移動するには '''C-b''' を使用します。'''C-n''' と '''C-p''' でそれぞれ次の行と前の行に移動できます。基本的に、マウスや方向キーを使うよりもこれらのキーシーケンスを使うことが推奨されています。

当然、Emacs には、単語や文単位で移動できる、もっと高度な移動コマンドが用意されています。'''M-f''' は1単語先に移動して '''M-b''' は1単語前にポイント移動します。同じく、'''M-e''' は1文先にポイント移動して '''M-a''' は前に戻ります。

ここまでは、紹介した全ての移動コマンドはポイントに関連しています。'''M-<''' を使うことでバッファの最初にポイントを移動することができ、逆に、'''M->''' はバッファの最後に移動します。特定の行番号にポイントを移動するには、'''M-g g''' を使います。'''M-g g''' は移動したい行番号を尋ねます。また、現在の行の先頭と末尾に移動するには、'''C-a''' あるいは '''C-e''' を使って下さい。

{{Note|上記のコマンドを含む全てのコマンドのキーバインドは、現在有効になっているモードによって''多少''ながら変わってくる可能性があります。しかしながら、同一の機能を実行するのにコマンドを置き換えることはあまりありません。詳しくは[[#モード|モード]]を見て下さい。}}

=== ファイルとバッファ ===

Emacs にはファイルを操作するためのコマンドが用意されています。このセクションでは最もよく使われるコマンドを紹介します。ファイルを開くには '''C-x C-f''' を使います (Emacs ではこのコマンドを 'find-file' と呼びます)。指定されたファイルが存在しなかった場合、Emacs は空のバッファを開きます。バッファを保存するとバッファの中身が入ったファイルが作成されます。'''C-x C-s''' を使うことでバッファを保存できます。別のファイル名でバッファを保存するには、'''C-x C-w''' を使って下さい (this is a mnemonic for the command 'write-file')。新しいファイル名が尋ねられ、ディスクにファイルが書き込まれます。'''C-x s''' で全てのバッファを保存することも可能です。最後に保存されていた状態からバッファに変更が加えられている場合、保存を実行するかどうか訊くプロンプトが表示されます。

{{Note|ファイルに対応するバッファが既に開かれている場合 '''C-x C-f''' はディスクからファイルを読み込みません。ディスクからファイルを再度読み込むには、(1) まずバッファを閉じて ('''C-x k''')、それからファイルを開くか ('''C-x C-f''') あるいは (2) '''M-x revert-buffer''' を使ってディスク上のデータに戻して下さい。それか (3) '''C-x C-v''' でファイルを現在のバッファにロードするか (4) '''C-x RET r RET''' で同一コードでファイルを再読み込みしてください。}}

"find-file" や "write-file" などのインタラクティブなコマンドでは Emacs ウィンドウの一番下の行に入力が求められます。この行のことは''ミニバッファ''と呼びます。ミニバッファでは基本的な編集コマンドを使うことができ、多くの *nix シェルで利用できるのと同じようなタブ補完機能があります。'''<TAB>''' を2回連続で押すと補完リストが表示され、マウスを使ってリストから補完候補を選択することも可能です。ミニバッファでの補完はコマンドやファイル名など様々な形で使えます。

ミニバッファには履歴機能も存在します。前に入力したコマンドは '''Up Arrow''' または '''M-p''' を使うことで再呼び出しできます。

ミニバッファは '''C-g''' を押すことでいつでも終了できます。

ファイルを複数開いたら、ファイルを切り替える手段が必要です。Emacs 内に既に存在するバッファにファイルを開くと、Emacs はそのバッファに切り替えます。しかしながらこれは効率的とは言えません。Emacs には表示するバッファを選択する '''C-x b''' が存在します (タブ補完が使えます)。存在しないバッファの名前を入力すると、その名前で新しいバッファが作成されます。

{{Note|前のバッファに切り替えるには '''C-x b <RET>''' を使います。前のバッファがデフォルトだからです。}}

全てのバッファのリストを '''C-x C-b''' で表示することができます。バッファが必要なくなったときは '''C-x k''' で削除することが可能です。

=== 編集 ===

Emacs には多数の編集コマンドが存在します。まだ紹介していない最も重要なコマンドはおそらく 'undo' でしょう。'''C-_''' または '''C-/''' で実行することができます。基本的に移動コマンドには対応する削除コマンドが存在します。例えば '''M-<backspace>''' で後方の単語を削除することができ、{{ic|M-d}} で前方の単語を削除できます。行末または文章の終わりまで削除するにはそれぞれ {{ic|C-k}} または {{ic|M-k}} を使います。

1行は80文字を超えていはいけないという経験則が存在します。1行の長さを長くしすぎないことで、特にウィンドウの縁で改行してしまうような場合に、可読性を維持することができます。改行の自動挿入 (または削除) は Emacs では詰め込み (''filling'') と呼ばれます。{{ic|M-q}} を使うことでパラグラフを折り返させることができます。

文字列と単語はそれぞれ {{ic|C-t}} と {{ic|M-t}} で置き換えることが可能です。例えば {{ic|Hello World!}} を {{ic|World! Hello}} と置き換えられます。

単語の大文字小文字はすぐに修正できます。{{ic|M-l}} は単語を小文字に変換し ({{ic|HELLO}} は {{ic|hello}})、{{ic|M-u}} は単語を大文字に変換します ({{ic|hello}} は {{ic|HELLO}})。そして {{ic|M-c}} は単語の最初の文字を大文字にして他の文字は小文字にします ({{ic|hElLo}} は {{ic|Hello}})。

=== kill と yank とリージョン ===

リージョンとは、2点間にあるテキストです。2点のうちの1つは、''マーク'' と呼ばれ、もう1つはポイントです。 '''C-<SPC>''' によってマークの位置がセットされ、その後でポイントが移動することでリージョンが作られます。GNU Emacs 23.1 以降、リージョンはデフォルトで可視化されます。リージョン上で動作する多くのコマンドがあり、もっともよく使われるコマンドに ''killing'' コマンドがあります。

Emacs では、カット＆ペーストはそれぞれ、''kill'' と ''yank'' と呼ばれます。1文字以上の文字を削除するコマンド（ '''C-k''' や '''M-d''' といった上で記述したコマンドも含めて）は、実際にテキストをカットし、''kill-ring'' として知られるものに追加します。kill-ring は、単に kill されたテキストのリストです。kill-ring は、デフォルトでは直近60個の kill されたテキストを保存します。kill に成功すると、リストの先頭に接続されて保存されます。

'''C-w''' と '''M-w''' によって、それぞれリージョンの kill とコピーができます。

kill されたテキストをバッファに挿入する（'yanking' として知られます）ためには、'''C-y''' を使います。 '''C-y''' は、複数回使用することで、繰り返しテキストを yank できます。前述の通り、以前の kill は、リストに保存されます。しかし、'''C-y''' は、そのうち最初のものしか取得しません。それより前の kill は、'''M-y''' によってアクセスすることができます。これによって、'yank' で挿入されたテキストをリストの先頭に移動させます。 '''M-y''' は '''C-y''' に続けて使われなければならず、kill-ring をたどるために何度でも使えます。

=== 検索と置換 ===

文字列を検索することは、テキストの編集において一般的な作業です。検索は、'''C-s''' (後方検索) または '''C-r''' (前方検索) によって実行されます。これらのコマンドは、検索する文字列を入力するプロンプトを表示します。検索は1文字入力するごとに実行され、タイプごとに次に（あるいは前に）一致した文字列にマッチします。次の検索結果に行くには C-s を、前の検索結果に行くには C-r を押します。もし探しているものが見つかったのであれば、'''<RET>''' を押すことで検索を終了できます。一方、検索を開始した場所に戻りたければ '''C-g ''' を押します。

いったん検索が完了すると (たとえば '''C-g''' 等で中断していない場合)、検索された文字列は、次の検索のデフォルト検索文字となります。検索された文字を使用するには、後方検索なら '''C-s C-s''' , 前方検索なら '''C-r C-r''' をそれぞれ押します。

I-search には、いくつかの有用なコマンドがあります。 '''M-e''' によって、検索文字列の編集が可能です。 '''M-c''' によって、大文字小文字を区別するか、しないかを切り替えることができます。

正規表現検索は、検索の開始コマンド以外、上述の検索と同様に動作します。 '''C-M-s''' あるいは '''C-M-r''' によって、それぞれ正規表現による後方検索、前方検索を開始します。いったん正規表現検索を開始すると、文字列検索と同様に '''C-s''' と '''C-r''' を後方検索、前方検索に使用することができます。

検索に加え、文字列や正規表現を置換することができます（それぞれ '''M-%''' および '''C-M-%''' によって実行されます）。元のテキストと変換後のテキスト用にプロンプトが表示され、それからハイライトされた一致箇所に対する動作のために別のプロンプトが表示されます。多くのオプションが使用できますが（使用できるオプションの完全なリストは '''?''' を押してください）、もっとも一般的に使われるのは、変換を実行する '''y''' と、スキップする '''n''' 、そしてハイライトされている文字列を含め、以降すべての一致に対して変換する '''!''' になります。

=== 前置引数 ===

'''C-u''' は、'universal-argument' コマンドに対応づけられています。'universal-argument' を渡すことによって、より多くの情報をコマンドに提供できます（この情報を '前置引数' と呼びます）。たとえば

C-u 80 %

は、%記号の行を挿入します。また、

C-u 4 M-d

は4単語を削除します。この場合、'''M-d''' によって実行されるコマンドへ、要求する単語の数を渡しています。

universal argument は、'''M-<数字>''' によって少し早く入力することができます。

M-80 %

=== インデント ===

インデントは、1行をインデントする '''<TAB>''' やリージョンをインデントする '''C-M-\''' によって実行されます。リージョンが有効（''たとえば''ハイライトされている）場合、'''<TAB>''' はリージョンもインデントします。

テキストがどのようにインデントされるかは、正確には有効になっている ''メジャーモード'' に依ります。メジャーモードは、しばしば特定の種類のテキストをインデントするときに特化したインデントスタイルを定義します。（より詳しくは [[#モード|Modes]] を見てください。）

いくつかの場合、ファイルタイプに対して適したメジャーモードがありません。その場合、手動でのインデントが必要になります。リージョンを作成（ [[#kill と yank とリージョン|kill と yank とリージョン]] 参照）し、'''C-u <n> C-x <TAB>''' でインデントを実行してください。（ここで、'<n>' はリージョンに含まれるテキストがインデントされる列の数です。）例えば、

リージョンのインデントを4列追加する:

C-u 4 C-x <TAB>

リージョンのインデントを2列減らす:

C-u -2 C-x <TAB>

=== ウィンドウとフレーム ===

Emacs は、多くのファイルを同時に編集するために便利であるよう設計されています。これは、Emacs のインタフェースを3つの階層にわけることで実現されています。つまり、すでに紹介済みのバッファ、''ウィンドウ'' と ''フレーム'' です。

'''ウィンドウ''' とは、Emacsでバッファを表示している場所のことです。1つのウィンドウは、一度に1つのバッファしか表示できません。しかし、1つのバッファは複数のウィンドウに表示できます。それぞれのウィンドウの下には、''モードライン'' があります。モードラインには、そのバッファの情報が表示されています。

'''フレーム''' とは、Emacs の"ウィンドウ"（一般的な意味。たとえば最近のデスクトップパラダイムの意味での 'ウィンドウ'）です。フレームには、タイトルバー、メニューバー、1つ以上の 'ウィンドウ' (Emacs 的な意味。たとえば上で定義した 'ウィンドウ') が含まれます。

以降では、これらの単語は Emacs に存在するものでの定義として使用します。

ウィンドウを水平あるいは垂直に分割するには、それぞれ '''C-x 2''' あるいは '''C-x 3''' を使います。これは、現在のフレームにもう1つのウィンドウを生成する効果があります。複数のウィンドウ間を巡回するには、'''C-x o''' を使用します。

ウィンドウ分割の反対は、ウィンドウを削除することです。現在のウィンドウを削除するには '''C-x 0''' を使い、現在のウィンドウ以外を削除するには '''C-x 1''' を使います。

ウィンドウと同様に、フレームも生成や削除が可能です。 '''C-x 5 2''' によってフレームを生成できます。 '''C-x 5 0''' によって現在のフレームを削除し、'''C-x 5 1''' によってr現在のフレーム以外のすべてのフレームを削除します。

{{Note|これらのコマンドはバッファには影響しません。たとえば、ウィンドウを削除しても表示されているバッファは kill されません。}}

=== モード ===

Emacs モードは Emacs Lisp で書かれた拡張であり、接続されているバッファの挙動を制御します。大抵の場合、インデントやシンタックスハイライト、テキストを編集するときのキーバインドを提供します。洗練されたモードは Emacs を完全な IDE (統合開発環境) に変貌させます。Emacs は基本的にファイルの拡張子でモードをロードすべきか判断します。

シェルスクリプトを編集するのに役立つモードとして sh-mode, line-number-mode, column-number-mode が存在します。同時に使用することができ、以下のコマンドで呼び出します:

'''M-x sh-mode <RET>'''

'''M-x column-number-mode <RET>'''

line-number-mode はデフォルトで有効になっていますが、コマンドを再度実行することでオンとオフを切り替えられます:

'''M-x line-number-mode <RET>'''

sh-mode は、''メジャーモード'' の1つです。メジャーモードは Emacs を調整し、時には、特定の種類のテキストの編集用に特別なコマンドを提供します。それぞれのバッファでは、メジャーモードは1つだけが有効です。シンタックスハイライトやインデントサポートに加えて、sh-mode はシェルスクリプトを書く助けになるいくつかのコマンドを定義しています。以下に、それらの内のいくつかを示します。

'''C-c (''' 関数定義を挿入する

'''C-c C-f''' 'for' ループを挿入する

'''C-c TAB''' 'if' 文を挿入する

'''C-c C-w''' 'while' ループを挿入する

'''C-c C-l''' 1 から n までの番号付きループを挿入する

'line-number-mode' と 'column-number-mode' は''マイナーモード''です。マイナーモードはメジャーモードを拡張することができ、同時に任意の数のマイナーモードを有効にできます。

=== マニュアル ===

Emacs を本当にマスターしたいのであれば、一番よく読むべき文章はやはり公式マニュアルです:
* Emacs: 完全な Emacs ユーザーマニュアル
* Emacs FAQ
* Emacs Lisp Intro: プログラミング言語を使用したことがない場合
* Elisp: プログラミング言語をよく知っている場合

これらは、 [http://www.gnu.org/software/emacs/manual/ GNU.org] から PDF として入手できます。あるいは Emacs 自身にて組み込みの 'info' リーダー '''C-h i''' を用いて直接読むこともできます。本を選択するには '''m''' を押してください。

ユーザーの幾人かは、'info' で読むことを好みます。便利なショートカットであり、段落はウィンドウ幅に調整され、フォントは現在の画面解像度に調整されるためです。何人かは目に優しいと気づいています。最後に、本の内容を任意の Emacs バッファへ簡単にコピーでき、さらに例示されている Lisp コードを直接実行することさえできます。

'''info''' 本について、もっとよく知りたいなら、'''C-h i m info <RET>''' を実行してください。
info モードで '''?''' を押すと、ショートカットの簡易リストが表示されます。

== カスタマイズ ==

Emacs は {{ic|~/.emacs}} を編集するか '''M-x customize''' を使うことで設定をすることができます。このセクションでは手動で {{ic|~/.emacs}} を編集する方に焦点をあて、いくつかのカスタマイズ例を示すことで、一般的な Emacs の設定をデモンストレーションします。customize コマンドは調整を行うためのシンプルなインターフェイスを提供しますが、おそらく Emacs に慣れてくるにつれて制約を感じるようになるでしょう。

ここでの例は、すべて Emacs が動作している間に動作します。Emacs 内で式を評価するには、以下を使います。

'''C-M-x''' ポイントがある式を評価する

あるいは、

'''C-x C-e''' ポイントの直前の ')' を最後のカッコとする式を評価する

何人かのユーザーは、プロンプトで 'yes' や 'no' をタイプすると、すぐに疲れます。その代わりに 'y' や 'n' を使うために:

(defalias 'yes-or-no-p 'y-or-n-p)

カーソルの点滅を止めるには、次を使用:

(blink-cursor-mode -1)

同じく、前のセクションにある column-number-mode を有効にするには:

(column-number-mode 1)

前の2つのコマンドに類似性があるのは偶然ではありません。blink-cursor-mode と column-number-mode は、共にマイナーモードです。ルールとして、マイナーモードは正の数を引数にとると有効になり、負の数で無効になります。引数が省略された時、マイナーモードは on/off を切り替えます。

マイナーモードのその他いくつかの例を示します。以下はそれぞれ、スクロールバー、メニューバー、ツールバーを無効にします。

(scroll-bar-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)

変数 'auto-mode-alist' によって、特定のファイル名に対してデフォルトで使われるメジャーモードを変更することができます。以下の例では、'.tut' および '.req' ファイルのデフォルトのメジャーモードを 'text-mode' にします。

(setq auto-mode-alist
(append
'(("\\.tut$" . text-mode)
("\\.req$" . text-mode))
auto-mode-alist))

設定は、基底となるモードごとに適用することもできます。基本的な方法は、''hook'' に関数を追加することです。例えば、text-mode でだけインデントをタブの代わりに強制的にスペースを使用するためには:

(add-hook 'text-mode-hook (lambda () (setq indent-tabs-mode nil)))

同様に、場所によらずインデントにてスペースを使用するには:

(setq-default indent-tabs-mode nil)

キーバインドは、2つの方法で調整できます。1つ目の方法は 'define-key' です。'define-key' は、コマンドに対するキーバインドを作成できますが、1つのモードに対してだけ作成します。以下の例では、'''F8''' に、'text-mode' バッファでは行末のホワイトスペースを除去するよう割り当てます。

(define-key text-mode-map (kbd "<f8>") 'delete-trailing-whitespace)

もう1つの方法は、'global-set-key' です。これによって、場所によらずキーにコマンドを割り当てることができます。'query-replace-regexp' ('''C-M-%''') を '<f7>' に割り当てるには:

(global-set-key (kbd "<f7>") 'query-replace-regexp)

他のキーにコマンドを割り当てることは、既存の割当を入れ替えるわけではありません。たとえば、上記例の後、'query-replace-regexp' は、'''F7''' と '''C-M-%''' の両方に割り当てられます。

Emacs のほとんどすべてがカスタマイズできます。[http://emacswiki.org/ Emacs Wiki] を通して見ることが基礎固めに適しています。

=== マルチ設定 ===

複数の設定を使い、Emacs にどれか一つをロードさせることができます。

例えば、2つの設定ファイルを定義してみましょう。

{{hc|.emacs|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/plugins" nil t)
(load "~/.emacs.d/theme" nil t)
}}

これによって、デーモンとしての起動用にフルカスタムをロードします。しかし、''plugins'' ファイルは巨大で、ロードが遅いです。''plugins'' 機能が不要な新しい Emacs インスタンスを生成したい場合、''plugins'' を毎回ロードすることは面倒です。

{{hc|.emacs-light|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/theme" nil t)
}}

Emacs を以下のコマンドで起動します。
emacs -q -l ~/.emacs-light
これによって、エイリアスを生成して、呼び出しを簡単にすることができます。

=== ローカル・カスタム変数 ===

設定ファイル内で変数を定義することができます。この変数はファイル内でローカルに変更することができます。

(defcustom my-compiler "gcc" "Some documentation")

どんなファイルでもローカル変数を定義するには2つの方法があります。[https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html 完全な詳細のマニュアル ] を参照してください

* {{ic| M-x add-file-local-variable-prop-line}} は、ファイルの先頭に以下のようなコメント行を追加します。
// -*- my-compiler:g++; mode:c++ -*-
* {{ic| M-x add-file-local-variable}} は、ファイルの末尾付近に行を追加します。
// Local Variables:
// my-compiler: g++
// mode: c++
// End:

変数の効果を得るためには、{{ic|M-x revert-buffer}} を実行する必要あることに注意してください。

カスタム変数は、デフォルトでは安全でないと考えられています。もしカスタム変数によって再定義されたローカル変数を含むファイルを開こうとすると、Emacs は確認するよう通知します。

変数を安全であるとして宣言することもできます。これによって確認のためのプロンプトを除去することができます。新しい変数が安全と考えられるためには検証されなければならない、と述語を指定する必要があります。

(defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

この例では、文字列以外の何かにセットしようとすると、Emacs は安全でないと考えます。

=== カスタムカラーとテーマ ===

''face'' を使うことで簡単に色をカスタマイズすることができます:
(set-face-background 'region "color-17")
(set-face-foreground 'region "white")
(set-face-bold-p 'font-lock-builtin-face t )

ポイントがある場所の face の名前を Emacs に表示させることができます。そのためには ''customize-face'' を使います。どのように色、太字、下線、等が設定されているかを示すことができます。

コンソール上の Emacs は、256色を扱うことができます。しかし、それには適したターミナルを使わなければなりません。たとえば URxvt は256色をサポートしています。''list-colors-display'' によって、サポートされる色の包括的なリストが表示できます。これは強くターミナルに依存します。

=== SyncTeX サポート ===

Emacs は強力な LaTeX エディタです。LaTeX モードを必要に応じて自由に編集・作成することができます。

SyncTeX サポートといった、まだいくつかの挑戦があります。最初に TeX ディストリビューションに SyncTeX があるかを確認する必要があります。もし TeX Live を手動でインストールした場合、''synctex'' パッケージをインストールする必要があるかもしれません。
# umask 022 && tlmgr install synctex

SyncTeX サポートは、ビューア依存です。ここでは例として Zathura を使用します。他の PDF ビューアを使用する場合、コードを変更する必要があります。

(defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
"TeX 文書用 PDF ビューア。
同じドキュメントを2回起動したこと検出する、または Emacs を
閉じても表示を継続するためにビューアを fork したい場合、

シンプルなコマンド:

zathura --fork

SyncTex を用いて pdf を逆検索するために以下が使用できる。

emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

引用符および二重引用符は必須で、適切にエスケープされなければならない点に注意。"
:safe 'stringp)

カスタム変数を定義します。もし AucTeX や Emacs 標準の LaTeX-mode を使用しているなら、それに応じてビューアを設定する必要があります。

LaTeX ソースファイルを Emacs で開き、文書をコンパイルし、ビューアを起動します。Zathura が起動します。{{ic|Ctrl+Left click}} を押すと、Emacs は対応する位置にポイントを移動させます。

=== Systemd ファイルのシンタックスハイライト ===

[https://github.com/holomorph/systemd-mode systemd-mode] を使うことができます。

もしくは init ファイルに以下を追加することで、簡単に emacs で systemd のファイル (サービスやタイマーなど) をカラー表示できます:

(add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

=== emacs-nox のクリップボードサポート ===

emacs-nox で [[Xorg]] クリップボードを使うには、{{Pkg|xclip}} を[[インストール]]して以下の関数を {{ic|~/.emacs}} に追加してください [https://lists.gnu.org/archive/html/help-gnu-emacs/2014-08/msg00189.html]:

{{bc|1=
;; use xclip to copy/paste in emacs-nox
(unless window-system
(when (getenv "DISPLAY")
(defun xclip-cut-function (text &optional push)
(with-temp-buffer
(insert text)
(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
(defun xclip-paste-function()
(let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
(unless (string= (car kill-ring) xclip-output)
xclip-output )))
(setq interprogram-cut-function 'xclip-cut-function)
(setq interprogram-paste-function 'xclip-paste-function)
))
}}

{{Tip|以下を追加することでターミナルマウスサポートも有効にできます:
{{bc|1=
;; xterm mouse support
(require 'mouse)
(xterm-mouse-mode t)
}}
[http://www.opensource.apple.com/source/emacs/emacs-51/emacs/lisp/mwheel.el mwheel.el] を参照。}}

== ヒントとテクニック ==

前のセクションでは基本的な編集コマンドを説明していますが、それだけでは Emacs の可能性はわかりません。このセクションではより高度なテクニックや機能を紹介します。

ただし全てを説明するとなると長くなりすぎます。そのためこのセクションはあくまで Emacs の雅やかな機能をいくつか''デモ''するだけにとどめます。

全ての機能の詳細な説明は[[#ドキュメント|ドキュメント]]を見て下さい。

=== TRAMP ===

TRAMP (Transparent Remote Access, Multiple Protocols) は多数のプロトコルで、リモートファイルに透過的にアクセスすることができる拡張です。ファイル名を入力するときに、特定の形式を入力すると TRAMP が呼びだされます。例:

{{ic|/etc/hosts}} を root 権限で開く前に root のパスワードを要求するには:

C-x C-f /sudo::/etc/hosts

SSH で 'myhost' に 'myuser' として接続して {{ic|~/example.txt}} ファイルを開くには:

C-x C-f /ssh:myuser@myhost:~/example.txt

TRAMP のパスは '/[protocol]:[[user@]host]:<file>' という形式で指定します。TRAMP がサポートしているのは上記の例に限りません。詳しくは TRAMP の info マニュアルを参照してください。マニュアルは Emacs に付属しています。

=== キーボードマクロとレジスタ ===

このセクションでは、2, 3の強力な編集機能に対する実用的なデモンストレーションを示します。つまり、''keyboard macros'' と ''registers'' です。

目的は、一連の文字のリストとこのリスト内での対応する位置を作ることです。それらは手動で成形することもできますが、遅く、間違いをおこしやすいです。その代わりに、Emacs のよりパワフルないくつかの編集機能によって、レバレッジを効かせられます。答えの前に、以下で使うテクニックの背景について詳細を示します。

1つ目の機能は ''レジスタ'' です。レジスタは、数字からウィンドウコンフィグまでに及ぶ様々なデータ型を格納し取得するために使われます。それぞれのレジスタには、1文字の名前が与えられます。この文字はレジスタへのアクセスに使われます。

もう1つの機能は、''キーボードマクロ'' です。キーボードマクロは、一連のコマンドを格納します。それによって後で簡単に繰り返すことができます。これらの変化を、ここでステップバイステップで実施してみます。

文字集合を含むバッファから始めます。
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

'number-to-register' コマンド（'''C-x r n'''）を呼び出してレジスタを準備します。それから数字 '0' をレジスタ 'k' に保存します。

C-x r n k

バッファの先頭にポイントを移動させ、キーボードマクロ（'''C-x ('''）を実行開始し、文字のフォーマットを始めます。

C-x ( C-f M-4 .

レジスタ 'k' に挿入 ('''C-x r i''') とインクリメント ('''C-x r +''') を行います。前置引数 ('''C-u''') によって、テキストを挿入した後でポイント位置を離します。

C-u C-x r i k C-x r + k

改行を入れることでフォーマットを完了させます。残りの文字に対しては、Emacs はキーボードマクロを定義したポイント位置から始まるこのプロセスを繰り返すことができます。'''C-x e''' はキーボードマクロを完了して呼び出します。前置引数 '''M-0''' によって、エラーが起きるまでマクロを繰り返します。この場合、バッファの最後に到着すると中断します。

<RET> M-0 C-x e

結果は以下のようになります:

A....0
B....1
C....2
[...]
x....49
y....50
z....51

もし、後々使うためにマクロを保存したいなら、名前をつけて設定ファイルに保存する必要があります。
name-last-kbd-macro
insert-kbd-macro

定義したマクロは、すべてマクロリングに格納されます。マクロを巡回するには、
'''C-x C-k C-n''' 次のマクロ
'''C-x C-k C-p''' 前のマクロ

同様に、仮想的に何でも保存するためにレジスタを使えます。

'''C-x r SPC''' 現在のポイント（位置）をレジスタにコピーする
'''C-x r w''' 現在のウィンドウ設定をレジスタにコピーする
'''C-x r j''' レジスタに再保存する。

しばしば異なるプロジェクトごとにウィンドウを行ったり来たりして作業をするなら、別のプロジェクトのために設定を保存し、ある画角から別の画角へ簡単に切り替えることができます。

'''list-registers''' コマンドによって、使用したレジスタをリストにして表示することができます。

=== 正規表現 ===

Emacs Manual より: "正規表現 (''regexp'' と略す) とは、一致する可能性がある一連の (無限個でもよい) 文字列を表現するパターンである"。このセクションでは正規表現自体には深くは立ち入りません (単純に説明しきれない)。そのかわり正規表現のパワーを簡単にデモンストレーションします。詳しい説明は Emacs Manual の [https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html#Regular-Expressions Regular Expressions] セクションを見て下さい。

上と同じシナリオが与えられた場合、つまり複数文字のリストがあり、そのリスト内に複数文字の相対位置を持つリストを考えます。(参照 [[#キーボードマクロとレジスタ|キーボードマクロとレジスタ]]) 再度、以下を含むバッファから開始します。

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

バッファの最初に '''C-M-%''' を使用します。（もしキー列が実行するには難しいなら、'''M-x query-replace-regexp''' を使う方がより快適かもしれません。）プロンプトには以下を入力します：
$.$
これは、単に1文字にマッチします。それから置換先のプロンプトには：
\1....\#^J
{{Note|'^J' は、改行を配置することを意味します。改行は、プロンプト内で入力できません。改行記号は、その他に '''C-q C-j''' を使って入力することもできます。}}
置換先の表現は、以下のように読みます： "最初のカッコに囲まれた部分にマッチするテキストを挿入しなさい (今回は1文字)。次にピリオドを4文字挿入し、それから自動的にインクリメントされた数を挿入し、改行が続きます。"

最後に、'''!''' を押すことで、バッファ全体に渡って適用します。前のセクションで実行したすべてのフォーマットが、1つの正規表現置換で実行できます。

=== 矩形選択 ===

先進的なテキストエディタが当然備えているべき強力な機能として、テキストを矩形で選択・編集できるというのがあるでしょう。

Emacs でも矩形選択は可能です。'''C-SPC''' で普通にテキストを選択してから、複数の矩形コマンドを使うことができます。

'''C-x r t''' 矩形領域にテキストを挿入する
'''C-x r k''' 矩形領域を kill する (kill-ring に保存する)
'''C-x r y''' 矩形領域を Yank する
'''C-x r o''' 矩形領域にスペースを挿入する

たとえ矩形の外のテキストがハイライトされていても、上記のコマンドが影響を与えることはありません。

=== ブックマーク ===

Emacs は開いたファイルのリストを保存できます。

'''C-x r m''' カレントバッファをブックマークに追加。
'''C-x r b''' ブックマークからバッファを開く。
'''C-x r l''' ブックマークの確認。

=== Elisp インタプリタ ===

'''eval-last-sexp''' ('''C-x C-e''') を使うことで、elisp 式を評価することができます。Emacs は、開始時に常に '''*scratch*''' バッファを生成します。*scratch* バッファはディスクに保存されず、自由にテキストやコードを記述することができます。これは特にelispの評価に有用です。このバッファは、デフォルトで '''lisp-interaction-mode''' 有効で開始することに注意してください。

その他に、Emacs は、'''ielm''' コマンドでトップレベルの elisp インタプリタを提供します。

=== スマートなウィンドウ切り替え ===

長い間使っていると '''C-x o''' による伝統的なウィンドウ切り替えは面倒かもしれません。'''windmove''' コマンドはもっと便利にウィンドウを切り替えることができます。{{ic|Shift}} を押しながら方向キーでウィンドウを指定するだけです。

windmove キーを有効にするには、設定ファイルに以下を記述してください:

{{hc|~/.emacs|
(when (fboundp 'windmove-default-keybindings)
(windmove-default-keybindings))
}}

=== シェルコマンドの実行 ===

'''M-!''' を使うことで、外部コマンドを呼び出すことができます。前置引数を使用する（'''C-u M-!'''）ことで、結果を現在のバッファのポイント位置に出力することができます。

リージョン上で '''M-|''' を使うことで、リージョンをコマンドの入力として使うことができます。たとえば、

'''C-u M-| sort -u RET'''

によって、リージョンがソートされ、重複を除去して、リージョンをその結果で置き換えることができます。

=== シェルバッファ ===

シェルバッファを生成することで、ターミナルと同様にコマンドを実行することができます。
昔ながらのシェルバッファは、'''shell''' コマンドによって生成することができます。

Emacs は、すべて Emacs Lisp で書かれた非常に強力なシェル '''eshell''' を機能として持っています。csh や zshといったシェルに対する主な優位点は、ネイティブなシェル言語が elisp そのものである点です。そのため、シェル関数として elisp のすべての先進的な機能を使用できます。

=== 対応する括弧のハイライト ===

'''show-paren''' モードを使うことができます。デフォルトでは、対応する括弧が表示されるまで少し遅延がありますが、'''show-paren-delay''' を 0 に設定することでなくすことができます。

{{hc|~/.emacs|
(setq show-paren-delay 0)
(show-paren-mode 1)
}}

=== スペルチェック ===

辞書を選択するには:
'''M-x ispell-change-dictionary'''

一単語をチェックするには '''M-$''' を使います。
バッファ全体をチェックするには、
'''M-x ispell-buffer'''

'''flyspell-mode''' を有効にすることで、入力と同時に (on-the-fly) スペルチェックができます。ソースコードに対しては、代わりに '''flyspell-prog-mode''' を使うことで、コメントに限定して有効にできます。Emacs でスペルチェックをするには ''aspell'' パッケージも必要になります。それぞれの言語に対応したパッケージがあります。英語に対しては、（''aspell'' と共に）''aspell-en'' が必要になります。

=== テーブル ===

Emacs は、様々な言語での一般的なテーブルを扱う居力な機能を備えています。例を見てみましょう。

Fruits Quantity
Apples 5
Melons 2

この内容をリージョンで選択して、以下を実行します。
table-capture

半角スペース2文字を列の区切りとして、改行 ('''C-q C-j''') を行の区切りとして使用します。
以下の結果を得ます。

+------+--------+
|Fruits|Quantity|
+------+--------+
|Apples|5 |
+------+--------+
|Melons|2 |
+------+--------+

以下の操作で元に戻せます。
table-release
''table-insert-row'', ''table-span-cell'', ''table-widen-cell''　といったような、たくさんの便利な ''table-*'' 関数があります。

最後に、''table'' 関数の究極の目的は、指定されたマークアップ言語に変換することです。
それには、''table-generate-source'' が使われます。
LaTeX に対しては、前のテーブルは、以下の結果となります。

% This LaTeX table template is generated by emacs 24.2.1
\begin{tabular}{|l|l|}
\hline
Fruits & Quantity \\
\hline
Apples & 5 \\
\hline
Melons & 2 \\
\hline
\end{tabular}

table mode を使用することで、行ごとおよび列ごとの和といった、スプレッドシートの作業を行うこともできます。しかし、すぐに機能が限定的であると分かるでしょう。その上、非常に遅いです。より多くの強力な可能性については、[[#予定表、スプレッドシート、文章作成|org-mode]] を見てください。

=== 予定表、スプレッドシート、文章作成 ===

有名でパワフルな [http://orgmode.org/ Org mode] のおかげで、Emacs はパワフルなオフィス系機能をおすすめできます。このモードは、標準の Emacs ディストリビューションに含まれます。

Org mode は元々強力な TODO およびアジェンダのエージェントですが、すぐにはるかに幅広い機能セットに進化しました。
Org mode は単純に機能が多すぎて、すべての機能をざっと見ることすらできません。そのため、私たちはいくつかの例であなたの欲求を刺激するに留めます。

TODO.org ファイルを新規ファイルとして開きます。Org mode がロードされるはずです。もしロードされなければ、'''M-x org-mode''' によって有効にできます。
{{hc|TODO.org|
* First entry
** Subentry
Some comments
*** Subsubentry
* Second entry
- List item 1
- List item 2
}}

ここで、いくつかの有用なキーバインドは以下となります：
* '''TAB''' 現在のエントリーの折りたたみ・展開を切り替えます。
* '''S-TAB''' すべてのエントリーの折りたたみ・展開を切り替えます。
* '''M-RET''' 現在の項目と同じレベルに新しい項目を開始します。
* '''M-<left>''' および '''M-<right>''' レベルを変更します。
* '''M-<up>''' およｂ '''M-<down>''' すべてのサブセクションを含めて項目を移動します。
* '''S-<left>''' および '''S-<right>''' ステータスを変化させます。リストアイテムでは、項目のスタイルを変更します。
* '''S-<up>''' および '''S-<down>''' 優先度を変更します。
* '''C-c ^''' 現在のエントリーのすべてのサブエントリーをソートします。
* '''C-c .''' 現在のエントリーにタイムスタンプを追加します。{{ic|Shift}} と矢印を使って、数日や数週をスキップできます。カレンダーでマウスを使ったり、特定の日で {{ic|Enter}} を押したりして、それらを選択できます。

スプレッドシート機能は、非常に包括的です。マニュアルから抜粋してみましょう：

{{bc|<nowiki>

最後に、素晴らしい `calc.el 'パッケージでできることについて欲求を
刺激するために、いくつかの関数に対する位置 `x' で次数 `n'のテイラー級数を
計算する表を示します。

|---+-------------+---+-----+--------------------------------------|
| | 関数 | n | x | 結果 |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x) | 1 | x | 1 + x |
| # | exp(x) | 2 | x | 1 + x + x^2 / 2 |
| # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 |
| * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3
</nowiki>}}
Org mode は、行においてパイプ '''|''' がホワイトスペース以外の最初の文字のとき、テーブルと認識します。前のテキストでは、線を描きませんでした。セル内の内容、または '''|-''' のあとに '''TAB''' が押されたとき、線が自動的に描かれています。結果列も手動では記述しておらず、最後の行の calc 式から計算されています。'''C-u C-c C-c''' を使うことで、テーブル内のすべての値を再計算することができます。

TODO ファイルと同様に、行と列を操作するキーバインディングがあります。{{ic|Alt}} + 矢印キーで、列と行を移動することができます。

より深く詳細を知るには、公式マニュアルを参照してください: '''C-h i m Org mode RET'''。

=== リファクタリングとスマート補完 ===

(Eclipse などの) IDE が大抵備えているプログラミング機能が必要な場合、[http://cedet.sourceforge.net/semantic.shtml Semantic] ツールが役に立ちます。Semantic は Emacs の標準ディストリビューションに含まれています。現在 C, C++, Scheme, Javascript, Java, HTML, Make がサポートされています。現在のサポート状況は [http://cedet.sourceforge.net/languagesupport.shtml CEDET のページ] で確認できます。

Semantic がサポートする好みのプログラミング言語で書かれたファイルを開きます。そして Semantic マイナーモードを起動します。
M-x semantic-mode

Semantic は、あなたのファイルに含まれるライブラリ (たとえば C では、ほとんどの場合、標準ライブラリ) を2,3秒パースします。

==== 機能 ====

一旦完了すると、素晴らしい Semantic の機能が使えます。
;スマート補完
'''C-c , SPC''' を押すことで、ポイントにあるシンボルを補完することができます。それが引数の場合、型が正しいかチェックされます。

;シンボルにジャンプする
'''C-c , j''' を押すことでシンボルを入力するプロンプトを表示し、その定義元にジャンプします。'''TAB''' で自動補完ができます。文字 '''J''' を押すと、シンボルを複数ファイルに渡って探索します。

;シンボルの呼び出しをリスト表示する
'''C-c , g''' を押すことでシンボルを入力するプロンプトを表示し、参照されている場所のリストを表示します。'''n''' と '''p''' を押すことで結果表示を巡回できます。'''RET''' を押すことで詳細をトグルし、参照箇所で再度 '''RET''' を押すことで参照元にジャンプします。'''G''' を押すことで、入力したシンボルの場所を複数ファイルに対してリスト表示します。

;リファクタリング
最初に前述のコマンドでリファクタリングしたいシンボルの使用先をリスト化します。'''(''' を押すと、シンボルに対するマクロ定義を開始します。これは実際、リファクタリングに比べてより非常に強力です。なぜなら、シンボルに任意の関数を適用したり、周囲のシンボルに作用することさえしたりできます。'''C-x )''' を押すことで、マクロ定義を終了し、'''E''' キーにて実行します。

;シンボルの説明
以下の関数を呼び出すことで、シンボルの詳細を表示します。
semantic-ia-show-summary
これは複雑なデータ構造とプロトタイプに対して非常に有用です。デフォルトではキーバインドがありません。

==== 設定 ====

以下に、サポートされているすべてのプログラミング言語で Semantic を使用するためのサンプル設定を示します。キーバインディングのと表示設定の例です。

;; ghost 表示での Semantic (M-n と M-p で完了をブラウズできます)
(semantic-mode 1)
(define-key my-keys-minor-mode-map (kbd "C-c , d") 'semantic-ia-show-summary)
(setq semantic-complete-inline-analyzer-displayor-class 'semantic-displayor-ghost)

特定の言語に対して特化した設定を追加することもできます。ここでは C のために：
(add-hook
'c-mode-hook
(lambda ()
(local-set-key (kbd "M-TAB") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)))

==== 文献 ====

Emacs から直接 info マニュアルにアクセスすることが可能です: '''C-h i m Semantic RET'''。

=== Emacs を git のマージツールとして使う ===

デフォルトでは、git はマージツールとして Emacs の Emerge モードをサポートしています。しかしながら、Ediff モードの方をより好むかもしれません。不幸にも、このモードは技術的な理由により git によってサポートされていません。Ediff モードを使用する方法はまだあります。emacs call 上で以下の elisp コードを評価します。

{{hc|.gitconfig|<nowiki>
[mergetool.ediff]
cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

[merge]
tool = ediff
</nowiki>}}

コマンドは1行で書かれなければならない点に注意してください。
上の例では、Emacs を新たに起動します。より早く起動するために emacsclient を使いたいかもしれませんが、推奨されていません。なぜなら Ediff 呼び出しは実際にはクリーンではないためで、現在の Emacs セッションを混乱させる可能性があります。

'''-q''' オプションを使用して、即席で起動することができます。設定の一部を残したまま Emacs を素早く起動するには、Emacs を以下のように呼び出します。
emacs -q -l ~/.emacs-light
ここで、Ediff のために必要なことのみを記した軽量な設定ファイルがロードされます。

このトリックおよび Ediff の問題点についての詳細は、[http://kerneltrap.org/mailarchive/git/2007/7/1/250424 kerneltrap.org] および [https://stackoverflow.com/questions/1817370/using-ediff-as-git-mergetool stackoverflow] を参照してください。

=== Caps Lock キーを Control キーとして使う ===
いわゆる 'emacs 小指' にならないようにこちらの挙動を好むユーザーもいます。X で試用してみたいときは、次を実行:
$ setxkbmap -option 'ctrl:nocaps'

また、キーを'''交換'''するには、次を実行:
$ setxkbmap -option 'ctrl:swapcaps'

永続的に設定したくなったら、{{ic|.xinitrc}} ファイルに上のコマンドを追加してください。

リージョンを小文字から大文字にする必要がある場合は、デフォルトの {{ic|C-x C-u}} キーバインディングを使って下さい、{{ic|upcase-region}} 関数が呼び出されます。

Caps Lock がない場合は、両方の "Shift" にマッピングしてください:
$ setxkbmap -option "shift:both_capslock"

一部のデスクトップ環境にはキーボードのマッピングを変更するためのグラフィカルなツールが含まれています。例えば [[Plasma|Plasma 5]] ならシステム設定を開いて入力デバイスをクリックしてください。キーボードを選択して高度な設定タブから Caps Lock を Ctrl として使用するように設定できます。

== パッケージ ==

Emacs の機能はサードパーティ製のパッケージで拡張できます。公式にサポートされているパッケージマネージャとして {{ic|package.el}} が組み込まれていますが、Emacs のコミュニティメンバーによって書かれたパッケージマネージャが他にも存在します。{{ic|package.el}} は {{ic|package-archives}} 変数を使ってパッケージを検索します。デフォルトでは [https://elpa.gnu.org/ Emacs Lisp Package Archive (ELPA)] が含まれています。{{ic|M-x list-packages}} で Emacs が認識している全てのパッケージが列挙されたバッファが作成されます。マニュアル ({{ic|[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html (info "(emacs) Packages")]}}) にはさらに詳しい情報が載っています。

サードパーティ製のパッケージのアーカイブを追加することもできます。[https://melpa.org/ MELPA] が広く使われています。

人気の拡張の多くは {{ic|[community]}} リポジトリのパッケージや [[AUR]] からインストールできます。大抵の場合、パッケージの名前の前に 'emacs-' が付きますが (例: {{Pkg|emacs-lua-mode}})、常にそうなっているわけではありません (例: {{AUR|auctex}})。

{{Tip|Arch Linux の Wiki を編集している場合は [[Emacs Mediawiki]] パッケージが役に立ちます。}}

パッケージによっては設定ファイルに変更を加えないと機能が有効にならない場合があります。例えば、{{AUR|auctex}} をインストールしたときは、設定ファイルに以下を追加:

{{bc|
(load "auctex.el" nil t t)
(load "preview-latex.el" nil t t)}}

パッケージのソースコードや README で有効化する方法が書かれているはずです。

== トラブルシューティング ==

=== Emacs が 'Undefined color: "WINDOW_FOREGROUND"' というエラーメッセージで起動しない ===

{{Pkg|mcpp}} パッケージまたは {{Pkg|gcc}} パッケージをインストールする必要があります。''xrdb'' は [[X resources]] を前処理するために C のプリプロセッサ ''cpp'' を使用します。C のプリプロセッサがインストールされていない場合、''xrdb'' は C のプリプロセッサを実行しないため WINDOW_FOREGROUND が16進数のカラーコードに展開されません。

=== カラー出力の問題 ===

デフォルトでは、Emacs シェルはカラー表示に使われるエスケープシーケンスをそのまま表示してしまいます。つまり、カラー出力がされるべきところに変な記号が表示されます。

この問題を解決するには以下を {{ic|~/.emacs}} に記述してください:
(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

=== X ウィンドウでの文字の表示問題 ===

X ウィンドウで emacs を起動した時にメインウィンドウの文字が全て黒縁の白四角になってしまう場合 (対応するフォントがインストールされていない文字を表示したときと同じような記号)、{{Pkg|xorg-fonts-75dpi}} や {{Pkg|xorg-fonts-100dpi}} をインストールして X ウィンドウを再起動してください。

=== 起動が遅い ===

{{Tip|[[#systemd ユニットとして|systemd ユニットとして]] Emacs を起動する方法でも起動時間を短縮できます。}}

しばしば起動時間が遅くなる原因は2つあります。

どちらが原因なのか調べるために、次のコマンドで Emacs を実行してください:

$ emacs -q

このコマンドでも Emacs の起動が遅い場合、[[#不適切なネットワーク設定|不適切なネットワーク設定]]を参照してください。そうでない場合は、ほぼ確実に .emacs に問題があります。

* {{ic|/etc/hosts}} の設定が間違っていると、Emacs の起動が5秒以上遅くなることになります。詳しくはネットワーク設定ガイドの '[[ネットワーク設定#ホストネームの設定|ホストネームの設定]]' を見てください。

* 原因を探るシンプルな方法は、{{ic|~/.emacs}} (または {{ic|~/.emacs.d/init.el}}) にて予想されるセクションをコメントアウト(例えば行頭に ';' を入力)し、変化するか確認するため Emacs を再度開始することです。"require" と "load" を使用することで、特に大きな拡張機能を使った時、起動が遅くなり得ることを心に留めてください。原則として、これらはターゲットが次のいずれかである場合にのみ使用する必要があります。Emacsが起動時に必要とするか、あるいは拡張機能を自動ロードする場合です。そうでなければ、'autoload' 関数を直接使用できます。たとえば、

(require 'anything)

の代わりに、以下が使えます。

(autoload 'anything "anything" "Select anything" t)

=== Cannot open load file: ... ===

このエラーに共通する主な原因は、'load-path' 変数に拡張機能が置かれているディレクトリのパスが含まれていないことです。解決するには、拡張機能のロードを試みる前に、適切なパスをリストへ追加します:

(add-to-list 'load-path "/path/to/directory/")

拡張機能のためのパッケージを使用しようとして、かつ Emacs が '/usr' 以外のプレフィックスで設定されたとき、ロードパスを更新する必要があります。以下を {{ic|~/.emacs}} のパッケージによって提供される処理の前に配置します:

(add-to-list 'load-path "/usr/share/emacs/site-lisp")

もし手動で Emacs をコンパイルしたら、デフォルトのプレフィックスは '/usr/local' であることを心に留めてください。

=== デッドアクセントキーの問題: '<dead-acute> is undefined' ===

このバグについて Google で検索すると、次のリンクが見つかります:
https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

問題の説明: Emacs の最近のバージョンでは、
アクセントキーを使用する通常の方法は、期待通りに動きません。'fiancé' のような単語をアクセントしようとすると上のメッセージが表示されます。

解決するには、スタートアップファイル {{ic|~/.emacs}} の上部に以下の行を記述します。

(require 'iso-transl)

さらに、これは不具合ではなく、新しい Emacs バージョンの機能です。メーリングリストでの本件に関するメッセージを読むと、以下であることが分かりました (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html):

:''これは何も自動的にロードされないように見えます。なぜなら、iso-transl と iso-acc の間に選択があるからです。両方とも、C-x 8 あるいは ALt-<accent> プレフィックスでインプットメソッドを提供するように見えます。しかし、あなたとわたしがしたことは、アクセントのために、ただデッドキー（^, ´, `, ~, ¨）を押し、それからアクセントされる文字を "統合する" ため別のキーを押しただけです。そしてここでは Alt キーが押されていません！ドキュメントによると、これは8ビットエンコーディングに適しているように見えます。そのため UTF-8 では、かなり役立たないはずです。私は、これが紹介されたときにこの不具合を報告しました。しかし、このバグは機能として分類されたように見えます。。。多分これは、かなり役立たないけど、ただファイルが自動ロードされるためだけです。''

=== C-M-% やその他のバインディングが emacs nox で動作しない ===

これはターミナルが Xorg よりも制限的であることが原因です。ただし、ターミナルによっては多くのバインディングを扱うことができることがあります。2つの解決法が考えられます:
* グラフィカルバージョンを使用する。
* サポートされているバインディングに変更する。

例:
{{hc|.emacs|
(global-set-key (kbd "C-M-y") 'query-replace-regexp)
}}

=== Emacs がフリーズする ===

シングルスレッドであるがゆえに、Emacs は様々な操作でブロックします。フリーズが発生する状況は様々です。例えば、Emacs はあなたからの入力を待っているのかもしれません (例えばあるフレームでミニバッファを開いているのに他のフレームで作業しようとしている場合など)。あるいは、Emacs は完了するまで時間のかかるコードを実行中なのかもしれません。あるいはバグを踏んだという可能性もあります。Emacs プロセスを殺さずに Emacs のブロックを解除する方法は複数存在します。

* {{ic|C-g}} を押してみる。Emacs が行っていることによっては、複数回押す必要があります。
* {{ic|ESC ESC ESC}} を押してみる。
* 他のターミナルで {{ic|killall -SIGUSR2 emacs}} を実行する。

=== Emacs-nox の出力が汚い ===

ターミナル上で動作している時、色、インデント、あるいは出力に関するものが狂ったように見えます。（多分？）Emacs がある点で特別な文字を送り、それが現在のターミナルと競合しているためのようです。
もしこれが起きた時、できることは {{ic|M-x redraw-display}} を実行することです。これにより、ターミナルの表示を再描画します。この問題が頻繁に起きるなら、たとえば
(global-set-key (kbd "<f7>") 'redraw-display)
といった記述を、.emacs ファイルに置くといった方法で、コマンドをキーに割り当てたいと思うかもしれません。

グラフィカルバージョンの Emacs はこの問題が起きません。

=== emacs ターミナルにおかしなエスケープ数字 (utf-8) が表示される ===

{{ic|.bashrc}} または {{ic|.zshrc}} で以下の変数をエクスポートしてください:

{{hc|1=~/.bashrc|2=
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export TERM=xterm-256color
}}

小文字の utf を使っていることがエラーの原因です (例: en_US.utf-8)。

利用可能なロケールは {{ic|locale -a}} で確認できます。

=== tmux で emacs を使っているときに Shift + 矢印キーが動作しない ===

まず [[tmux]] の設定で xterm-keys を有効にしてください:
{{hc|.tmux.conf|
setw -g xterm-keys on
}}

しかしながら、この設定は他のキーコンビネーションを破壊します。それを修正するために、以下を emacs の設定に記述します:
{{hc|~/.emacs|
(defadvice terminal-init-screen
;; `tmux' と名付けることをアドバイスします。そして `terminal-init-screen' が実行される前に実行します。
(before tmux activate)
;; Docstring. これはアドバイスを記述し、emacs 内部で有効になります;
;; たとえば、 C-h f terminal-init-screen RET を実行したときに表示されます。
"Apply xterm keymap, allowing use of keys passed through tmux."
;; これは elisp コードで、`terminal-init-screen' より前に実行されます。
(if (getenv "TMUX")
(let ((map (copy-keymap xterm-function-map)))
(set-keymap-parent map (keymap-parent input-decode-map))
(set-keymap-parent input-decode-map map))))
}}

詳しくは [https://github.com/tmux/tmux/blob/master/FAQ#L242 tmux FAQ] を参照。

=== KDE でウィンドウのリサイズがおかしい ===
KDE ユーザーには Emacs のウィンドウが正しくリサイズされないという現象がおこることがあります。リサイズした部分が透過されマウスでクリックしても下のウィンドウがクリックされます。この挙動を修正するには、KDE の GTK3 テーマを oxygen-gtk 以外のテーマに変更してください。例えば、{{Pkg|gtk3}} に含まれている Emacs テーマを使って下さい。

KDE で Emacs を完全に最大化するには、タイトルバーの Emacs アイコンをクリックして、More Actions > Special Window Settings を選択してください。そして "Size & Position" タブで "Obey geometry restrictions" を選択して、ドロップダウンメニューで "Force" を選んで右のラジオボタンで "No" を選んで下さい。

== 派生 ==

Emacs の実装は多数存在します。おそらく GNU/Emacs が一番ポピュラーです。

軽量な Emacs 互換のテキストエディタは Arch のリポジトリや [[AUR]] にあります。

=== mg ===

mg (旧名 MicroGnuEmacs) は C で書かれた軽量な Emacs の実装です。

{{Pkg|mg}} パッケージから入手できますが、上流の [http://homepage.boetes.org/software/mg/ ページ] からソースをダウンロードすることも可能です。mg は UTF-8 をサポートしていません。

=== zile ===

公式ウェブ[https://www.gnu.org/software/zile/ ページ]によると "GNU Zile は軽量な Emacs クローンです。Zile は Zile Is Lossy Emacs の略となっています。Zile は出来る限り Emacs に近づくように書かれており、きっと全ての Emacs ユーザーの手に馴染むでしょう"。Zile は UTF-8 をサポートしていません。

{{Pkg|zile}} パッケージからインストールできます。

最新の tarball は公式の GNU [http://ftp.sh.cvut.cz/MIRRORS/gnu/pub/gnu/zile/ ミラー] から落とせます。

=== uemacs ===

Linus Torvalds によるカスタム版 Micro-emacs。{{AUR|uemacs-git}} でインストール可能。

最新 (2005) の tarball は [ftp://ftp.cs.helsinki.fi/pub/Software/Local/uEmacs-PK/ こちら] にあります。

=== remacs ===

'''remacs''' はコミュニティによる Emacs の Rust 移植です。{{AUR|remacs-git}} パッケージでインストールできます。

== 参照 ==

* [https://www.gnu.org/software/emacs/ GNU Emacs ホームページ]
* [https://www.gnu.org/software/emacs/manual/emacs.html GNU Emacs マニュアル]
* [http://www.emacswiki.org/cgi-bin/wiki/ Emacs Wiki]
* [http://wikemacs.org WikEmacs - 読みやすいが不完全な Emacs wiki]
* [http://www2.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html Emacs とそのショートカットの有用な紹介]
* [https://d0edfcdc0ccc1cd13cdab5eb986fb92e8660dbef.googledrive.com/host/0B6LMD0u8OhYYZEotN2QyR1hwR1k/ Emacs 教会 (Google ドライブ)]
* [https://www.gnu.org/software/emacs/refcards/pdf/refcard.pdf 公式リファレンスカード]
* [[EXWM]] - Emacs X Window Manager

Emacs

2021-11-30T13:37:23Z

がおびん: /* ヒントとテクニック */ 英語の記述を日本語に翻訳した。

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[Category:GNU]]
[[de:Emacs]]
[[en:Emacs]]
[[es:Emacs]]
[[fr:Emacs]]
[[sr:Emacs]]
[[zh-hans:Emacs]]
[[Wikipedia:ja:Emacs|Emacs]] は拡張性があり、カスタマイズ可能な、セルフドキュメント方式のリアルタイム表示エディタです。Emacs のコアには、多数の Emacs の内蔵機能や拡張を実装するのに使われている言語である、[[Wikipedia:ja:Emacs Lisp|Emacs Lisp]] のインタプリタが存在します。GNU Emacs 22 から GTK がデフォルトの X ツールキットとして使われていますが、CLI 環境でも負けず劣らずに機能します。

== インストール ==

Emacs には複数の種類があります (時々 ''emacsen'' と呼ばれます)。その中で最も一般的なのは [https://www.gnu.org/software/emacs/ GNU Emacs] です。

{{Pkg|emacs}} パッケージを[[インストール]]してください。いつもターミナルで作業をする場合は、GTK+ がいらない {{Pkg|emacs-nox}} の方が良いでしょう (サウンドなどの装飾的な機能もありません)。
ただしテキストバージョンにはいくつか欠点が存在します: サポートしている色やフォント処理の機能 (実行中にサイズを変更したり、単一の文章で複数のサイズを使うなど) が少なくなっています。その上、emacs-nox には Speedbar や GUD (デバッグ環境) などの高度な機能について制限があり、複雑なフェイスを使おうとするとやや遅くなります ("フェイス"とは Emacs におけるテキストの外観のことです)。

== Emacs の実行 ==

emacs を起動する前に、終了の方法を知っておきましょう (特にターミナルで実行する場合): {{ic|Ctrl+x}}{{ic|Ctrl+c}} キーシーケンスを使って下さい。

Emacs を起動するには次を実行:

$ emacs

また、コンソールから使うには:

$ emacs -nw

(.emacs を使わずに) 高速でロードして CLI で編集するには:

$ emacs -Q -nw

nox バージョンをインストールしている場合、'emacs' と 'emacs -nw' は同じになります。

ファイル名を指定することですぐにファイルを開くこともできます:

$ emacs filename.txt

=== 色無し ===

デフォルトでは、Emacs はハイパーリンクが濃青で表示されるカラーテーマで起動します。Emacs をカラーテーマやスキームを使わずに起動するには:

$ emacs -nw --color=no

このコマンドでは全てのテキストがターミナルの前景色だけで表示されます。通常は黒背景に白字か、白背景に黒字となります。

=== デーモンとして ===

毎回 {{ic|.emacs}} ファイルをロードするため Emacs を起動するときには時間が多少かかります。また、別のインスタンスから同じファイルにアクセスしたいと思うときもあるかもしれません。バージョン23から、Emacs はユーザーが接続できるデーモンとして起動することが可能になっています。Emacs をデーモンとして実行するには:

$ emacs --daemon

起動時にデーモンを実行してウィンドウをデーモンに接続すると良いでしょう。さらに、グラフィカル・コンソールクライアント''両方を''同意時にデーモンに接続して GUI を素早く起動することも可能です。

デーモンに接続したいときは場合は次のコマンドを使って下さい (グラフィカル環境から実行したときはグラフィカルクライアントが、tty などのコンソールから実行したときはコンソールクライアントが起動します):

$ emacsclient

グラフィカル環境にいるときもコンソールクライアントを使いたい場合は次のコマンドを使って下さい:

$ emacsclient -t

さらに、{{ic|-a ""}} パラメータを追加することもできます。
これで、最初にコマンドを実行したときは、デーモンとして emacs が起動します。バックグラウンドで動き続けるので後で呼び出した時に起動時間が早くなります (バッファも残り続けます)。

ターミナルや他のプログラムからクライアントを起動した場合、呼び出すプログラムを使うことで Emacs クライアントを閉じなくてもクライアントを使い続けることができます。そのためには、 {{ic|-n}} ({{ic|--no-wait}}) パラメータを使ってクライアントを起動します:
$ emacsclient -nc

Mutt や Git などのプログラムは (コミットメッセージを読むための) エディタが終了するまで待機するため、{{ic|-n}} パラメータを使うことはできません。デフォルトエディタが設定されている場合、他のエディタを指定する必要があるかもしれません (例: {{ic|emacsclient -a "" -t}})。

以下のシェル設定が利用できます:

{{bc|1=
alias emt='emacsclient -nc -a ""'
alias emc='emacsclient -t -a ""'
EDITOR='emacsclient -a ""'
}}
ただしこれには注意事項があります: コマンドのスペースの関係で多数のプログラムが外部エディタをロードすることはできません。

スクリプトを書くほうがもっと使い勝手が良く信頼性があります:
{{hc|/usr/local/bin/emc|<nowiki>
#!/bin/sh
if [ -z "$DISPLAY" ]; then
IS_GRAPHICAL=true
else
IS_GRAPHICAL=$(emacs --batch -Q --eval='(if (fboundp '"'"'tool-bar-mode) (message "true") (message "false"))' 2>&1)
fi

if $IS_GRAPHICAL; then
emacsclient -a "" -nc "$@"
else
emacsclient -a "" -t "$@"
fi
</nowiki>}}
スクリプトは実行可能属性を付けて下さい:
# chmod 755 /usr/local/bin/emc

これで 'emc' が期待通りに動作するようになります。このクライアントをデフォルトのエディタにしたいときは上記のスクリプトで {{ic|EDITOR}} 環境変数を設定すれば OK です。

=== systemd ユニットとして ===

Emacs 26.1 から systemd ユニットが含まれています。Emacs のインストール後に以下のように有効化してください:

$ systemctl --user enable --now emacs

Emacs サーバーを実行したいユーザーで上記のコマンドを実行してください。サービスの起動後、Emacs の準備ができます。ユニットファイルは {{ic|/usr/lib/systemd/user/emacs.service}} に存在します。ユニットファイルの中身は以下のようになっています:

{{hc|/usr/lib/systemd/user/emacs.service|<nowiki>
[Unit]
Description=Emacs text editor
Documentation=info:emacs man:emacs(1) https://gnu.org/software/emacs/

[Service]
Type=simple
ExecStart=/usr/bin/emacs --fg-daemon
ExecStop=/usr/bin/emacsclient --eval "(kill-emacs)"
Environment=SSH_AUTH_SOCK=%t/keyring/ssh
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

systemd のユーザーユニットはログインシェル ({{ic|~/.bash_profile}} など) から環境変数を継承しないため、{{ic|~/.pam_environment}} に変数を設定すると良いでしょう。詳しくは [[Systemd/ユーザー]]を参照。

emacs をデーモンとして起動する場合、{{ic|VISUAL}} と {{ic|EDITOR}} 環境変数を {{ic|emacsclient}} に設定することでプログラムからエディタを起動するときにエディタの新しいインスタンスを起動するかわりに emacsclient が使われるようになります。外部エディタを使用するプログラムとしてメールプログラム (メッセージを編集するため) や Git (コミットメッセージを編集するため)、less ({{ic|v}} コマンドで表示されたファイルを編集するため) などが存在します。emacsclient の {{ic|-n}} ({{ic|--nowait}}) オプションは使用しないでください。基本的にプログラムはエディタが終了したときに編集が完了したと認識するためです。

GUI の Emacs のスタートメニューエントリなども emacs ではなく emacsclient が使われるように変更することを推奨します。

== クイックスタート ==

Emacs は複雑ですが、そのカスタマイズと拡張性のレベルによってもたらされる利益を理解し始めるのにそう時間はかからないでしょう。さらに、幅広い拡張を利用することで Emacs はあらゆる種類の文章編集のための強力な環境に姿を変えることができます。

Emacs には素晴らしいチュートリアルが内蔵されており、スプラッシュ画面の最初のリンクをクリックしてアクセスできます。メニューから ''Help->Emacs Tutorial'' を選択するか 'F1' の後に 't' を押して下さい。このページは Emacs を始めるのに追加的なリソースになるように書かれています。

初心者にもエキスパートにも役立つ、リファレンスカードのセットも Emacs に含まれています、{{ic|/usr/share/emacs/<version>/etc/refcards/}} を見て下さい (<version> はあなたの emacs のバージョンに置き換えて下さい)。

=== 基本的な用語と慣習 ===

始めは慣れないと思うかもしれませんが Emacs にはいくつか特別な用語法と約束事があり、必要に応じて紹介していきます。ただ、Emacs を使うにあたって当然知ってるべきとされるような、基本的な用語についてはあらかじめ説明しておいたほうが良いでしょう。

真っ先に知るべきは''バッファ''の概念です。バッファは Emacs の中のデータを表します。例えば、Emacs でファイルを開いたとき、ディスクからファイルから読み込まれてバッファに中身が保存され、バッファを編集して後でディスクに上書き保存することができます。バッファはテキストに限られず、画像やウィジェットなども含めます。作業中でもバッファでアプリケーションを表示することすらできます。こういう考え方もできます: ディスク上のデータは'ファイル'であり、一方、Emacs 上のデータは'バッファ'である。

Emacs におけるキーシーケンスの決まり事も見慣れないかもしれません。即ち:

'''C-x''' は Control-x を示します

'''M-x''' は Meta-x を示します

{{Note|'Meta' は多くの場合 Alt キーに相当します。また、Esc キーを使うことも可能です。}}

例えば、Emacs を終了するには次のキーシーケンスを使います: '''C-x C-c'''。これは "Control を押しながら 'x' を押す。手を離す。Control を押しながら 'c' を押す" と読み替えることができます。Emacs にはメニューバーが存在しますが、キーシーケンスを使いこなせるように練習することを推奨します。以下から、Emacs で使われるキーバインディングと慣習について説明します。

=== 移動 ===

カーソルの移動は他のグラフィカルエディタとよく似ています。マウスや方向キーを使ってカーソルの位置 (Emacs では''ポイント''と呼ばれます) を変更することができます。一般的な移動コマンドは方向キーで出来ますが、Emacs には他にも便利なバインディングが存在します。1文字先に移動するには '''C-f''' を使用して、1文字前に移動するには '''C-b''' を使用します。'''C-n''' と '''C-p''' でそれぞれ次の行と前の行に移動できます。基本的に、マウスや方向キーを使うよりもこれらのキーシーケンスを使うことが推奨されています。

当然、Emacs には、単語や文単位で移動できる、もっと高度な移動コマンドが用意されています。'''M-f''' は1単語先に移動して '''M-b''' は1単語前にポイント移動します。同じく、'''M-e''' は1文先にポイント移動して '''M-a''' は前に戻ります。

ここまでは、紹介した全ての移動コマンドはポイントに関連しています。'''M-<''' を使うことでバッファの最初にポイントを移動することができ、逆に、'''M->''' はバッファの最後に移動します。特定の行番号にポイントを移動するには、'''M-g g''' を使います。'''M-g g''' は移動したい行番号を尋ねます。また、現在の行の先頭と末尾に移動するには、'''C-a''' あるいは '''C-e''' を使って下さい。

{{Note|上記のコマンドを含む全てのコマンドのキーバインドは、現在有効になっているモードによって''多少''ながら変わってくる可能性があります。しかしながら、同一の機能を実行するのにコマンドを置き換えることはあまりありません。詳しくは[[#モード|モード]]を見て下さい。}}

=== ファイルとバッファ ===

Emacs にはファイルを操作するためのコマンドが用意されています。このセクションでは最もよく使われるコマンドを紹介します。ファイルを開くには '''C-x C-f''' を使います (Emacs ではこのコマンドを 'find-file' と呼びます)。指定されたファイルが存在しなかった場合、Emacs は空のバッファを開きます。バッファを保存するとバッファの中身が入ったファイルが作成されます。'''C-x C-s''' を使うことでバッファを保存できます。別のファイル名でバッファを保存するには、'''C-x C-w''' を使って下さい (this is a mnemonic for the command 'write-file')。新しいファイル名が尋ねられ、ディスクにファイルが書き込まれます。'''C-x s''' で全てのバッファを保存することも可能です。最後に保存されていた状態からバッファに変更が加えられている場合、保存を実行するかどうか訊くプロンプトが表示されます。

{{Note|ファイルに対応するバッファが既に開かれている場合 '''C-x C-f''' はディスクからファイルを読み込みません。ディスクからファイルを再度読み込むには、(1) まずバッファを閉じて ('''C-x k''')、それからファイルを開くか ('''C-x C-f''') あるいは (2) '''M-x revert-buffer''' を使ってディスク上のデータに戻して下さい。それか (3) '''C-x C-v''' でファイルを現在のバッファにロードするか (4) '''C-x RET r RET''' で同一コードでファイルを再読み込みしてください。}}

"find-file" や "write-file" などのインタラクティブなコマンドでは Emacs ウィンドウの一番下の行に入力が求められます。この行のことは''ミニバッファ''と呼びます。ミニバッファでは基本的な編集コマンドを使うことができ、多くの *nix シェルで利用できるのと同じようなタブ補完機能があります。'''<TAB>''' を2回連続で押すと補完リストが表示され、マウスを使ってリストから補完候補を選択することも可能です。ミニバッファでの補完はコマンドやファイル名など様々な形で使えます。

ミニバッファには履歴機能も存在します。前に入力したコマンドは '''Up Arrow''' または '''M-p''' を使うことで再呼び出しできます。

ミニバッファは '''C-g''' を押すことでいつでも終了できます。

ファイルを複数開いたら、ファイルを切り替える手段が必要です。Emacs 内に既に存在するバッファにファイルを開くと、Emacs はそのバッファに切り替えます。しかしながらこれは効率的とは言えません。Emacs には表示するバッファを選択する '''C-x b''' が存在します (タブ補完が使えます)。存在しないバッファの名前を入力すると、その名前で新しいバッファが作成されます。

{{Note|前のバッファに切り替えるには '''C-x b <RET>''' を使います。前のバッファがデフォルトだからです。}}

全てのバッファのリストを '''C-x C-b''' で表示することができます。バッファが必要なくなったときは '''C-x k''' で削除することが可能です。

=== 編集 ===

Emacs には多数の編集コマンドが存在します。まだ紹介していない最も重要なコマンドはおそらく 'undo' でしょう。'''C-_''' または '''C-/''' で実行することができます。基本的に移動コマンドには対応する削除コマンドが存在します。例えば '''M-<backspace>''' で後方の単語を削除することができ、{{ic|M-d}} で前方の単語を削除できます。行末または文章の終わりまで削除するにはそれぞれ {{ic|C-k}} または {{ic|M-k}} を使います。

1行は80文字を超えていはいけないという経験則が存在します。1行の長さを長くしすぎないことで、特にウィンドウの縁で改行してしまうような場合に、可読性を維持することができます。改行の自動挿入 (または削除) は Emacs では詰め込み (''filling'') と呼ばれます。{{ic|M-q}} を使うことでパラグラフを折り返させることができます。

文字列と単語はそれぞれ {{ic|C-t}} と {{ic|M-t}} で置き換えることが可能です。例えば {{ic|Hello World!}} を {{ic|World! Hello}} と置き換えられます。

単語の大文字小文字はすぐに修正できます。{{ic|M-l}} は単語を小文字に変換し ({{ic|HELLO}} は {{ic|hello}})、{{ic|M-u}} は単語を大文字に変換します ({{ic|hello}} は {{ic|HELLO}})。そして {{ic|M-c}} は単語の最初の文字を大文字にして他の文字は小文字にします ({{ic|hElLo}} は {{ic|Hello}})。

=== kill と yank とリージョン ===

リージョンとは、2点間にあるテキストです。2点のうちの1つは、''マーク'' と呼ばれ、もう1つはポイントです。 '''C-<SPC>''' によってマークの位置がセットされ、その後でポイントが移動することでリージョンが作られます。GNU Emacs 23.1 以降、リージョンはデフォルトで可視化されます。リージョン上で動作する多くのコマンドがあり、もっともよく使われるコマンドに ''killing'' コマンドがあります。

Emacs では、カット＆ペーストはそれぞれ、''kill'' と ''yank'' と呼ばれます。1文字以上の文字を削除するコマンド（ '''C-k''' や '''M-d''' といった上で記述したコマンドも含めて）は、実際にテキストをカットし、''kill-ring'' として知られるものに追加します。kill-ring は、単に kill されたテキストのリストです。kill-ring は、デフォルトでは直近60個の kill されたテキストを保存します。kill に成功すると、リストの先頭に接続されて保存されます。

'''C-w''' と '''M-w''' によって、それぞれリージョンの kill とコピーができます。

kill されたテキストをバッファに挿入する（'yanking' として知られます）ためには、'''C-y''' を使います。 '''C-y''' は、複数回使用することで、繰り返しテキストを yank できます。前述の通り、以前の kill は、リストに保存されます。しかし、'''C-y''' は、そのうち最初のものしか取得しません。それより前の kill は、'''M-y''' によってアクセスすることができます。これによって、'yank' で挿入されたテキストをリストの先頭に移動させます。 '''M-y''' は '''C-y''' に続けて使われなければならず、kill-ring をたどるために何度でも使えます。

=== 検索と置換 ===

文字列を検索することは、テキストの編集において一般的な作業です。検索は、'''C-s''' (後方検索) または '''C-r''' (前方検索) によって実行されます。これらのコマンドは、検索する文字列を入力するプロンプトを表示します。検索は1文字入力するごとに実行され、タイプごとに次に（あるいは前に）一致した文字列にマッチします。次の検索結果に行くには C-s を、前の検索結果に行くには C-r を押します。もし探しているものが見つかったのであれば、'''<RET>''' を押すことで検索を終了できます。一方、検索を開始した場所に戻りたければ '''C-g ''' を押します。

いったん検索が完了すると (たとえば '''C-g''' 等で中断していない場合)、検索された文字列は、次の検索のデフォルト検索文字となります。検索された文字を使用するには、後方検索なら '''C-s C-s''' , 前方検索なら '''C-r C-r''' をそれぞれ押します。

I-search には、いくつかの有用なコマンドがあります。 '''M-e''' によって、検索文字列の編集が可能です。 '''M-c''' によって、大文字小文字を区別するか、しないかを切り替えることができます。

正規表現検索は、検索の開始コマンド以外、上述の検索と同様に動作します。 '''C-M-s''' あるいは '''C-M-r''' によって、それぞれ正規表現による後方検索、前方検索を開始します。いったん正規表現検索を開始すると、文字列検索と同様に '''C-s''' と '''C-r''' を後方検索、前方検索に使用することができます。

検索に加え、文字列や正規表現を置換することができます（それぞれ '''M-%''' および '''C-M-%''' によって実行されます）。元のテキストと変換後のテキスト用にプロンプトが表示され、それからハイライトされた一致箇所に対する動作のために別のプロンプトが表示されます。多くのオプションが使用できますが（使用できるオプションの完全なリストは '''?''' を押してください）、もっとも一般的に使われるのは、変換を実行する '''y''' と、スキップする '''n''' 、そしてハイライトされている文字列を含め、以降すべての一致に対して変換する '''!''' になります。

=== 前置引数 ===

'''C-u''' は、'universal-argument' コマンドに対応づけられています。'universal-argument' を渡すことによって、より多くの情報をコマンドに提供できます（この情報を '前置引数' と呼びます）。たとえば

C-u 80 %

は、%記号の行を挿入します。また、

C-u 4 M-d

は4単語を削除します。この場合、'''M-d''' によって実行されるコマンドへ、要求する単語の数を渡しています。

universal argument は、'''M-<数字>''' によって少し早く入力することができます。

M-80 %

=== インデント ===

インデントは、1行をインデントする '''<TAB>''' やリージョンをインデントする '''C-M-\''' によって実行されます。リージョンが有効（''たとえば''ハイライトされている）場合、'''<TAB>''' はリージョンもインデントします。

テキストがどのようにインデントされるかは、正確には有効になっている ''メジャーモード'' に依ります。メジャーモードは、しばしば特定の種類のテキストをインデントするときに特化したインデントスタイルを定義します。（より詳しくは [[#モード|Modes]] を見てください。）

いくつかの場合、ファイルタイプに対して適したメジャーモードがありません。その場合、手動でのインデントが必要になります。リージョンを作成（ [[#kill と yank とリージョン|kill と yank とリージョン]] 参照）し、'''C-u <n> C-x <TAB>''' でインデントを実行してください。（ここで、'<n>' はリージョンに含まれるテキストがインデントされる列の数です。）例えば、

リージョンのインデントを4列追加する:

C-u 4 C-x <TAB>

リージョンのインデントを2列減らす:

C-u -2 C-x <TAB>

=== ウィンドウとフレーム ===

Emacs は、多くのファイルを同時に編集するために便利であるよう設計されています。これは、Emacs のインタフェースを3つの階層にわけることで実現されています。つまり、すでに紹介済みのバッファ、''ウィンドウ'' と ''フレーム'' です。

'''ウィンドウ''' とは、Emacsでバッファを表示している場所のことです。1つのウィンドウは、一度に1つのバッファしか表示できません。しかし、1つのバッファは複数のウィンドウに表示できます。それぞれのウィンドウの下には、''モードライン'' があります。モードラインには、そのバッファの情報が表示されています。

'''フレーム''' とは、Emacs の"ウィンドウ"（一般的な意味。たとえば最近のデスクトップパラダイムの意味での 'ウィンドウ'）です。フレームには、タイトルバー、メニューバー、1つ以上の 'ウィンドウ' (Emacs 的な意味。たとえば上で定義した 'ウィンドウ') が含まれます。

以降では、これらの単語は Emacs に存在するものでの定義として使用します。

ウィンドウを水平あるいは垂直に分割するには、それぞれ '''C-x 2''' あるいは '''C-x 3''' を使います。これは、現在のフレームにもう1つのウィンドウを生成する効果があります。複数のウィンドウ間を巡回するには、'''C-x o''' を使用します。

ウィンドウ分割の反対は、ウィンドウを削除することです。現在のウィンドウを削除するには '''C-x 0''' を使い、現在のウィンドウ以外を削除するには '''C-x 1''' を使います。

ウィンドウと同様に、フレームも生成や削除が可能です。 '''C-x 5 2''' によってフレームを生成できます。 '''C-x 5 0''' によって現在のフレームを削除し、'''C-x 5 1''' によってr現在のフレーム以外のすべてのフレームを削除します。

{{Note|これらのコマンドはバッファには影響しません。たとえば、ウィンドウを削除しても表示されているバッファは kill されません。}}

=== モード ===

Emacs モードは Emacs Lisp で書かれた拡張であり、接続されているバッファの挙動を制御します。大抵の場合、インデントやシンタックスハイライト、テキストを編集するときのキーバインドを提供します。洗練されたモードは Emacs を完全な IDE (統合開発環境) に変貌させます。Emacs は基本的にファイルの拡張子でモードをロードすべきか判断します。

シェルスクリプトを編集するのに役立つモードとして sh-mode, line-number-mode, column-number-mode が存在します。同時に使用することができ、以下のコマンドで呼び出します:

'''M-x sh-mode <RET>'''

'''M-x column-number-mode <RET>'''

line-number-mode はデフォルトで有効になっていますが、コマンドを再度実行することでオンとオフを切り替えられます:

'''M-x line-number-mode <RET>'''

sh-mode は、''メジャーモード'' の1つです。メジャーモードは Emacs を調整し、時には、特定の種類のテキストの編集用に特別なコマンドを提供します。それぞれのバッファでは、メジャーモードは1つだけが有効です。シンタックスハイライトやインデントサポートに加えて、sh-mode はシェルスクリプトを書く助けになるいくつかのコマンドを定義しています。以下に、それらの内のいくつかを示します。

'''C-c (''' 関数定義を挿入する

'''C-c C-f''' 'for' ループを挿入する

'''C-c TAB''' 'if' 文を挿入する

'''C-c C-w''' 'while' ループを挿入する

'''C-c C-l''' 1 から n までの番号付きループを挿入する

'line-number-mode' と 'column-number-mode' は''マイナーモード''です。マイナーモードはメジャーモードを拡張することができ、同時に任意の数のマイナーモードを有効にできます。

=== マニュアル ===

Emacs を本当にマスターしたいのであれば、一番よく読むべき文章はやはり公式マニュアルです:
* Emacs: 完全な Emacs ユーザーマニュアル
* Emacs FAQ
* Emacs Lisp Intro: プログラミング言語を使用したことがない場合
* Elisp: プログラミング言語をよく知っている場合

これらは、 [http://www.gnu.org/software/emacs/manual/ GNU.org] から PDF として入手できます。あるいは Emacs 自身にて組み込みの 'info' リーダー '''C-h i''' を用いて直接読むこともできます。本を選択するには '''m''' を押してください。

ユーザーの幾人かは、'info' で読むことを好みます。便利なショートカットであり、段落はウィンドウ幅に調整され、フォントは現在の画面解像度に調整されるためです。何人かは目に優しいと気づいています。最後に、本の内容を任意の Emacs バッファへ簡単にコピーでき、さらに例示されている Lisp コードを直接実行することさえできます。

'''info''' 本について、もっとよく知りたいなら、'''C-h i m info <RET>''' を実行してください。
info モードで '''?''' を押すと、ショートカットの簡易リストが表示されます。

== カスタマイズ ==

Emacs は {{ic|~/.emacs}} を編集するか '''M-x customize''' を使うことで設定をすることができます。このセクションでは手動で {{ic|~/.emacs}} を編集する方に焦点をあて、いくつかのカスタマイズ例を示すことで、一般的な Emacs の設定をデモンストレーションします。customize コマンドは調整を行うためのシンプルなインターフェイスを提供しますが、おそらく Emacs に慣れてくるにつれて制約を感じるようになるでしょう。

ここでの例は、すべて Emacs が動作している間に動作します。Emacs 内で式を評価するには、以下を使います。

'''C-M-x''' ポイントがある式を評価する

あるいは、

'''C-x C-e''' ポイントの直前の ')' を最後のカッコとする式を評価する

何人かのユーザーは、プロンプトで 'yes' や 'no' をタイプすると、すぐに疲れます。その代わりに 'y' や 'n' を使うために:

(defalias 'yes-or-no-p 'y-or-n-p)

カーソルの点滅を止めるには、次を使用:

(blink-cursor-mode -1)

同じく、前のセクションにある column-number-mode を有効にするには:

(column-number-mode 1)

前の2つのコマンドに類似性があるのは偶然ではありません。blink-cursor-mode と column-number-mode は、共にマイナーモードです。ルールとして、マイナーモードは正の数を引数にとると有効になり、負の数で無効になります。引数が省略された時、マイナーモードは on/off を切り替えます。

マイナーモードのその他いくつかの例を示します。以下はそれぞれ、スクロールバー、メニューバー、ツールバーを無効にします。

(scroll-bar-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)

変数 'auto-mode-alist' によって、特定のファイル名に対してデフォルトで使われるメジャーモードを変更することができます。以下の例では、'.tut' および '.req' ファイルのデフォルトのメジャーモードを 'text-mode' にします。

(setq auto-mode-alist
(append
'(("\\.tut$" . text-mode)
("\\.req$" . text-mode))
auto-mode-alist))

設定は、基底となるモードごとに適用することもできます。基本的な方法は、''hook'' に関数を追加することです。例えば、text-mode でだけインデントをタブの代わりに強制的にスペースを使用するためには:

(add-hook 'text-mode-hook (lambda () (setq indent-tabs-mode nil)))

同様に、場所によらずインデントにてスペースを使用するには:

(setq-default indent-tabs-mode nil)

キーバインドは、2つの方法で調整できます。1つ目の方法は 'define-key' です。'define-key' は、コマンドに対するキーバインドを作成できますが、1つのモードに対してだけ作成します。以下の例では、'''F8''' に、'text-mode' バッファでは行末のホワイトスペースを除去するよう割り当てます。

(define-key text-mode-map (kbd "<f8>") 'delete-trailing-whitespace)

もう1つの方法は、'global-set-key' です。これによって、場所によらずキーにコマンドを割り当てることができます。'query-replace-regexp' ('''C-M-%''') を '<f7>' に割り当てるには:

(global-set-key (kbd "<f7>") 'query-replace-regexp)

他のキーにコマンドを割り当てることは、既存の割当を入れ替えるわけではありません。たとえば、上記例の後、'query-replace-regexp' は、'''F7''' と '''C-M-%''' の両方に割り当てられます。

Emacs のほとんどすべてがカスタマイズできます。[http://emacswiki.org/ Emacs Wiki] を通して見ることが基礎固めに適しています。

=== マルチ設定 ===

複数の設定を使い、Emacs にどれか一つをロードさせることができます。

例えば、2つの設定ファイルを定義してみましょう。

{{hc|.emacs|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/plugins" nil t)
(load "~/.emacs.d/theme" nil t)
}}

これによって、デーモンとしての起動用にフルカスタムをロードします。しかし、''plugins'' ファイルは巨大で、ロードが遅いです。''plugins'' 機能が不要な新しい Emacs インスタンスを生成したい場合、''plugins'' を毎回ロードすることは面倒です。

{{hc|.emacs-light|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/theme" nil t)
}}

Emacs を以下のコマンドで起動します。
emacs -q -l ~/.emacs-light
これによって、エイリアスを生成して、呼び出しを簡単にすることができます。

=== ローカル・カスタム変数 ===

設定ファイル内で変数を定義することができます。この変数はファイル内でローカルに変更することができます。

(defcustom my-compiler "gcc" "Some documentation")

どんなファイルでもローカル変数を定義するには2つの方法があります。[https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html 完全な詳細のマニュアル ] を参照してください

* {{ic| M-x add-file-local-variable-prop-line}} は、ファイルの先頭に以下のようなコメント行を追加します。
// -*- my-compiler:g++; mode:c++ -*-
* {{ic| M-x add-file-local-variable}} は、ファイルの末尾付近に行を追加します。
// Local Variables:
// my-compiler: g++
// mode: c++
// End:

変数の効果を得るためには、{{ic|M-x revert-buffer}} を実行する必要あることに注意してください。

カスタム変数は、デフォルトでは安全でないと考えられています。もしカスタム変数によって再定義されたローカル変数を含むファイルを開こうとすると、Emacs は確認するよう通知します。

変数を安全であるとして宣言することもできます。これによって確認のためのプロンプトを除去することができます。新しい変数が安全と考えられるためには検証されなければならない、と述語を指定する必要があります。

(defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

この例では、文字列以外の何かにセットしようとすると、Emacs は安全でないと考えます。

=== カスタムカラーとテーマ ===

''face'' を使うことで簡単に色をカスタマイズすることができます:
(set-face-background 'region "color-17")
(set-face-foreground 'region "white")
(set-face-bold-p 'font-lock-builtin-face t )

ポイントがある場所の face の名前を Emacs に表示させることができます。そのためには ''customize-face'' を使います。どのように色、太字、下線、等が設定されているかを示すことができます。

コンソール上の Emacs は、256色を扱うことができます。しかし、それには適したターミナルを使わなければなりません。たとえば URxvt は256色をサポートしています。''list-colors-display'' によって、サポートされる色の包括的なリストが表示できます。これは強くターミナルに依存します。

=== SyncTeX サポート ===

Emacs は強力な LaTeX エディタです。LaTeX モードを必要に応じて自由に編集・作成することができます。

SyncTeX サポートといった、まだいくつかの挑戦があります。最初に TeX ディストリビューションに SyncTeX があるかを確認する必要があります。もし TeX Live を手動でインストールした場合、''synctex'' パッケージをインストールする必要があるかもしれません。
# umask 022 && tlmgr install synctex

SyncTeX サポートは、ビューア依存です。ここでは例として Zathura を使用します。他の PDF ビューアを使用する場合、コードを変更する必要があります。

(defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
"TeX 文書用 PDF ビューア。
同じドキュメントを2回起動したこと検出する、または Emacs を
閉じても表示を継続するためにビューアを fork したい場合、

シンプルなコマンド:

zathura --fork

SyncTex を用いて pdf を逆検索するために以下が使用できる。

emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

引用符および二重引用符は必須で、適切にエスケープされなければならない点に注意。"
:safe 'stringp)

カスタム変数を定義します。もし AucTeX や Emacs 標準の LaTeX-mode を使用しているなら、それに応じてビューアを設定する必要があります。

LaTeX ソースファイルを Emacs で開き、文書をコンパイルし、ビューアを起動します。Zathura が起動します。{{ic|Ctrl+Left click}} を押すと、Emacs は対応する位置にポイントを移動させます。

=== Systemd ファイルのシンタックスハイライト ===

[https://github.com/holomorph/systemd-mode systemd-mode] を使うことができます。

もしくは init ファイルに以下を追加することで、簡単に emacs で systemd のファイル (サービスやタイマーなど) をカラー表示できます:

(add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

=== emacs-nox のクリップボードサポート ===

emacs-nox で [[Xorg]] クリップボードを使うには、{{Pkg|xclip}} を[[インストール]]して以下の関数を {{ic|~/.emacs}} に追加してください [https://lists.gnu.org/archive/html/help-gnu-emacs/2014-08/msg00189.html]:

{{bc|1=
;; use xclip to copy/paste in emacs-nox
(unless window-system
(when (getenv "DISPLAY")
(defun xclip-cut-function (text &optional push)
(with-temp-buffer
(insert text)
(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
(defun xclip-paste-function()
(let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
(unless (string= (car kill-ring) xclip-output)
xclip-output )))
(setq interprogram-cut-function 'xclip-cut-function)
(setq interprogram-paste-function 'xclip-paste-function)
))
}}

{{Tip|以下を追加することでターミナルマウスサポートも有効にできます:
{{bc|1=
;; xterm mouse support
(require 'mouse)
(xterm-mouse-mode t)
}}
[http://www.opensource.apple.com/source/emacs/emacs-51/emacs/lisp/mwheel.el mwheel.el] を参照。}}

== ヒントとテクニック ==

前のセクションでは基本的な編集コマンドを説明していますが、それだけでは Emacs の可能性はわかりません。このセクションではより高度なテクニックや機能を紹介します。

ただし全てを説明するとなると長くなりすぎます。そのためこのセクションはあくまで Emacs の雅やかな機能をいくつか''デモ''するだけにとどめます。

全ての機能の詳細な説明は[[#ドキュメント|ドキュメント]]を見て下さい。

=== TRAMP ===

TRAMP (Transparent Remote Access, Multiple Protocols) は多数のプロトコルで、リモートファイルに透過的にアクセスすることができる拡張です。ファイル名を入力するときに、特定の形式を入力すると TRAMP が呼びだされます。例:

{{ic|/etc/hosts}} を root 権限で開く前に root のパスワードを要求するには:

C-x C-f /sudo::/etc/hosts

SSH で 'myhost' に 'myuser' として接続して {{ic|~/example.txt}} ファイルを開くには:

C-x C-f /ssh:myuser@myhost:~/example.txt

TRAMP のパスは '/[protocol]:[[user@]host]:<file>' という形式で指定します。TRAMP がサポートしているのは上記の例に限りません。詳しくは TRAMP の info マニュアルを参照してください。マニュアルは Emacs に付属しています。

=== キーボードマクロとレジスタ ===

このセクションでは、2, 3の強力な編集機能に対する実用的なデモンストレーションを示します。つまり、''keyboard macros'' と ''registers'' です。

目的は、一連の文字のリストとこのリスト内での対応する位置を作ることです。それらは手動で成形することもできますが、遅く、間違いをおこしやすいです。その代わりに、Emacs のよりパワフルないくつかの編集機能によって、レバレッジを効かせられます。答えの前に、以下で使うテクニックの背景について詳細を示します。

1つ目の機能は ''レジスタ'' です。レジスタは、数字からウィンドウコンフィグまでに及ぶ様々なデータ型を格納し取得するために使われます。それぞれのレジスタには、1文字の名前が与えられます。この文字はレジスタへのアクセスに使われます。

もう1つの機能は、''キーボードマクロ'' です。キーボードマクロは、一連のコマンドを格納します。それによって後で簡単に繰り返すことができます。これらの変化を、ここでステップバイステップで実施してみます。

文字集合を含むバッファから始めます。
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

'number-to-register' コマンド（'''C-x r n'''）を呼び出してレジスタを準備します。それから数字 '0' をレジスタ 'k' に保存します。

C-x r n k

バッファの先頭にポイントを移動させ、キーボードマクロ（'''C-x ('''）を実行開始し、文字のフォーマットを始めます。

C-x ( C-f M-4 .

レジスタ 'k' に挿入 ('''C-x r i''') とインクリメント ('''C-x r +''') を行います。前置引数 ('''C-u''') によって、テキストを挿入した後でポイント位置を離します。

C-u C-x r i k C-x r + k

改行を入れることでフォーマットを完了させます。残りの文字に対しては、Emacs はキーボードマクロを定義したポイント位置から始まるこのプロセスを繰り返すことができます。'''C-x e''' はキーボードマクロを完了して呼び出します。前置引数 '''M-0''' によって、エラーが起きるまでマクロを繰り返します。この場合、バッファの最後に到着すると中断します。

<RET> M-0 C-x e

結果は以下のようになります:

A....0
B....1
C....2
[...]
x....49
y....50
z....51

もし、後々使うためにマクロを保存したいなら、名前をつけて設定ファイルに保存する必要があります。
name-last-kbd-macro
insert-kbd-macro

定義したマクロは、すべてマクロリングに格納されます。マクロを巡回するには、
'''C-x C-k C-n''' 次のマクロ
'''C-x C-k C-p''' 前のマクロ

同様に、仮想的に何でも保存するためにレジスタを使えます。

'''C-x r SPC''' 現在のポイント（位置）をレジスタにコピーする
'''C-x r w''' 現在のウィンドウ設定をレジスタにコピーする
'''C-x r j''' レジスタに再保存する。

しばしば異なるプロジェクトごとにウィンドウを行ったり来たりして作業をするなら、別のプロジェクトのために設定を保存し、ある画角から別の画角へ簡単に切り替えることができます。

'''list-registers''' コマンドによって、使用したレジスタをリストにして表示することができます。

=== 正規表現 ===

Emacs Manual より: "正規表現 (''regexp'' と略す) とは、一致する可能性がある一連の (無限個でもよい) 文字列を表現するパターンである"。このセクションでは正規表現自体には深くは立ち入りません (単純に説明しきれない)。そのかわり正規表現のパワーを簡単にデモンストレーションします。詳しい説明は Emacs Manual の [https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html#Regular-Expressions Regular Expressions] セクションを見て下さい。

上と同じシナリオが与えられた場合、つまり複数文字のリストがあり、そのリスト内に複数文字の相対位置を持つリストを考えます。(参照 [[#キーボードマクロとレジスタ|キーボードマクロとレジスタ]]) 再度、以下を含むバッファから開始します。

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

バッファの最初に '''C-M-%''' を使用します。（もしキー列が実行するには難しいなら、'''M-x query-replace-regexp''' を使う方がより快適かもしれません。）プロンプトには以下を入力します：
$.$
これは、単に1文字にマッチします。それから置換先のプロンプトには：
\1....\#^J
{{Note|'^J' は、改行を配置することを意味します。改行は、プロンプト内で入力できません。改行記号は、その他に '''C-q C-j''' を使って入力することもできます。}}
置換先の表現は、以下のように読みます： "最初のカッコに囲まれた部分にマッチするテキストを挿入しなさい (今回は1文字)。次にピリオドを4文字挿入し、それから自動的にインクリメントされた数を挿入し、改行が続きます。"

最後に、'''!''' を押すことで、バッファ全体に渡って適用します。前のセクションで実行したすべてのフォーマットが、1つの正規表現置換で実行できます。

=== 矩形選択 ===

先進的なテキストエディタが当然備えているべき強力な機能として、テキストを矩形で選択・編集できるというのがあるでしょう。

Emacs でも矩形選択は可能です。'''C-SPC''' で普通にテキストを選択してから、複数の矩形コマンドを使うことができます。

'''C-x r t''' 矩形領域にテキストを挿入する
'''C-x r k''' 矩形領域を kill する (kill-ring に保存する)
'''C-x r y''' 矩形領域を Yank する
'''C-x r o''' 矩形領域にスペースを挿入する

たとえ矩形の外のテキストがハイライトされていても、上記のコマンドが影響を与えることはありません。

=== ブックマーク ===

Emacs は開いたファイルのリストを保存できます。

'''C-x r m''' カレントバッファをブックマークに追加。
'''C-x r b''' ブックマークからバッファを開く。
'''C-x r l''' ブックマークの確認。

=== Elisp インタプリタ ===

'''eval-last-sexp''' ('''C-x C-e''') を使うことで、elisp 式を評価することができます。Emacs は、開始時に常に '''*scratch*''' バッファを生成します。*scratch* バッファはディスクに保存されず、自由にテキストやコードを記述することができます。これは特にelispの評価に有用です。このバッファは、デフォルトで '''lisp-interaction-mode''' 有効で開始することに注意してください。

その他に、Emacs は、'''ielm''' コマンドでトップレベルの elisp インタプリタを提供します。

=== スマートなウィンドウ切り替え ===

長い間使っていると '''C-x o''' による伝統的なウィンドウ切り替えは面倒かもしれません。'''windmove''' コマンドはもっと便利にウィンドウを切り替えることができます。{{ic|Shift}} を押しながら方向キーでウィンドウを指定するだけです。

windmove キーを有効にするには、設定ファイルに以下を記述してください:

{{hc|~/.emacs|
(when (fboundp 'windmove-default-keybindings)
(windmove-default-keybindings))
}}

=== シェルコマンドの実行 ===

'''M-!''' を使うことで、外部コマンドを呼び出すことができます。前置引数を使用する（'''C-u M-!'''）ことで、結果を現在のバッファのポイント位置に出力することができます。

リージョン上で '''M-|''' を使うことで、リージョンをコマンドの入力として使うことができます。たとえば、

'''C-u M-| sort -u RET'''

によって、リージョンがソートされ、重複を除去して、リージョンをその結果で置き換えることができます。

=== シェルバッファ ===

シェルバッファを生成することで、ターミナルと同様にコマンドを実行することができます。
昔ながらのシェルバッファは、'''shell''' コマンドによって生成することができます。

Emacs は、すべて Emacs Lisp で書かれた非常に強力なシェル '''eshell''' を機能として持っています。csh や zshといったシェルに対する主な優位点は、ネイティブなシェル言語が elisp そのものである点です。そのため、シェル関数として elisp のすべての先進的な機能を使用できます。

=== 対応する括弧のハイライト ===

'''show-paren''' モードを使うことができます。デフォルトでは、対応する括弧が表示されるまで少し遅延がありますが、'''show-paren-delay''' を 0 に設定することでなくすことができます。

{{hc|~/.emacs|
(setq show-paren-delay 0)
(show-paren-mode 1)
}}

=== スペルチェック ===

辞書を選択するには:
'''M-x ispell-change-dictionary'''

一単語をチェックするには '''M-$''' を使います。
バッファ全体をチェックするには、
'''M-x ispell-buffer'''

'''flyspell-mode''' を有効にすることで、入力と同時に (on-the-fly) スペルチェックができます。ソースコードに対しては、代わりに '''flyspell-prog-mode''' を使うことで、コメントに限定して有効にできます。Emacs でスペルチェックをするには ''aspell'' パッケージも必要になります。それぞれの言語に対応したパッケージがあります。英語に対しては、（''aspell'' と共に）''aspell-en'' が必要になります。

=== テーブル ===

Emacs は、様々な言語での一般的なテーブルを扱う居力な機能を備えています。例を見てみましょう。

Fruits Quantity
Apples 5
Melons 2

この内容をリージョンで選択して、以下を実行します。
table-capture

半角スペース2文字を列の区切りとして、改行 ('''C-q C-j''') を行の区切りとして使用します。
以下の結果を得ます。

+------+--------+
|Fruits|Quantity|
+------+--------+
|Apples|5 |
+------+--------+
|Melons|2 |
+------+--------+

以下の操作で元に戻せます。
table-release
''table-insert-row'', ''table-span-cell'', ''table-widen-cell''　といったような、たくさんの便利な ''table-*'' 関数があります。

最後に、''table'' 関数の究極の目的は、指定されたマークアップ言語に変換することです。
それには、''table-generate-source'' が使われます。
LaTeX に対しては、前のテーブルは、以下の結果となります。

% This LaTeX table template is generated by emacs 24.2.1
\begin{tabular}{|l|l|}
\hline
Fruits & Quantity \\
\hline
Apples & 5 \\
\hline
Melons & 2 \\
\hline
\end{tabular}

table mode を使用することで、行ごとおよび列ごとの和といった、スプレッドシートの作業を行うこともできます。しかし、すぐに機能が限定的であると分かるでしょう。その上、非常に遅いです。より多くの強力な可能性については、[[#予定表、スプレッドシート、文章作成|org-mode]] を見てください。

=== 予定表、スプレッドシート、文章作成 ===

有名でパワフルな [http://orgmode.org/ Org mode] のおかげで、Emacs はパワフルなオフィス系機能をおすすめできます。このモードは、標準の Emacs ディストリビューションに含まれます。

Org mode は元々強力な TODO およびアジェンダのエージェントですが、すぐにはるかに幅広い機能セットに進化しました。
Org mode は単純に機能が多すぎて、すべての機能をざっと見ることすらできません。そのため、私たちはいくつかの例であなたの欲求を刺激するに留めます。

TODO.org ファイルを新規ファイルとして開きます。Org mode がロードされるはずです。もしロードされなければ、'''M-x org-mode''' によって有効にできます。
{{hc|TODO.org|
* First entry
** Subentry
Some comments
*** Subsubentry
* Second entry
- List item 1
- List item 2
}}

ここで、いくつかの有用なキーバインドは以下となります：
* '''TAB''' 現在のエントリーの折りたたみ・展開を切り替えます。
* '''S-TAB''' すべてのエントリーの折りたたみ・展開を切り替えます。
* '''M-RET''' 現在の項目と同じレベルに新しい項目を開始します。
* '''M-<left>''' および '''M-<right>''' レベルを変更します。
* '''M-<up>''' およｂ '''M-<down>''' すべてのサブセクションを含めて項目を移動します。
* '''S-<left>''' および '''S-<right>''' ステータスを変化させます。リストアイテムでは、項目のスタイルを変更します。
* '''S-<up>''' および '''S-<down>''' 優先度を変更します。
* '''C-c ^''' 現在のエントリーのすべてのサブエントリーをソートします。
* '''C-c .''' 現在のエントリーにタイムスタンプを追加します。{{ic|Shift}} と矢印を使って、数日や数週をスキップできます。カレンダーでマウスを使ったり、特定の日で {{ic|Enter}} を押したりして、それらを選択できます。

スプレッドシート機能は、非常に包括的です。マニュアルから抜粋してみましょう：

{{bc|<nowiki>

最後に、素晴らしい `calc.el 'パッケージでできることについて欲求を
刺激するために、いくつかの関数に対する位置 `x' で次数 `n'のテイラー級数を
計算する表を示します。

|---+-------------+---+-----+--------------------------------------|
| | 関数 | n | x | 結果 |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x) | 1 | x | 1 + x |
| # | exp(x) | 2 | x | 1 + x + x^2 / 2 |
| # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 |
| * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3
</nowiki>}}
Org mode は、行においてパイプ '''|''' がホワイトスペース以外の最初の文字のとき、テーブルと認識します。前のテキストでは、線を描きませんでした。セル内の内容、または '''|-''' のあとに '''TAB''' が押されたとき、線が自動的に描かれています。結果列も手動では記述しておらず、最後の行の calc 式から計算されています。'''C-u C-c C-c''' を使うことで、テーブル内のすべての値を再計算することができます。

TODO ファイルと同様に、行と列を操作するキーバインディングがあります。{{ic|Alt}} + 矢印キーで、列と行を移動することができます。

より深く詳細を知るには、公式マニュアルを参照してください: '''C-h i m Org mode RET'''。

=== リファクタリングとスマート補完 ===

(Eclipse などの) IDE が大抵備えているプログラミング機能が必要な場合、[http://cedet.sourceforge.net/semantic.shtml Semantic] ツールが役に立ちます。Semantic は Emacs の標準ディストリビューションに含まれています。現在 C, C++, Scheme, Javascript, Java, HTML, Make がサポートされています。現在のサポート状況は [http://cedet.sourceforge.net/languagesupport.shtml CEDET のページ] で確認できます。

Semantic がサポートする好みのプログラミング言語で書かれたファイルを開きます。そして Semantic マイナーモードを起動します。
M-x semantic-mode

Semantic は、あなたのファイルに含まれるライブラリ (たとえば C では、ほとんどの場合、標準ライブラリ) を2,3秒パースします。

==== 機能 ====

一旦完了すると、素晴らしい Semantic の機能が使えます。
;スマート補完
'''C-c , SPC''' を押すことで、ポイントにあるシンボルを補完することができます。それが引数の場合、型が正しいかチェックされます。

;シンボルにジャンプする
'''C-c , j''' を押すことでシンボルを入力するプロンプトを表示し、その定義元にジャンプします。'''TAB''' で自動補完ができます。文字 '''J''' を押すと、シンボルを複数ファイルに渡って探索します。

;シンボルの呼び出しをリスト表示する
'''C-c , g''' を押すことでシンボルを入力するプロンプトを表示し、参照されている場所のリストを表示します。'''n''' と '''p''' を押すことで結果表示を巡回できます。'''RET''' を押すことで詳細をトグルし、参照箇所で再度 '''RET''' を押すことで参照元にジャンプします。'''G''' を押すことで、入力したシンボルの場所を複数ファイルに対してリスト表示します。

;リファクタリング
最初に前述のコマンドでリファクタリングしたいシンボルの使用先をリスト化します。'''(''' を押すと、シンボルに対するマクロ定義を開始します。これは実際、リファクタリングに比べてより非常に強力です。なぜなら、シンボルに任意の関数を適用したり、周囲のシンボルに作用することさえしたりできます。'''C-x )''' を押すことで、マクロ定義を終了し、'''E''' キーにて実行します。

;シンボルの説明
以下の関数を呼び出すことで、シンボルの詳細を表示します。
semantic-ia-show-summary
これは複雑なデータ構造とプロトタイプに対して非常に有用です。デフォルトではキーバインドがありません。

==== 設定 ====

以下に、サポートされているすべてのプログラミング言語で Semantic を使用するためのサンプル設定を示します。キーバインディングのと表示設定の例です。

;; ghost 表示での Semantic (M-n と M-p で完了をブラウズできます)
(semantic-mode 1)
(define-key my-keys-minor-mode-map (kbd "C-c , d") 'semantic-ia-show-summary)
(setq semantic-complete-inline-analyzer-displayor-class 'semantic-displayor-ghost)

特定の言語に対して特化した設定を追加することもできます。ここでは C のために：
(add-hook
'c-mode-hook
(lambda ()
(local-set-key (kbd "M-TAB") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)))

==== 文献 ====

Emacs から直接 info マニュアルにアクセスすることが可能です: '''C-h i m Semantic RET'''。

=== Emacs を git のマージツールとして使う ===

デフォルトでは、git はマージツールとして Emacs の Emerge モードをサポートしています。しかしながら、Ediff モードの方をより好むかもしれません。不幸にも、このモードは技術的な理由により git によってサポートされていません。Ediff モードを使用する方法はまだあります。emacs call 上で以下の elisp コードを評価します。

{{hc|.gitconfig|<nowiki>
[mergetool.ediff]
cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

[merge]
tool = ediff
</nowiki>}}

コマンドは1行で書かれなければならない点に注意してください。
上の例では、Emacs を新たに起動します。より早く起動するために emacsclient を使いたいかもしれませんが、推奨されていません。なぜなら Ediff 呼び出しは実際にはクリーンではないためで、現在の Emacs セッションを混乱させる可能性があります。

'''-q''' オプションを使用して、即席で起動することができます。設定の一部を残したまま Emacs を素早く起動するには、Emacs を以下のように呼び出します。
emacs -q -l ~/.emacs-light
ここで、Ediff のために必要なことのみを記した軽量な設定ファイルがロードされます。

このトリックおよび Ediff の問題点についての詳細は、[http://kerneltrap.org/mailarchive/git/2007/7/1/250424 kerneltrap.org] および [https://stackoverflow.com/questions/1817370/using-ediff-as-git-mergetool stackoverflow] を参照してください。

=== Caps Lock キーを Control キーとして使う ===
いわゆる 'emacs 小指' にならないようにこちらの挙動を好むユーザーもいます。X で試用してみたいときは、次を実行:
$ setxkbmap -option 'ctrl:nocaps'

また、キーを'''交換'''するには、次を実行:
$ setxkbmap -option 'ctrl:swapcaps'

永続的に設定したくなったら、{{ic|.xinitrc}} ファイルに上のコマンドを追加してください。

リージョンを小文字から大文字にする必要がある場合は、デフォルトの {{ic|C-x C-u}} キーバインディングを使って下さい、{{ic|upcase-region}} 関数が呼び出されます。

Caps Lock がない場合は、両方の "Shift" にマッピングしてください:
$ setxkbmap -option "shift:both_capslock"

一部のデスクトップ環境にはキーボードのマッピングを変更するためのグラフィカルなツールが含まれています。例えば [[Plasma|Plasma 5]] ならシステム設定を開いて入力デバイスをクリックしてください。キーボードを選択して高度な設定タブから Caps Lock を Ctrl として使用するように設定できます。

== パッケージ ==

Emacs の機能はサードパーティ製のパッケージで拡張できます。公式にサポートされているパッケージマネージャとして {{ic|package.el}} が組み込まれていますが、Emacs のコミュニティメンバーによって書かれたパッケージマネージャが他にも存在します。{{ic|package.el}} は {{ic|package-archives}} 変数を使ってパッケージを検索します。デフォルトでは [https://elpa.gnu.org/ Emacs Lisp Package Archive (ELPA)] が含まれています。{{ic|M-x list-packages}} で Emacs が認識している全てのパッケージが列挙されたバッファが作成されます。マニュアル ({{ic|[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html (info "(emacs) Packages")]}}) にはさらに詳しい情報が載っています。

サードパーティ製のパッケージのアーカイブを追加することもできます。[https://melpa.org/ MELPA] が広く使われています。

人気の拡張の多くは {{ic|[community]}} リポジトリのパッケージや [[AUR]] からインストールできます。大抵の場合、パッケージの名前の前に 'emacs-' が付きますが (例: {{Pkg|emacs-lua-mode}})、常にそうなっているわけではありません (例: {{AUR|auctex}})。

{{Tip|Arch Linux の Wiki を編集している場合は [[Emacs Mediawiki]] パッケージが役に立ちます。}}

パッケージによっては設定ファイルに変更を加えないと機能が有効にならない場合があります。例えば、{{AUR|auctex}} をインストールしたときは、設定ファイルに以下を追加:

{{bc|
(load "auctex.el" nil t t)
(load "preview-latex.el" nil t t)}}

パッケージのソースコードや README で有効化する方法が書かれているはずです。

== トラブルシューティング ==

=== Emacs が 'Undefined color: "WINDOW_FOREGROUND"' というエラーメッセージで起動しない ===

{{Pkg|mcpp}} パッケージまたは {{Pkg|gcc}} パッケージをインストールする必要があります。''xrdb'' は [[X resources]] を前処理するために C のプリプロセッサ ''cpp'' を使用します。C のプリプロセッサがインストールされていない場合、''xrdb'' は C のプリプロセッサを実行しないため WINDOW_FOREGROUND が16進数のカラーコードに展開されません。

=== カラー出力の問題 ===

デフォルトでは、Emacs シェルはカラー表示に使われるエスケープシーケンスをそのまま表示してしまいます。つまり、カラー出力がされるべきところに変な記号が表示されます。

この問題を解決するには以下を {{ic|~/.emacs}} に記述してください:
(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

=== X ウィンドウでの文字の表示問題 ===

X ウィンドウで emacs を起動した時にメインウィンドウの文字が全て黒縁の白四角になってしまう場合 (対応するフォントがインストールされていない文字を表示したときと同じような記号)、{{Pkg|xorg-fonts-75dpi}} や {{Pkg|xorg-fonts-100dpi}} をインストールして X ウィンドウを再起動してください。

=== 起動が遅い ===

{{Tip|[[#systemd ユニットとして|systemd ユニットとして]] Emacs を起動する方法でも起動時間を短縮できます。}}

しばしば起動時間が遅くなる原因は2つあります。

どちらが原因なのか調べるために、次のコマンドで Emacs を実行してください:

$ emacs -q

このコマンドでも Emacs の起動が遅い場合、[[#不適切なネットワーク設定|不適切なネットワーク設定]]を参照してください。そうでない場合は、ほぼ確実に .emacs に問題があります。

* {{ic|/etc/hosts}} の設定が間違っていると、Emacs の起動が5秒以上遅くなることになります。詳しくはネットワーク設定ガイドの '[[ネットワーク設定#ホストネームの設定|ホストネームの設定]]' を見てください。

* A simple way to search for the cause is to comment-out (i.e., prefix lines with ';') suspect sections of your {{ic|~/.emacs}} (or {{ic|~/.emacs.d/init.el}}) then start Emacs again to see if there's any change. Keep in mind use of "require" and "load" can slow the startup down, especially when used with larger extensions. They should, as a rule, only be used when their target is either: needed once Emacs starts or provides little more than "autoloads" for an extension. Otherwise, use the 'autoload function directly. For example, instead of:

(require 'anything)

you might use:

(autoload 'anything "anything" "Select anything" t)

=== Cannot open load file: ... ===

The most common cause of this error is the 'load-path' variable not including the path to the directory within which the extension is located. To solve this, add the appropriate path to the list to be searched prior to attempting to load the extension:

(add-to-list 'load-path "/path/to/directory/")

When attempting to use packages for extensions and Emacs has been configured with a prefix other than '/usr', the load-path will need to be updated. Place the following in {{ic|~/.emacs}} prior to the instructions provided by the package:

(add-to-list 'load-path "/usr/share/emacs/site-lisp")

If compiling Emacs by hand, keep in mind that the default prefix is '/usr/local'.

=== デッドアクセントキーの問題: '<dead-acute> is undefined' ===

このバグについて Google で検索すると、次のリンクが見つかります:
https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

Explaining the problem: in recent versions of
b72
Emacs, the normal way to use accent keys doesn't work as expected. Trying to accent a word like 'fiancé' will produce the message above.

A way to solve it is just put the line above on your startup file, {{ic|~/.emacs}}:

(require 'iso-transl)

And no, it isn't a bug, but a feature of new Emacs versions. Reading the subsequent messages about it on the mail list, we found it (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html):

:''It seems that nothing is loaded automatically because there is a choice betwee iso-transl and iso-acc. Both seem to provide an input method with C-x 8 or Alt-<accent> prefix, but what you and I are doing is just pressing a dead key (^, ´, `, ~, ¨) for the accent and then another key to "compose" the accented character. And there is no Alt key used in this! And according to documentation it seems be appropriate for 8-bit encodings, so it should be pretty useless in UTF-8. I reported this bug when it was introduced, but the bug seems to be classified as a feature ... Maybe it's just because the file is auto-loaded though pretty useless. ''

=== C-M-% やその他のバインディングが emacs nox で動作しない ===

これはターミナルが Xorg よりも制限的であることが原因です。ただし、ターミナルによっては多くのバインディングを扱うことができることがあります。2つの解決法が考えられます:
* グラフィカルバージョンを使用する。
* サポートされているバインディングに変更する。

例:
{{hc|.emacs|
(global-set-key (kbd "C-M-y") 'query-replace-regexp)
}}

=== Emacs がフリーズする ===

シングルスレッドであるがゆえに、Emacs は様々な操作でブロックします。フリーズが発生する状況は様々です。例えば、Emacs はあなたからの入力を待っているのかもしれません (例えばあるフレームでミニバッファを開いているのに他のフレームで作業しようとしている場合など)。あるいは、Emacs は完了するまで時間のかかるコードを実行中なのかもしれません。あるいはバグを踏んだという可能性もあります。Emacs プロセスを殺さずに Emacs のブロックを解除する方法は複数存在します。

* {{ic|C-g}} を押してみる。Emacs が行っていることによっては、複数回押す必要があります。
* {{ic|ESC ESC ESC}} を押してみる。
* 他のターミナルで {{ic|killall -SIGUSR2 emacs}} を実行する。

=== Emacs-nox の出力が汚い ===

When working in a terminal, the color, indentation, or anything related to the output might become crazy. This is (probably?) because Emacs was sent a special character at some point which may conflict with the current terminal.
If this happens you can do {{ic|M-x redraw-display}}, which will redraw the terminal's display. If this problem happens frequently, you might want to bind the command to a key, e.g. by putting something like
(global-set-key (kbd "<f7>") 'redraw-display)
in your .emacs file.

Graphical Emacs does not suffer from this issue.

=== emacs ターミナルにおかしなエスケープ数字 (utf-8) が表示される ===

{{ic|.bashrc}} または {{ic|.zshrc}} で以下の変数をエクスポートしてください:

{{hc|1=~/.bashrc|2=
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export TERM=xterm-256color
}}

小文字の utf を使っていることがエラーの原因です (例: en_US.utf-8)。

利用可能なロケールは {{ic|locale -a}} で確認できます。

=== tmux で emacs を使っているときに Shift + 矢印キーが動作しない ===

まず [[tmux]] の設定で xterm-keys を有効にしてください:
{{hc|.tmux.conf|
setw -g xterm-keys on
}}

しかしながら、この設定は他のキーコンビネーションを破壊します。それを修正するために、以下を emacs の設定に記述します:
{{hc|~/.emacs|
(defadvice terminal-init-screen
;; The advice is named `tmux', and is run before `terminal-init-screen' runs.
(before tmux activate)
;; Docstring. This describes the advice and is made available inside emacs;
;; for example when doing C-h f terminal-init-screen RET
"Apply xterm keymap, allowing use of keys passed through tmux."
;; This is the elisp code that is run before `terminal-init-screen'.
(if (getenv "TMUX")
(let ((map (copy-keymap xterm-function-map)))
(set-keymap-parent map (keymap-parent input-decode-map))
(set-keymap-parent input-decode-map map))))
}}

詳しくは [https://github.com/tmux/tmux/blob/master/FAQ#L242 tmux FAQ] を参照。

=== KDE でウィンドウのリサイズがおかしい ===
KDE ユーザーには Emacs のウィンドウが正しくリサイズされないという現象がおこることがあります。リサイズした部分が透過されマウスでクリックしても下のウィンドウがクリックされます。この挙動を修正するには、KDE の GTK3 テーマを oxygen-gtk 以外のテーマに変更してください。例えば、{{Pkg|gtk3}} に含まれている Emacs テーマを使って下さい。

KDE で Emacs を完全に最大化するには、タイトルバーの Emacs アイコンをクリックして、More Actions > Special Window Settings を選択してください。そして "Size & Position" タブで "Obey geometry restrictions" を選択して、ドロップダウンメニューで "Force" を選んで右のラジオボタンで "No" を選んで下さい。

== 派生 ==

Emacs の実装は多数存在します。おそらく GNU/Emacs が一番ポピュラーです。

軽量な Emacs 互換のテキストエディタは Arch のリポジトリや [[AUR]] にあります。

=== mg ===

mg (旧名 MicroGnuEmacs) は C で書かれた軽量な Emacs の実装です。

{{Pkg|mg}} パッケージから入手できますが、上流の [http://homepage.boetes.org/software/mg/ ページ] からソースをダウンロードすることも可能です。mg は UTF-8 をサポートしていません。

=== zile ===

公式ウェブ[https://www.gnu.org/software/zile/ ページ]によると "GNU Zile は軽量な Emacs クローンです。Zile は Zile Is Lossy Emacs の略となっています。Zile は出来る限り Emacs に近づくように書かれており、きっと全ての Emacs ユーザーの手に馴染むでしょう"。Zile は UTF-8 をサポートしていません。

{{Pkg|zile}} パッケージからインストールできます。

最新の tarball は公式の GNU [http://ftp.sh.cvut.cz/MIRRORS/gnu/pub/gnu/zile/ ミラー] から落とせます。

=== uemacs ===

Linus Torvalds によるカスタム版 Micro-emacs。{{AUR|uemacs-git}} でインストール可能。

最新 (2005) の tarball は [ftp://ftp.cs.helsinki.fi/pub/Software/Local/uEmacs-PK/ こちら] にあります。

=== remacs ===

'''remacs''' はコミュニティによる Emacs の Rust 移植です。{{AUR|remacs-git}} パッケージでインストールできます。

== 参照 ==

* [https://www.gnu.org/software/emacs/ GNU Emacs ホームページ]
* [https://www.gnu.org/software/emacs/manual/emacs.html GNU Emacs マニュアル]
* [http://www.emacswiki.org/cgi-bin/wiki/ Emacs Wiki]
* [http://wikemacs.org WikEmacs - 読みやすいが不完全な Emacs wiki]
* [http://www2.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html Emacs とそのショートカットの有用な紹介]
* [https://d0edfcdc0ccc1cd13cdab5eb986fb92e8660dbef.googledrive.com/host/0B6LMD0u8OhYYZEotN2QyR1hwR1k/ Emacs 教会 (Google ドライブ)]
* [https://www.gnu.org/software/emacs/refcards/pdf/refcard.pdf 公式リファレンスカード]
* [[EXWM]] - Emacs X Window Manager

Emacs

2021-11-24T12:56:14Z

がおびん: /* カスタマイズ */ 英語の記述を日本語に翻訳した。

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[Category:GNU]]
[[de:Emacs]]
[[en:Emacs]]
[[es:Emacs]]
[[fr:Emacs]]
[[sr:Emacs]]
[[zh-hans:Emacs]]
[[Wikipedia:ja:Emacs|Emacs]] は拡張性があり、カスタマイズ可能な、セルフドキュメント方式のリアルタイム表示エディタです。Emacs のコアには、多数の Emacs の内蔵機能や拡張を実装するのに使われている言語である、[[Wikipedia:ja:Emacs Lisp|Emacs Lisp]] のインタプリタが存在します。GNU Emacs 22 から GTK がデフォルトの X ツールキットとして使われていますが、CLI 環境でも負けず劣らずに機能します。

== インストール ==

Emacs には複数の種類があります (時々 ''emacsen'' と呼ばれます)。その中で最も一般的なのは [https://www.gnu.org/software/emacs/ GNU Emacs] です。

{{Pkg|emacs}} パッケージを[[インストール]]してください。いつもターミナルで作業をする場合は、GTK+ がいらない {{Pkg|emacs-nox}} の方が良いでしょう (サウンドなどの装飾的な機能もありません)。
ただしテキストバージョンにはいくつか欠点が存在します: サポートしている色やフォント処理の機能 (実行中にサイズを変更したり、単一の文章で複数のサイズを使うなど) が少なくなっています。その上、emacs-nox には Speedbar や GUD (デバッグ環境) などの高度な機能について制限があり、複雑なフェイスを使おうとするとやや遅くなります ("フェイス"とは Emacs におけるテキストの外観のことです)。

== Emacs の実行 ==

emacs を起動する前に、終了の方法を知っておきましょう (特にターミナルで実行する場合): {{ic|Ctrl+x}}{{ic|Ctrl+c}} キーシーケンスを使って下さい。

Emacs を起動するには次を実行:

$ emacs

また、コンソールから使うには:

$ emacs -nw

(.emacs を使わずに) 高速でロードして CLI で編集するには:

$ emacs -Q -nw

nox バージョンをインストールしている場合、'emacs' と 'emacs -nw' は同じになります。

ファイル名を指定することですぐにファイルを開くこともできます:

$ emacs filename.txt

=== 色無し ===

デフォルトでは、Emacs はハイパーリンクが濃青で表示されるカラーテーマで起動します。Emacs をカラーテーマやスキームを使わずに起動するには:

$ emacs -nw --color=no

このコマンドでは全てのテキストがターミナルの前景色だけで表示されます。通常は黒背景に白字か、白背景に黒字となります。

=== デーモンとして ===

毎回 {{ic|.emacs}} ファイルをロードするため Emacs を起動するときには時間が多少かかります。また、別のインスタンスから同じファイルにアクセスしたいと思うときもあるかもしれません。バージョン23から、Emacs はユーザーが接続できるデーモンとして起動することが可能になっています。Emacs をデーモンとして実行するには:

$ emacs --daemon

起動時にデーモンを実行してウィンドウをデーモンに接続すると良いでしょう。さらに、グラフィカル・コンソールクライアント''両方を''同意時にデーモンに接続して GUI を素早く起動することも可能です。

デーモンに接続したいときは場合は次のコマンドを使って下さい (グラフィカル環境から実行したときはグラフィカルクライアントが、tty などのコンソールから実行したときはコンソールクライアントが起動します):

$ emacsclient

グラフィカル環境にいるときもコンソールクライアントを使いたい場合は次のコマンドを使って下さい:

$ emacsclient -t

さらに、{{ic|-a ""}} パラメータを追加することもできます。
これで、最初にコマンドを実行したときは、デーモンとして emacs が起動します。バックグラウンドで動き続けるので後で呼び出した時に起動時間が早くなります (バッファも残り続けます)。

ターミナルや他のプログラムからクライアントを起動した場合、呼び出すプログラムを使うことで Emacs クライアントを閉じなくてもクライアントを使い続けることができます。そのためには、 {{ic|-n}} ({{ic|--no-wait}}) パラメータを使ってクライアントを起動します:
$ emacsclient -nc

Mutt や Git などのプログラムは (コミットメッセージを読むための) エディタが終了するまで待機するため、{{ic|-n}} パラメータを使うことはできません。デフォルトエディタが設定されている場合、他のエディタを指定する必要があるかもしれません (例: {{ic|emacsclient -a "" -t}})。

以下のシェル設定が利用できます:

{{bc|1=
alias emt='emacsclient -nc -a ""'
alias emc='emacsclient -t -a ""'
EDITOR='emacsclient -a ""'
}}
ただしこれには注意事項があります: コマンドのスペースの関係で多数のプログラムが外部エディタをロードすることはできません。

スクリプトを書くほうがもっと使い勝手が良く信頼性があります:
{{hc|/usr/local/bin/emc|<nowiki>
#!/bin/sh
if [ -z "$DISPLAY" ]; then
IS_GRAPHICAL=true
else
IS_GRAPHICAL=$(emacs --batch -Q --eval='(if (fboundp '"'"'tool-bar-mode) (message "true") (message "false"))' 2>&1)
fi

if $IS_GRAPHICAL; then
emacsclient -a "" -nc "$@"
else
emacsclient -a "" -t "$@"
fi
</nowiki>}}
スクリプトは実行可能属性を付けて下さい:
# chmod 755 /usr/local/bin/emc

これで 'emc' が期待通りに動作するようになります。このクライアントをデフォルトのエディタにしたいときは上記のスクリプトで {{ic|EDITOR}} 環境変数を設定すれば OK です。

=== systemd ユニットとして ===

Emacs 26.1 から systemd ユニットが含まれています。Emacs のインストール後に以下のように有効化してください:

$ systemctl --user enable --now emacs

Emacs サーバーを実行したいユーザーで上記のコマンドを実行してください。サービスの起動後、Emacs の準備ができます。ユニットファイルは {{ic|/usr/lib/systemd/user/emacs.service}} に存在します。ユニットファイルの中身は以下のようになっています:

{{hc|/usr/lib/systemd/user/emacs.service|<nowiki>
[Unit]
Description=Emacs text editor
Documentation=info:emacs man:emacs(1) https://gnu.org/software/emacs/

[Service]
Type=simple
ExecStart=/usr/bin/emacs --fg-daemon
ExecStop=/usr/bin/emacsclient --eval "(kill-emacs)"
Environment=SSH_AUTH_SOCK=%t/keyring/ssh
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

systemd のユーザーユニットはログインシェル ({{ic|~/.bash_profile}} など) から環境変数を継承しないため、{{ic|~/.pam_environment}} に変数を設定すると良いでしょう。詳しくは [[Systemd/ユーザー]]を参照。

emacs をデーモンとして起動する場合、{{ic|VISUAL}} と {{ic|EDITOR}} 環境変数を {{ic|emacsclient}} に設定することでプログラムからエディタを起動するときにエディタの新しいインスタンスを起動するかわりに emacsclient が使われるようになります。外部エディタを使用するプログラムとしてメールプログラム (メッセージを編集するため) や Git (コミットメッセージを編集するため)、less ({{ic|v}} コマンドで表示されたファイルを編集するため) などが存在します。emacsclient の {{ic|-n}} ({{ic|--nowait}}) オプションは使用しないでください。基本的にプログラムはエディタが終了したときに編集が完了したと認識するためです。

GUI の Emacs のスタートメニューエントリなども emacs ではなく emacsclient が使われるように変更することを推奨します。

== クイックスタート ==

Emacs は複雑ですが、そのカスタマイズと拡張性のレベルによってもたらされる利益を理解し始めるのにそう時間はかからないでしょう。さらに、幅広い拡張を利用することで Emacs はあらゆる種類の文章編集のための強力な環境に姿を変えることができます。

Emacs には素晴らしいチュートリアルが内蔵されており、スプラッシュ画面の最初のリンクをクリックしてアクセスできます。メニューから ''Help->Emacs Tutorial'' を選択するか 'F1' の後に 't' を押して下さい。このページは Emacs を始めるのに追加的なリソースになるように書かれています。

初心者にもエキスパートにも役立つ、リファレンスカードのセットも Emacs に含まれています、{{ic|/usr/share/emacs/<version>/etc/refcards/}} を見て下さい (<version> はあなたの emacs のバージョンに置き換えて下さい)。

=== 基本的な用語と慣習 ===

始めは慣れないと思うかもしれませんが Emacs にはいくつか特別な用語法と約束事があり、必要に応じて紹介していきます。ただ、Emacs を使うにあたって当然知ってるべきとされるような、基本的な用語についてはあらかじめ説明しておいたほうが良いでしょう。

真っ先に知るべきは''バッファ''の概念です。バッファは Emacs の中のデータを表します。例えば、Emacs でファイルを開いたとき、ディスクからファイルから読み込まれてバッファに中身が保存され、バッファを編集して後でディスクに上書き保存することができます。バッファはテキストに限られず、画像やウィジェットなども含めます。作業中でもバッファでアプリケーションを表示することすらできます。こういう考え方もできます: ディスク上のデータは'ファイル'であり、一方、Emacs 上のデータは'バッファ'である。

Emacs におけるキーシーケンスの決まり事も見慣れないかもしれません。即ち:

'''C-x''' は Control-x を示します

'''M-x''' は Meta-x を示します

{{Note|'Meta' は多くの場合 Alt キーに相当します。また、Esc キーを使うことも可能です。}}

例えば、Emacs を終了するには次のキーシーケンスを使います: '''C-x C-c'''。これは "Control を押しながら 'x' を押す。手を離す。Control を押しながら 'c' を押す" と読み替えることができます。Emacs にはメニューバーが存在しますが、キーシーケンスを使いこなせるように練習することを推奨します。以下から、Emacs で使われるキーバインディングと慣習について説明します。

=== 移動 ===

カーソルの移動は他のグラフィカルエディタとよく似ています。マウスや方向キーを使ってカーソルの位置 (Emacs では''ポイント''と呼ばれます) を変更することができます。一般的な移動コマンドは方向キーで出来ますが、Emacs には他にも便利なバインディングが存在します。1文字先に移動するには '''C-f''' を使用して、1文字前に移動するには '''C-b''' を使用します。'''C-n''' と '''C-p''' でそれぞれ次の行と前の行に移動できます。基本的に、マウスや方向キーを使うよりもこれらのキーシーケンスを使うことが推奨されています。

当然、Emacs には、単語や文単位で移動できる、もっと高度な移動コマンドが用意されています。'''M-f''' は1単語先に移動して '''M-b''' は1単語前にポイント移動します。同じく、'''M-e''' は1文先にポイント移動して '''M-a''' は前に戻ります。

ここまでは、紹介した全ての移動コマンドはポイントに関連しています。'''M-<''' を使うことでバッファの最初にポイントを移動することができ、逆に、'''M->''' はバッファの最後に移動します。特定の行番号にポイントを移動するには、'''M-g g''' を使います。'''M-g g''' は移動したい行番号を尋ねます。また、現在の行の先頭と末尾に移動するには、'''C-a''' あるいは '''C-e''' を使って下さい。

{{Note|上記のコマンドを含む全てのコマンドのキーバインドは、現在有効になっているモードによって''多少''ながら変わってくる可能性があります。しかしながら、同一の機能を実行するのにコマンドを置き換えることはあまりありません。詳しくは[[#モード|モード]]を見て下さい。}}

=== ファイルとバッファ ===

Emacs にはファイルを操作するためのコマンドが用意されています。このセクションでは最もよく使われるコマンドを紹介します。ファイルを開くには '''C-x C-f''' を使います (Emacs ではこのコマンドを 'find-file' と呼びます)。指定されたファイルが存在しなかった場合、Emacs は空のバッファを開きます。バッファを保存するとバッファの中身が入ったファイルが作成されます。'''C-x C-s''' を使うことでバッファを保存できます。別のファイル名でバッファを保存するには、'''C-x C-w''' を使って下さい (this is a mnemonic for the command 'write-file')。新しいファイル名が尋ねられ、ディスクにファイルが書き込まれます。'''C-x s''' で全てのバッファを保存することも可能です。最後に保存されていた状態からバッファに変更が加えられている場合、保存を実行するかどうか訊くプロンプトが表示されます。

{{Note|ファイルに対応するバッファが既に開かれている場合 '''C-x C-f''' はディスクからファイルを読み込みません。ディスクからファイルを再度読み込むには、(1) まずバッファを閉じて ('''C-x k''')、それからファイルを開くか ('''C-x C-f''') あるいは (2) '''M-x revert-buffer''' を使ってディスク上のデータに戻して下さい。それか (3) '''C-x C-v''' でファイルを現在のバッファにロードするか (4) '''C-x RET r RET''' で同一コードでファイルを再読み込みしてください。}}

"find-file" や "write-file" などのインタラクティブなコマンドでは Emacs ウィンドウの一番下の行に入力が求められます。この行のことは''ミニバッファ''と呼びます。ミニバッファでは基本的な編集コマンドを使うことができ、多くの *nix シェルで利用できるのと同じようなタブ補完機能があります。'''<TAB>''' を2回連続で押すと補完リストが表示され、マウスを使ってリストから補完候補を選択することも可能です。ミニバッファでの補完はコマンドやファイル名など様々な形で使えます。

ミニバッファには履歴機能も存在します。前に入力したコマンドは '''Up Arrow''' または '''M-p''' を使うことで再呼び出しできます。

ミニバッファは '''C-g''' を押すことでいつでも終了できます。

ファイルを複数開いたら、ファイルを切り替える手段が必要です。Emacs 内に既に存在するバッファにファイルを開くと、Emacs はそのバッファに切り替えます。しかしながらこれは効率的とは言えません。Emacs には表示するバッファを選択する '''C-x b''' が存在します (タブ補完が使えます)。存在しないバッファの名前を入力すると、その名前で新しいバッファが作成されます。

{{Note|前のバッファに切り替えるには '''C-x b <RET>''' を使います。前のバッファがデフォルトだからです。}}

全てのバッファのリストを '''C-x C-b''' で表示することができます。バッファが必要なくなったときは '''C-x k''' で削除することが可能です。

=== 編集 ===

Emacs には多数の編集コマンドが存在します。まだ紹介していない最も重要なコマンドはおそらく 'undo' でしょう。'''C-_''' または '''C-/''' で実行することができます。基本的に移動コマンドには対応する削除コマンドが存在します。例えば '''M-<backspace>''' で後方の単語を削除することができ、{{ic|M-d}} で前方の単語を削除できます。行末または文章の終わりまで削除するにはそれぞれ {{ic|C-k}} または {{ic|M-k}} を使います。

1行は80文字を超えていはいけないという経験則が存在します。1行の長さを長くしすぎないことで、特にウィンドウの縁で改行してしまうような場合に、可読性を維持することができます。改行の自動挿入 (または削除) は Emacs では詰め込み (''filling'') と呼ばれます。{{ic|M-q}} を使うことでパラグラフを折り返させることができます。

文字列と単語はそれぞれ {{ic|C-t}} と {{ic|M-t}} で置き換えることが可能です。例えば {{ic|Hello World!}} を {{ic|World! Hello}} と置き換えられます。

単語の大文字小文字はすぐに修正できます。{{ic|M-l}} は単語を小文字に変換し ({{ic|HELLO}} は {{ic|hello}})、{{ic|M-u}} は単語を大文字に変換します ({{ic|hello}} は {{ic|HELLO}})。そして {{ic|M-c}} は単語の最初の文字を大文字にして他の文字は小文字にします ({{ic|hElLo}} は {{ic|Hello}})。

=== kill と yank とリージョン ===

リージョンとは、2点間にあるテキストです。2点のうちの1つは、''マーク'' と呼ばれ、もう1つはポイントです。 '''C-<SPC>''' によってマークの位置がセットされ、その後でポイントが移動することでリージョンが作られます。GNU Emacs 23.1 以降、リージョンはデフォルトで可視化されます。リージョン上で動作する多くのコマンドがあり、もっともよく使われるコマンドに ''killing'' コマンドがあります。

Emacs では、カット＆ペーストはそれぞれ、''kill'' と ''yank'' と呼ばれます。1文字以上の文字を削除するコマンド（ '''C-k''' や '''M-d''' といった上で記述したコマンドも含めて）は、実際にテキストをカットし、''kill-ring'' として知られるものに追加します。kill-ring は、単に kill されたテキストのリストです。kill-ring は、デフォルトでは直近60個の kill されたテキストを保存します。kill に成功すると、リストの先頭に接続されて保存されます。

'''C-w''' と '''M-w''' によって、それぞれリージョンの kill とコピーができます。

kill されたテキストをバッファに挿入する（'yanking' として知られます）ためには、'''C-y''' を使います。 '''C-y''' は、複数回使用することで、繰り返しテキストを yank できます。前述の通り、以前の kill は、リストに保存されます。しかし、'''C-y''' は、そのうち最初のものしか取得しません。それより前の kill は、'''M-y''' によってアクセスすることができます。これによって、'yank' で挿入されたテキストをリストの先頭に移動させます。 '''M-y''' は '''C-y''' に続けて使われなければならず、kill-ring をたどるために何度でも使えます。

=== 検索と置換 ===

文字列を検索することは、テキストの編集において一般的な作業です。検索は、'''C-s''' (後方検索) または '''C-r''' (前方検索) によって実行されます。これらのコマンドは、検索する文字列を入力するプロンプトを表示します。検索は1文字入力するごとに実行され、タイプごとに次に（あるいは前に）一致した文字列にマッチします。次の検索結果に行くには C-s を、前の検索結果に行くには C-r を押します。もし探しているものが見つかったのであれば、'''<RET>''' を押すことで検索を終了できます。一方、検索を開始した場所に戻りたければ '''C-g ''' を押します。

いったん検索が完了すると (たとえば '''C-g''' 等で中断していない場合)、検索された文字列は、次の検索のデフォルト検索文字となります。検索された文字を使用するには、後方検索なら '''C-s C-s''' , 前方検索なら '''C-r C-r''' をそれぞれ押します。

I-search には、いくつかの有用なコマンドがあります。 '''M-e''' によって、検索文字列の編集が可能です。 '''M-c''' によって、大文字小文字を区別するか、しないかを切り替えることができます。

正規表現検索は、検索の開始コマンド以外、上述の検索と同様に動作します。 '''C-M-s''' あるいは '''C-M-r''' によって、それぞれ正規表現による後方検索、前方検索を開始します。いったん正規表現検索を開始すると、文字列検索と同様に '''C-s''' と '''C-r''' を後方検索、前方検索に使用することができます。

検索に加え、文字列や正規表現を置換することができます（それぞれ '''M-%''' および '''C-M-%''' によって実行されます）。元のテキストと変換後のテキスト用にプロンプトが表示され、それからハイライトされた一致箇所に対する動作のために別のプロンプトが表示されます。多くのオプションが使用できますが（使用できるオプションの完全なリストは '''?''' を押してください）、もっとも一般的に使われるのは、変換を実行する '''y''' と、スキップする '''n''' 、そしてハイライトされている文字列を含め、以降すべての一致に対して変換する '''!''' になります。

=== 前置引数 ===

'''C-u''' は、'universal-argument' コマンドに対応づけられています。'universal-argument' を渡すことによって、より多くの情報をコマンドに提供できます（この情報を '前置引数' と呼びます）。たとえば

C-u 80 %

は、%記号の行を挿入します。また、

C-u 4 M-d

は4単語を削除します。この場合、'''M-d''' によって実行されるコマンドへ、要求する単語の数を渡しています。

universal argument は、'''M-<数字>''' によって少し早く入力することができます。

M-80 %

=== インデント ===

インデントは、1行をインデントする '''<TAB>''' やリージョンをインデントする '''C-M-\''' によって実行されます。リージョンが有効（''たとえば''ハイライトされている）場合、'''<TAB>''' はリージョンもインデントします。

テキストがどのようにインデントされるかは、正確には有効になっている ''メジャーモード'' に依ります。メジャーモードは、しばしば特定の種類のテキストをインデントするときに特化したインデントスタイルを定義します。（より詳しくは [[#モード|Modes]] を見てください。）

いくつかの場合、ファイルタイプに対して適したメジャーモードがありません。その場合、手動でのインデントが必要になります。リージョンを作成（ [[#kill と yank とリージョン|kill と yank とリージョン]] 参照）し、'''C-u <n> C-x <TAB>''' でインデントを実行してください。（ここで、'<n>' はリージョンに含まれるテキストがインデントされる列の数です。）例えば、

リージョンのインデントを4列追加する:

C-u 4 C-x <TAB>

リージョンのインデントを2列減らす:

C-u -2 C-x <TAB>

=== ウィンドウとフレーム ===

Emacs は、多くのファイルを同時に編集するために便利であるよう設計されています。これは、Emacs のインタフェースを3つの階層にわけることで実現されています。つまり、すでに紹介済みのバッファ、''ウィンドウ'' と ''フレーム'' です。

'''ウィンドウ''' とは、Emacsでバッファを表示している場所のことです。1つのウィンドウは、一度に1つのバッファしか表示できません。しかし、1つのバッファは複数のウィンドウに表示できます。それぞれのウィンドウの下には、''モードライン'' があります。モードラインには、そのバッファの情報が表示されています。

'''フレーム''' とは、Emacs の"ウィンドウ"（一般的な意味。たとえば最近のデスクトップパラダイムの意味での 'ウィンドウ'）です。フレームには、タイトルバー、メニューバー、1つ以上の 'ウィンドウ' (Emacs 的な意味。たとえば上で定義した 'ウィンドウ') が含まれます。

以降では、これらの単語は Emacs に存在するものでの定義として使用します。

ウィンドウを水平あるいは垂直に分割するには、それぞれ '''C-x 2''' あるいは '''C-x 3''' を使います。これは、現在のフレームにもう1つのウィンドウを生成する効果があります。複数のウィンドウ間を巡回するには、'''C-x o''' を使用します。

ウィンドウ分割の反対は、ウィンドウを削除することです。現在のウィンドウを削除するには '''C-x 0''' を使い、現在のウィンドウ以外を削除するには '''C-x 1''' を使います。

ウィンドウと同様に、フレームも生成や削除が可能です。 '''C-x 5 2''' によってフレームを生成できます。 '''C-x 5 0''' によって現在のフレームを削除し、'''C-x 5 1''' によってr現在のフレーム以外のすべてのフレームを削除します。

{{Note|これらのコマンドはバッファには影響しません。たとえば、ウィンドウを削除しても表示されているバッファは kill されません。}}

=== モード ===

Emacs モードは Emacs Lisp で書かれた拡張であり、接続されているバッファの挙動を制御します。大抵の場合、インデントやシンタックスハイライト、テキストを編集するときのキーバインドを提供します。洗練されたモードは Emacs を完全な IDE (統合開発環境) に変貌させます。Emacs は基本的にファイルの拡張子でモードをロードすべきか判断します。

シェルスクリプトを編集するのに役立つモードとして sh-mode, line-number-mode, column-number-mode が存在します。同時に使用することができ、以下のコマンドで呼び出します:

'''M-x sh-mode <RET>'''

'''M-x column-number-mode <RET>'''

line-number-mode はデフォルトで有効になっていますが、コマンドを再度実行することでオンとオフを切り替えられます:

'''M-x line-number-mode <RET>'''

sh-mode は、''メジャーモード'' の1つです。メジャーモードは Emacs を調整し、時には、特定の種類のテキストの編集用に特別なコマンドを提供します。それぞれのバッファでは、メジャーモードは1つだけが有効です。シンタックスハイライトやインデントサポートに加えて、sh-mode はシェルスクリプトを書く助けになるいくつかのコマンドを定義しています。以下に、それらの内のいくつかを示します。

'''C-c (''' 関数定義を挿入する

'''C-c C-f''' 'for' ループを挿入する

'''C-c TAB''' 'if' 文を挿入する

'''C-c C-w''' 'while' ループを挿入する

'''C-c C-l''' 1 から n までの番号付きループを挿入する

'line-number-mode' と 'column-number-mode' は''マイナーモード''です。マイナーモードはメジャーモードを拡張することができ、同時に任意の数のマイナーモードを有効にできます。

=== マニュアル ===

Emacs を本当にマスターしたいのであれば、一番よく読むべき文章はやはり公式マニュアルです:
* Emacs: 完全な Emacs ユーザーマニュアル
* Emacs FAQ
* Emacs Lisp Intro: プログラミング言語を使用したことがない場合
* Elisp: プログラミング言語をよく知っている場合

これらは、 [http://www.gnu.org/software/emacs/manual/ GNU.org] から PDF として入手できます。あるいは Emacs 自身にて組み込みの 'info' リーダー '''C-h i''' を用いて直接読むこともできます。本を選択するには '''m''' を押してください。

ユーザーの幾人かは、'info' で読むことを好みます。便利なショートカットであり、段落はウィンドウ幅に調整され、フォントは現在の画面解像度に調整されるためです。何人かは目に優しいと気づいています。最後に、本の内容を任意の Emacs バッファへ簡単にコピーでき、さらに例示されている Lisp コードを直接実行することさえできます。

'''info''' 本について、もっとよく知りたいなら、'''C-h i m info <RET>''' を実行してください。
info モードで '''?''' を押すと、ショートカットの簡易リストが表示されます。

== カスタマイズ ==

Emacs は {{ic|~/.emacs}} を編集するか '''M-x customize''' を使うことで設定をすることができます。このセクションでは手動で {{ic|~/.emacs}} を編集する方に焦点をあて、いくつかのカスタマイズ例を示すことで、一般的な Emacs の設定をデモンストレーションします。customize コマンドは調整を行うためのシンプルなインターフェイスを提供しますが、おそらく Emacs に慣れてくるにつれて制約を感じるようになるでしょう。

ここでの例は、すべて Emacs が動作している間に動作します。Emacs 内で式を評価するには、以下を使います。

'''C-M-x''' ポイントがある式を評価する

あるいは、

'''C-x C-e''' ポイントの直前の ')' を最後のカッコとする式を評価する

何人かのユーザーは、プロンプトで 'yes' や 'no' をタイプすると、すぐに疲れます。その代わりに 'y' や 'n' を使うために:

(defalias 'yes-or-no-p 'y-or-n-p)

カーソルの点滅を止めるには、次を使用:

(blink-cursor-mode -1)

同じく、前のセクションにある column-number-mode を有効にするには:

(column-number-mode 1)

前の2つのコマンドに類似性があるのは偶然ではありません。blink-cursor-mode と column-number-mode は、共にマイナーモードです。ルールとして、マイナーモードは正の数を引数にとると有効になり、負の数で無効になります。引数が省略された時、マイナーモードは on/off を切り替えます。

マイナーモードのその他いくつかの例を示します。以下はそれぞれ、スクロールバー、メニューバー、ツールバーを無効にします。

(scroll-bar-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)

変数 'auto-mode-alist' によって、特定のファイル名に対してデフォルトで使われるメジャーモードを変更することができます。以下の例では、'.tut' および '.req' ファイルのデフォルトのメジャーモードを 'text-mode' にします。

(setq auto-mode-alist
(append
'(("\\.tut$" . text-mode)
("\\.req$" . text-mode))
auto-mode-alist))

設定は、基底となるモードごとに適用することもできます。基本的な方法は、''hook'' に関数を追加することです。例えば、text-mode でだけインデントをタブの代わりに強制的にスペースを使用するためには:

(add-hook 'text-mode-hook (lambda () (setq indent-tabs-mode nil)))

同様に、場所によらずインデントにてスペースを使用するには:

(setq-default indent-tabs-mode nil)

キーバインドは、2つの方法で調整できます。1つ目の方法は 'define-key' です。'define-key' は、コマンドに対するキーバインドを作成できますが、1つのモードに対してだけ作成します。以下の例では、'''F8''' に、'text-mode' バッファでは行末のホワイトスペースを除去するよう割り当てます。

(define-key text-mode-map (kbd "<f8>") 'delete-trailing-whitespace)

もう1つの方法は、'global-set-key' です。これによって、場所によらずキーにコマンドを割り当てることができます。'query-replace-regexp' ('''C-M-%''') を '<f7>' に割り当てるには:

(global-set-key (kbd "<f7>") 'query-replace-regexp)

他のキーにコマンドを割り当てることは、既存の割当を入れ替えるわけではありません。たとえば、上記例の後、'query-replace-regexp' は、'''F7''' と '''C-M-%''' の両方に割り当てられます。

Emacs のほとんどすべてがカスタマイズできます。[http://emacswiki.org/ Emacs Wiki] を通して見ることが基礎固めに適しています。

=== マルチ設定 ===

複数の設定を使い、Emacs にどれか一つをロードさせることができます。

例えば、2つの設定ファイルを定義してみましょう。

{{hc|.emacs|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/plugins" nil t)
(load "~/.emacs.d/theme" nil t)
}}

これによって、デーモンとしての起動用にフルカスタムをロードします。しかし、''plugins'' ファイルは巨大で、ロードが遅いです。''plugins'' 機能が不要な新しい Emacs インスタンスを生成したい場合、''plugins'' を毎回ロードすることは面倒です。

{{hc|.emacs-light|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/theme" nil t)
}}

Emacs を以下のコマンドで起動します。
emacs -q -l ~/.emacs-light
これによって、エイリアスを生成して、呼び出しを簡単にすることができます。

=== ローカル・カスタム変数 ===

設定ファイル内で変数を定義することができます。この変数はファイル内でローカルに変更することができます。

(defcustom my-compiler "gcc" "Some documentation")

どんなファイルでもローカル変数を定義するには2つの方法があります。[https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html 完全な詳細のマニュアル ] を参照してください

* {{ic| M-x add-file-local-variable-prop-line}} は、ファイルの先頭に以下のようなコメント行を追加します。
// -*- my-compiler:g++; mode:c++ -*-
* {{ic| M-x add-file-local-variable}} は、ファイルの末尾付近に行を追加します。
// Local Variables:
// my-compiler: g++
// mode: c++
// End:

変数の効果を得るためには、{{ic|M-x revert-buffer}} を実行する必要あることに注意してください。

カスタム変数は、デフォルトでは安全でないと考えられています。もしカスタム変数によって再定義されたローカル変数を含むファイルを開こうとすると、Emacs は確認するよう通知します。

変数を安全であるとして宣言することもできます。これによって確認のためのプロンプトを除去することができます。新しい変数が安全と考えられるためには検証されなければならない、と述語を指定する必要があります。

(defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

この例では、文字列以外の何かにセットしようとすると、Emacs は安全でないと考えます。

=== カスタムカラーとテーマ ===

''face'' を使うことで簡単に色をカスタマイズすることができます:
(set-face-background 'region "color-17")
(set-face-foreground 'region "white")
(set-face-bold-p 'font-lock-builtin-face t )

ポイントがある場所の face の名前を Emacs に表示させることができます。そのためには ''customize-face'' を使います。どのように色、太字、下線、等が設定されているかを示すことができます。

コンソール上の Emacs は、256色を扱うことができます。しかし、それには適したターミナルを使わなければなりません。たとえば URxvt は256色をサポートしています。''list-colors-display'' によって、サポートされる色の包括的なリストが表示できます。これは強くターミナルに依存します。

=== SyncTeX サポート ===

Emacs は強力な LaTeX エディタです。LaTeX モードを必要に応じて自由に編集・作成することができます。

SyncTeX サポートといった、まだいくつかの挑戦があります。最初に TeX ディストリビューションに SyncTeX があるかを確認する必要があります。もし TeX Live を手動でインストールした場合、''synctex'' パッケージをインストールする必要があるかもしれません。
# umask 022 && tlmgr install synctex

SyncTeX サポートは、ビューア依存です。ここでは例として Zathura を使用します。他の PDF ビューアを使用する場合、コードを変更する必要があります。

(defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
"TeX 文書用 PDF ビューア。
同じドキュメントを2回起動したこと検出する、または Emacs を
閉じても表示を継続するためにビューアを fork したい場合、

シンプルなコマンド:

zathura --fork

SyncTex を用いて pdf を逆検索するために以下が使用できる。

emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

引用符および二重引用符は必須で、適切にエスケープされなければならない点に注意。"
:safe 'stringp)

カスタム変数を定義します。もし AucTeX や Emacs 標準の LaTeX-mode を使用しているなら、それに応じてビューアを設定する必要があります。

LaTeX ソースファイルを Emacs で開き、文書をコンパイルし、ビューアを起動します。Zathura が起動します。{{ic|Ctrl+Left click}} を押すと、Emacs は対応する位置にポイントを移動させます。

=== Systemd ファイルのシンタックスハイライト ===

[https://github.com/holomorph/systemd-mode systemd-mode] を使うことができます。

もしくは init ファイルに以下を追加することで、簡単に emacs で systemd のファイル (サービスやタイマーなど) をカラー表示できます:

(add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

=== emacs-nox のクリップボードサポート ===

emacs-nox で [[Xorg]] クリップボードを使うには、{{Pkg|xclip}} を[[インストール]]して以下の関数を {{ic|~/.emacs}} に追加してください [https://lists.gnu.org/archive/html/help-gnu-emacs/2014-08/msg00189.html]:

{{bc|1=
;; use xclip to copy/paste in emacs-nox
(unless window-system
(when (getenv "DISPLAY")
(defun xclip-cut-function (text &optional push)
(with-temp-buffer
(insert text)
(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
(defun xclip-paste-function()
(let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
(unless (string= (car kill-ring) xclip-output)
xclip-output )))
(setq interprogram-cut-function 'xclip-cut-function)
(setq interprogram-paste-function 'xclip-paste-function)
))
}}

{{Tip|以下を追加することでターミナルマウスサポートも有効にできます:
{{bc|1=
;; xterm mouse support
(require 'mouse)
(xterm-mouse-mode t)
}}
[http://www.opensource.apple.com/source/emacs/emacs-51/emacs/lisp/mwheel.el mwheel.el] を参照。}}

== ヒントとテクニック ==

前のセクションでは基本的な編集コマンドを説明していますが、それだけでは Emacs の可能性はわかりません。このセクションではより高度なテクニックや機能を紹介します。

ただし全てを説明するとなると長くなりすぎます。そのためこのセクションはあくまで Emacs の雅やかな機能をいくつか''デモ''するだけにとどめます。

全ての機能の詳細な説明は[[#ドキュメント|ドキュメント]]を見て下さい。

=== TRAMP ===

TRAMP (Transparent Remote Access, Multiple Protocols) は多数のプロトコルで、リモートファイルに透過的にアクセスすることができる拡張です。ファイル名を入力するときに、特定の形式を入力すると TRAMP が呼びだされます。例:

{{ic|/etc/hosts}} を root 権限で開く前に root のパスワードを要求するには:

C-x C-f /sudo::/etc/hosts

SSH で 'myhost' に 'myuser' として接続して {{ic|~/example.txt}} ファイルを開くには:

C-x C-f /ssh:myuser@myhost:~/example.txt

TRAMP のパスは '/[protocol]:[[user@]host]:<file>' という形式で指定します。TRAMP がサポートしているのは上記の例に限りません。詳しくは TRAMP の info マニュアルを参照してください。マニュアルは Emacs に付属しています。

=== キーボードマクロとレジスタ ===

This section will provide a practical demonstration of the use of a couple of more powerful editing features. Namely, ''keyboard macros'' and ''registers''.

The aim will be to produce a listing of a series of characters and their corresponding position in this list. While it is possible to format each of them by hand, this would be slow and error-prone. Alternatively, some of Emacs' more powerful editing functionality could be leveraged. Before describing a solution, some details behind the techniques which will be used follow.

The first feature which will be introduced is ''registers''. Registers are used to store and retrieve a variety of data types ranging from numbers to window configurations. Each register is given a name of a single character: this character is used to access the register.

The other which will be demonstrated is ''keyboard macros''. A keyboard macro stores a sequence of commands so they can be easily repeated later. These changes will now be performed step-by-step.

Starting with a buffer containing our set of characters:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

Prepare a register by invoking the `number-to-register' command ('''C-x r n''') then storing the number '0' in register 'k':

C-x r n k

With point at the beginning of the buffer, start a keyboard macro ('''C-x (''') and begin to format the characters:

C-x ( C-f M-4 .

Insert ('''C-x r i''') and increment ('''C-x r +''') the register 'k'. The prefix argument ('''C-u''') is used to leave point positioned after the inserted text:

C-u C-x r i k C-x r + k

Complete the formatting by inserting a newline. Emacs can then repeat that process, beginning from the point where we started defining the keyboard macro, for the rest of the characters. '''C-x e''' completes then invokes the keyboard macro. The prefix argument, '''M-0''', causes the macro to repeat until it comes across an error. In this case it aborts once it reaches the end of the buffer.

<RET> M-0 C-x e

The result:

A....0
B....1
C....2
[...]
x....49
y....50
z....51

If you want to save your macro for later use, you must give it a name and save it to your configuration file:
name-last-kbd-macro
insert-kbd-macro

All defined macros are stored in the macro ring. To cycle between macros, use
'''C-x C-k C-n''' next macro
'''C-x C-k C-p''' previous macro

You can also use registers to save virtually anything.

'''C-x r SPC''' Copy current point (position) to register
'''C-x r w''' Copy current window configuration to register.
'''C-x r j''' Restore register.

So if you often work with windows side by side, for different project, you can save the configuration for the different projects and easily switch from one view to the other.

You can list used registers with the '''list-registers''' command.

=== 正規表現 ===

Emacs Manual より: "正規表現 (''regexp'' と略す) とは、一致する可能性がある一連の (無限個でもよい) 文字列を表現するパターンである"。このセクションでは正規表現自体には深くは立ち入りません (単純に説明しきれない)。そのかわり正規表現のパワーを簡単にデモンストレーションします。詳しい説明は Emacs Manual の [https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html#Regular-Expressions Regular Expressions] セクションを見て下さい。

Given the same scenario presented above: A list of characters which are to be formatted to represent their respective position in the list. (see [[#キーボードマクロとレジスタ|Keyboard macros and registers]]). Again, starting with a buffer containing.

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

At the beginning of the buffer, use '''C-M-%''' (if the key-sequence is difficult to perform, it may be more comfortable to use '''M-x query-replace-regexp'''). At the prompt:
$.$
which simply matches one character. Then, when prompted for the replacement:
\1....\#^J
{{Note|'^J' represents where a newline should be placed, it should not be entered into the prompt. The newline must instead be inserted literally using '''C-q C-j'''.}}
The replacement expression reads: "Insert the matched text between the first set of parentheses (in this case, a single character), followed by 4 periods then insert an automatically incremented number followed by a newline.

Finally, press '''!''' to apply this across the entire buffer. All of the formatting that was performed in the previous section was performed with a single regexp replacement.

=== 矩形選択 ===

先進的なテキストエディタが当然備えているべき強力な機能として、テキストを矩形で選択・編集できるというのがあるでしょう。

Emacs でも矩形選択は可能です。'''C-SPC''' で普通にテキストを選択してから、複数の矩形コマンドを使うことができます。

'''C-x r t''' Replace rectangle with text.
'''C-x r k''' Kill (and save in kill-ring) rectangle.
'''C-x r y''' Yank rectangle.
'''C-x r o''' Blank out rectangle.

たとえハイライトされていても、上記のコマンドが矩形の外のテキストに影響を与えることはありません。

=== ブックマーク ===

Emacs は開いたファイルのリストを記録できます。

'''C-x r m''' カレントバッファをブックマークに追加。
'''C-x r b''' ブックマークからバッファを開く。
'''C-x r l''' ブックマークの確認。

=== Elisp インタプリタ ===

Evaluate an elisp expression using '''eval-last-sexp''' ('''C-x C-e'''). Emacs always spawns a '''*scratch*''' buffer when started. It will not be saved to disk, feel free to add any text / code you want. It is especially useful for elisp evaluation. Note that this buffer starts using '''lisp-interaction-mode''' by default.

Alternatively, Emacs provides a top-level elisp interpreter with the '''ielm''' command.

=== スマートなウィンドウ切り替え ===

長い間使っていると '''C-x o''' による伝統的なウィンドウ切り替えは面倒かもしれません。'''windmove''' コマンドはもっと便利にウィンドウを切り替えることができます。{{ic|Shift}} を押しながら方向キーでウィンドウを指定するだけです。

windmove キーを有効にするには、設定ファイルに以下を記述してください:

{{hc|~/.emacs|
(when (fboundp 'windmove-default-keybindings)
(windmove-default-keybindings))
}}

=== シェルコマンドの実行 ===

Use '''M-!''' to call an external command. Use a prefix argument ('''C-u M-!''') to output the result to current buffer at point.

You can use '''M-|''' on a region to use it as input for a command. For instance

'''C-u M-| sort -u RET'''

will sort region, remove duplicates and replace the region with the result.

=== シェルバッファ ===

You can spawn a shell buffer and execute commands just like you would do in any terminal.
A classic shell buffer can be spawned with the '''shell''' command.

Emacs features a very powerful shell entirely written in Emacs Lisp, the '''eshell'''. The major advantage over shells like csh or zsh is that the native shell language is elisp itself. So you can use all advanced feature of elisp for your shell functions.

=== 対応する括弧のハイライト ===

'''show-paren''' モードを使うことができます。デフォルトでは、対応する括弧が表示されるまで少し遅延がありますが、'''show-paren-delay''' を 0 に設定することでなくすことができます。

{{hc|~/.emacs|
(setq show-paren-delay 0)
(show-paren-mode 1)
}}

=== スペルチェック ===

辞書を選択するには:
'''M-x ispell-change-dictionary'''

To check a single work use '''M-$'''.
You can start checking the whole buffer with
'''M-x ispell-buffer'''

You can enable on-the-fly spell checking by enabling the '''flyspell-mode'''. For source code files you can restrict the mode to comments by using the '''flyspell-prog-mode''' instead. You will also need the ''aspell'' package for spelling in Emacs. There are corresponding packages for each language, so for English, you'd also want ''aspell-en'' (as well as ''aspell'').

=== テーブル ===

Emacs comes with some powerful functions to handle and generate tables for various languages. Let's show an example.

Fruits Quantity
Apples 5
Melons 2

Now select the previous content in a region, and run
table-capture

Use two spaces for the column delimiter, and a line break ('''C-q C-j''') for the row delimiter.
This will lead to the following result.

+------+--------+
|Fruits|Quantity|
+------+--------+
|Apples|5 |
+------+--------+
|Melons|2 |
+------+--------+

You can revert back the operation with
table-release
There is a lot of handy ''table-*'' functions, like ''table-insert-row'', ''table-span-cell'', ''table-widen-cell'', etc.

Finally, the ultimate purpose of the ''table'' functions is to convert it to the desired markup language.
Use the ''table-generate-source'' for that.
For LaTeX, the previous table would result in

% This LaTeX table template is generated by emacs 24.2.1
\begin{tabular}{|l|l|}
\hline
Fruits & Quantity \\
\hline
Apples & 5 \\
\hline
Melons & 2 \\
\hline
\end{tabular}

Using the table mode you can also do some spreadsheet work like sum on rows and columns, but you will quickly find it limited. Besides it is quite slow. Have a look at the [[#予定表、スプレッドシート、文章作成|org-mode]] for much more powerful possibilities.

=== 予定表、スプレッドシート、文章作成 ===

Emacs can offer powerful office features thanks to the famous and powerful [http://orgmode.org/ Org mode]. This mode is part of the standard Emacs distribution.

Org mode is originally a powerful TODO and Agenda agent, but has quickly evolved to a much wider set of features.
There is simply too much to tell about Org that we cannot aford even to skim over all the features. So we will only whet your appetite with a few exemples.

Open a new file TODO.org file, Org mode should be loaded. If not, switch to it with '''M-x org-mode'''.
{{hc|TODO.org|
* First entry
** Subentry
Some comments
*** Subsubentry
* Second entry
- List item 1
- List item 2
}}

Now a few useful bindings.
* '''TAB''' to cycle-fold current entry.
* '''S-TAB''' to cycle-fold all entries.
* '''M-RET''' to start a new item on the same level as the current one.
* '''M-<left>''' and '''M-<right>''' to change level.
* '''M-<up>''' and '''M-<down>''' to move item together with all its subsections.
* '''S-<left>''' and '''S-<right>''' to change status. On list items it will change the item style.
* '''S-<up>''' and '''S-<down>''' to change priority.
* '''C-c ^''' to sort all subentries of the current entry.
* '''C-c .''' to add a timestamp to the current entry. Use {{ic|Shift}} and arrows to skip days or weeks. Use the mouse on the calendar or press {{ic|Enter}} on a specific day to choose it.

The spreadsheet features are very comprehensive. Let's give an excerpt from the manual:

{{bc|<nowiki>
Finally, just to whet your appetite for what can be done with the
fantastic `calc.el' package, here is a table that computes the Taylor
series of degree `n' at location `x' for a couple of functions.

|---+-------------+---+-----+--------------------------------------|
| | Func | n | x | Result |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x) | 1 | x | 1 + x |
| # | exp(x) | 2 | x | 1 + x + x^2 / 2 |
| # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 |
| * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3
</nowiki>}}
Org mode recognizes a table when the pipe '''|''' is the first non-whitespace character on line. In the previous text, no line was drawn. This is done automatically when '''TAB''' is pressed after an entry or the '''|-''' sequence. The result column was not written by hand neither, it is computed from the calc formula on the last line. Use '''C-u C-c C-c''' to recompute all values in a table.

There is also some handy row and column manipulation bindings like those for the TODO file. {{ic|Alt}} plus arrows will move columns and arrows.

For more in-depth details, refer to the official manual: '''C-h i m Org mode RET'''.

=== リファクタリングとスマート補完 ===

(Eclipse などの) IDE が大抵備えているプログラミング機能が必要な場合、[http://cedet.sourceforge.net/semantic.shtml Semantic] ツールが役に立ちます。Semantic は Emacs の標準ディストリビューションに含まれています。現在 C, C++, Scheme, Javascript, Java, HTML, Make がサポートされています。現在のサポート状況は [http://cedet.sourceforge.net/languagesupport.shtml CEDET のページ] で確認できます。

Open a file in your favorite programming language supported by Semantic and turn on the Semantic minor mode with
M-x semantic-mode
Semantic will work for a few seconds parsing the libraries included from your file (in C that would mostly be the standard library for instance).

==== 機能 ====

Once done, you can start using the great Semantic features:
;Smart completion
Press '''C-c , SPC''' to complete a symbol at point. If it is an argument, it will check for type correctness.

;Jump to symbol
Press '''C-c , j''' to prompt for a symbol and jump to its definition. You can use auto-completion with '''TAB'''. Use a capital '''J''' to search for symbol accross files.

;List symbol calls
Press '''C-c , g''' to prompt for a symbol and list the places where it is being referred to. You can use '''n''' and '''p''' to navigate through the resulting entries. Press '''RET''' to toggle details, and '''RET''' again on a reference to jump to it. Use a capital '''G''' in the first command to work across files.

;Refactoring
First list use of the symbol you want to refactor with the aforementioned command. Now press '''(''' to start defining a macro on the symbol. This is actually much more powerful than refactoring since you can apply any function to the symbol and even act on its surrounding symbols. Press '''C-x )''' to finish the macro and '''E''' to call it.

;Describe symbol
Call the following function to display details on a symbol.
semantic-ia-show-summary
This can be very useful for complexe data structures and function prototypes. There is no binding by default.

==== 設定 ====

Here follows a sample configuration for use of Semantic with all supported programming languages: an example binding and a display configuration.
;; Semantic with ghost display (allows M-n and M-p to browse completion).
(semantic-mode 1)
(define-key my-keys-minor-mode-map (kbd "C-c , d") 'semantic-ia-show-summary)
(setq semantic-complete-inline-analyzer-displayor-class 'semantic-displayor-ghost)

You can also add some specialization for a specific language. Here for C:
(add-hook
'c-mode-hook
(lambda ()
(local-set-key (kbd "M-TAB") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)))

==== 文献 ====

Emacs から直接 info マニュアルにアクセスすることが可能です: '''C-h i m Semantic RET'''。

=== Emacs を git のマージツールとして使う ===

By default, Git provides support for using Emacs' Emerge mode as a merge tool. However you may prefer the Ediff mode. Unfortunately this mode is not supported by git for technical reasons. There is still a way to use it by evaluating some elisp code upon emacs call.

{{hc|.gitconfig|<nowiki>
[mergetool.ediff]
cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

[merge]
tool = ediff
</nowiki>}}

Note that the command has to be on a single line.
In the above example, we launch a new instance of Emacs. You might want to use emacsclient for quicker startup; it is not recommended though since the Ediff call is not really clean: it could mess with your current Emacs session.

If you want an instant startup you can use the '''-q''' parameter. If you want to launch Emacs quickly while preserving at least a part of your configuration, you can call Emacs with
emacs -q -l ~/.emacs-light
where the light configuration file loads only what you need for Ediff.

See [http://kerneltrap.org/mailarchive/git/2007/7/1/250424 kerneltrap.org] and [https://stackoverflow.com/questions/1817370/using-ediff-as-git-mergetool stackoverflow] for more details on this trick and the Ediff issue.

=== Caps Lock キーを Control キーとして使う ===
いわゆる 'emacs 小指' にならないようにこちらの挙動を好むユーザーもいます。X で試用してみたいときは、次を実行:
$ setxkbmap -option 'ctrl:nocaps'

また、キーを'''交換'''するには、次を実行:
$ setxkbmap -option 'ctrl:swapcaps'

永続的に設定したくなったら、{{ic|.xinitrc}} ファイルに上のコマンドを追加してください。

リージョンを小文字から大文字にする必要がある場合は、デフォルトの {{ic|C-x C-u}} キーバインディングを使って下さい、{{ic|upcase-region}} 関数が呼び出されます。

Caps Lock がない場合は、両方の "Shift" にマッピングしてください:
$ setxkbmap -option "shift:both_capslock"

一部のデスクトップ環境にはキーボードのマッピングを変更するためのグラフィカルなツールが含まれています。例えば [[Plasma|Plasma 5]] ならシステム設定を開いて入力デバイスをクリックしてください。キーボードを選択して高度な設定タブから Caps Lock を Ctrl として使用するように設定できます。

== パッケージ ==

Emacs の機能はサードパーティ製のパッケージで拡張できます。公式にサポートされているパッケージマネージャとして {{ic|package.el}} が組み込まれていますが、Emacs のコミュニティメンバーによって書かれたパッケージマネージャが他にも存在します。{{ic|package.el}} は {{ic|package-archives}} 変数を使ってパッケージを検索します。デフォルトでは [https://elpa.gnu.org/ Emacs Lisp Package Archive (ELPA)] が含まれています。{{ic|M-x list-packages}} で Emacs が認識している全てのパッケージが列挙されたバッファが作成されます。マニュアル ({{ic|[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html (info "(emacs) Packages")]}}) にはさらに詳しい情報が載っています。

サードパーティ製のパッケージのアーカイブを追加することもできます。[https://melpa.org/ MELPA] が広く使われています。

人気の拡張の多くは {{ic|[community]}} リポジトリのパッケージや [[AUR]] からインストールできます。大抵の場合、パッケージの名前の前に 'emacs-' が付きますが (例: {{Pkg|emacs-lua-mode}})、常にそうなっているわけではありません (例: {{AUR|auctex}})。

{{Tip|Arch Linux の Wiki を編集している場合は [[Emacs Mediawiki]] パッケージが役に立ちます。}}

パッケージによっては設定ファイルに変更を加えないと機能が有効にならない場合があります。例えば、{{AUR|auctex}} をインストールしたときは、設定ファイルに以下を追加:

{{bc|
(load "auctex.el" nil t t)
(load "preview-latex.el" nil t t)}}

パッケージのソースコードや README で有効化する方法が書かれているはずです。

== トラブルシューティング ==

=== Emacs が 'Undefined color: "WINDOW_FOREGROUND"' というエラーメッセージで起動しない ===

{{Pkg|mcpp}} パッケージまたは {{Pkg|gcc}} パッケージをインストールする必要があります。''xrdb'' は [[X resources]] を前処理するために C のプリプロセッサ ''cpp'' を使用します。C のプリプロセッサがインストールされていない場合、''xrdb'' は C のプリプロセッサを実行しないため WINDOW_FOREGROUND が16進数のカラーコードに展開されません。

=== カラー出力の問題 ===

デフォルトでは、Emacs シェルはカラー表示に使われるエスケープシーケンスをそのまま表示してしまいます。つまり、カラー出力がされるべきところに変な記号が表示されます。

この問題を解決するには以下を {{ic|~/.emacs}} に記述してください:
(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

=== X ウィンドウでの文字の表示問題 ===

X ウィンドウで emacs を起動した時にメインウィンドウの文字が全て黒縁の白四角になってしまう場合 (対応するフォントがインストールされていない文字を表示したときと同じような記号)、{{Pkg|xorg-fonts-75dpi}} や {{Pkg|xorg-fonts-100dpi}} をインストールして X ウィンドウを再起動してください。

=== 起動が遅い ===

{{Tip|[[#systemd ユニットとして|systemd ユニットとして]] Emacs を起動する方法でも起動時間を短縮できます。}}

しばしば起動時間が遅くなる原因は2つあります。

どちらが原因なのか調べるために、次のコマンドで Emacs を実行してください:

$ emacs -q

このコマンドでも Emacs の起動が遅い場合、[[#不適切なネットワーク設定|不適切なネットワーク設定]]を参照してください。そうでない場合は、ほぼ確実に .emacs に問題があります。

* {{ic|/etc/hosts}} の設定が間違っていると、Emacs の起動が5秒以上遅くなることになります。詳しくはネットワーク設定ガイドの '[[ネットワーク設定#ホストネームの設定|ホストネームの設定]]' を見てください。

* A simple way to search for the cause is to comment-out (i.e., prefix lines with ';') suspect sections of your {{ic|~/.emacs}} (or {{ic|~/.emacs.d/init.el}}) then start Emacs again to see if there's any change. Keep in mind use of "require" and "load" can slow the startup down, especially when used with larger extensions. They should, as a rule, only be used when their target is either: needed once Emacs starts or provides little more than "autoloads" for an extension. Otherwise, use the 'autoload function directly. For example, instead of:

(require 'anything)

you might use:

(autoload 'anything "anything" "Select anything" t)

=== Cannot open load file: ... ===

The most common cause of this error is the 'load-path' variable not including the path to the directory within which the extension is located. To solve this, add the appropriate path to the list to be searched prior to attempting to load the extension:

(add-to-list 'load-path "/path/to/directory/")

When attempting to use packages for extensions and Emacs has been configured with a prefix other than '/usr', the load-path will need to be updated. Place the following in {{ic|~/.emacs}} prior to the instructions provided by the package:

(add-to-list 'load-path "/usr/share/emacs/site-lisp")

If compiling Emacs by hand, keep in mind that the default prefix is '/usr/local'.

=== デッドアクセントキーの問題: '<dead-acute> is undefined' ===

このバグについて Google で検索すると、次のリンクが見つかります:
https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

Explaining the problem: in recent versions of
b72
Emacs, the normal way to use accent keys doesn't work as expected. Trying to accent a word like 'fiancé' will produce the message above.

A way to solve it is just put the line above on your startup file, {{ic|~/.emacs}}:

(require 'iso-transl)

And no, it isn't a bug, but a feature of new Emacs versions. Reading the subsequent messages about it on the mail list, we found it (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html):

:''It seems that nothing is loaded automatically because there is a choice betwee iso-transl and iso-acc. Both seem to provide an input method with C-x 8 or Alt-<accent> prefix, but what you and I are doing is just pressing a dead key (^, ´, `, ~, ¨) for the accent and then another key to "compose" the accented character. And there is no Alt key used in this! And according to documentation it seems be appropriate for 8-bit encodings, so it should be pretty useless in UTF-8. I reported this bug when it was introduced, but the bug seems to be classified as a feature ... Maybe it's just because the file is auto-loaded though pretty useless. ''

=== C-M-% やその他のバインディングが emacs nox で動作しない ===

これはターミナルが Xorg よりも制限的であることが原因です。ただし、ターミナルによっては多くのバインディングを扱うことができることがあります。2つの解決法が考えられます:
* グラフィカルバージョンを使用する。
* サポートされているバインディングに変更する。

例:
{{hc|.emacs|
(global-set-key (kbd "C-M-y") 'query-replace-regexp)
}}

=== Emacs がフリーズする ===

シングルスレッドであるがゆえに、Emacs は様々な操作でブロックします。フリーズが発生する状況は様々です。例えば、Emacs はあなたからの入力を待っているのかもしれません (例えばあるフレームでミニバッファを開いているのに他のフレームで作業しようとしている場合など)。あるいは、Emacs は完了するまで時間のかかるコードを実行中なのかもしれません。あるいはバグを踏んだという可能性もあります。Emacs プロセスを殺さずに Emacs のブロックを解除する方法は複数存在します。

* {{ic|C-g}} を押してみる。Emacs が行っていることによっては、複数回押す必要があります。
* {{ic|ESC ESC ESC}} を押してみる。
* 他のターミナルで {{ic|killall -SIGUSR2 emacs}} を実行する。

=== Emacs-nox の出力が汚い ===

When working in a terminal, the color, indentation, or anything related to the output might become crazy. This is (probably?) because Emacs was sent a special character at some point which may conflict with the current terminal.
If this happens you can do {{ic|M-x redraw-display}}, which will redraw the terminal's display. If this problem happens frequently, you might want to bind the command to a key, e.g. by putting something like
(global-set-key (kbd "<f7>") 'redraw-display)
in your .emacs file.

Graphical Emacs does not suffer from this issue.

=== emacs ターミナルにおかしなエスケープ数字 (utf-8) が表示される ===

{{ic|.bashrc}} または {{ic|.zshrc}} で以下の変数をエクスポートしてください:

{{hc|1=~/.bashrc|2=
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export TERM=xterm-256color
}}

小文字の utf を使っていることがエラーの原因です (例: en_US.utf-8)。

利用可能なロケールは {{ic|locale -a}} で確認できます。

=== tmux で emacs を使っているときに Shift + 矢印キーが動作しない ===

まず [[tmux]] の設定で xterm-keys を有効にしてください:
{{hc|.tmux.conf|
setw -g xterm-keys on
}}

しかしながら、この設定は他のキーコンビネーションを破壊します。それを修正するために、以下を emacs の設定に記述します:
{{hc|~/.emacs|
(defadvice terminal-init-screen
;; The advice is named `tmux', and is run before `terminal-init-screen' runs.
(before tmux activate)
;; Docstring. This describes the advice and is made available inside emacs;
;; for example when doing C-h f terminal-init-screen RET
"Apply xterm keymap, allowing use of keys passed through tmux."
;; This is the elisp code that is run before `terminal-init-screen'.
(if (getenv "TMUX")
(let ((map (copy-keymap xterm-function-map)))
(set-keymap-parent map (keymap-parent input-decode-map))
(set-keymap-parent input-decode-map map))))
}}

詳しくは [https://github.com/tmux/tmux/blob/master/FAQ#L242 tmux FAQ] を参照。

=== KDE でウィンドウのリサイズがおかしい ===
KDE ユーザーには Emacs のウィンドウが正しくリサイズされないという現象がおこることがあります。リサイズした部分が透過されマウスでクリックしても下のウィンドウがクリックされます。この挙動を修正するには、KDE の GTK3 テーマを oxygen-gtk 以外のテーマに変更してください。例えば、{{Pkg|gtk3}} に含まれている Emacs テーマを使って下さい。

KDE で Emacs を完全に最大化するには、タイトルバーの Emacs アイコンをクリックして、More Actions > Special Window Settings を選択してください。そして "Size & Position" タブで "Obey geometry restrictions" を選択して、ドロップダウンメニューで "Force" を選んで右のラジオボタンで "No" を選んで下さい。

== 派生 ==

Emacs の実装は多数存在します。おそらく GNU/Emacs が一番ポピュラーです。

軽量な Emacs 互換のテキストエディタは Arch のリポジトリや [[AUR]] にあります。

=== mg ===

mg (旧名 MicroGnuEmacs) は C で書かれた軽量な Emacs の実装です。

{{Pkg|mg}} パッケージから入手できますが、上流の [http://homepage.boetes.org/software/mg/ ページ] からソースをダウンロードすることも可能です。mg は UTF-8 をサポートしていません。

=== zile ===

公式ウェブ[https://www.gnu.org/software/zile/ ページ]によると "GNU Zile は軽量な Emacs クローンです。Zile は Zile Is Lossy Emacs の略となっています。Zile は出来る限り Emacs に近づくように書かれており、きっと全ての Emacs ユーザーの手に馴染むでしょう"。Zile は UTF-8 をサポートしていません。

{{Pkg|zile}} パッケージからインストールできます。

最新の tarball は公式の GNU [http://ftp.sh.cvut.cz/MIRRORS/gnu/pub/gnu/zile/ ミラー] から落とせます。

=== uemacs ===

Linus Torvalds によるカスタム版 Micro-emacs。{{AUR|uemacs-git}} でインストール可能。

最新 (2005) の tarball は [ftp://ftp.cs.helsinki.fi/pub/Software/Local/uEmacs-PK/ こちら] にあります。

=== remacs ===

'''remacs''' はコミュニティによる Emacs の Rust 移植です。{{AUR|remacs-git}} パッケージでインストールできます。

== 参照 ==

* [https://www.gnu.org/software/emacs/ GNU Emacs ホームページ]
* [https://www.gnu.org/software/emacs/manual/emacs.html GNU Emacs マニュアル]
* [http://www.emacswiki.org/cgi-bin/wiki/ Emacs Wiki]
* [http://wikemacs.org WikEmacs - 読みやすいが不完全な Emacs wiki]
* [http://www2.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html Emacs とそのショートカットの有用な紹介]
* [https://d0edfcdc0ccc1cd13cdab5eb986fb92e8660dbef.googledrive.com/host/0B6LMD0u8OhYYZEotN2QyR1hwR1k/ Emacs 教会 (Google ドライブ)]
* [https://www.gnu.org/software/emacs/refcards/pdf/refcard.pdf 公式リファレンスカード]
* [[EXWM]] - Emacs X Window Manager

Emacs

2021-11-23T14:36:53Z

がおびん: /* クイックスタート */ 英語の記述を日本語に翻訳した。

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[Category:GNU]]
[[de:Emacs]]
[[en:Emacs]]
[[es:Emacs]]
[[fr:Emacs]]
[[sr:Emacs]]
[[zh-hans:Emacs]]
[[Wikipedia:ja:Emacs|Emacs]] は拡張性があり、カスタマイズ可能な、セルフドキュメント方式のリアルタイム表示エディタです。Emacs のコアには、多数の Emacs の内蔵機能や拡張を実装するのに使われている言語である、[[Wikipedia:ja:Emacs Lisp|Emacs Lisp]] のインタプリタが存在します。GNU Emacs 22 から GTK がデフォルトの X ツールキットとして使われていますが、CLI 環境でも負けず劣らずに機能します。

== インストール ==

Emacs には複数の種類があります (時々 ''emacsen'' と呼ばれます)。その中で最も一般的なのは [https://www.gnu.org/software/emacs/ GNU Emacs] です。

{{Pkg|emacs}} パッケージを[[インストール]]してください。いつもターミナルで作業をする場合は、GTK+ がいらない {{Pkg|emacs-nox}} の方が良いでしょう (サウンドなどの装飾的な機能もありません)。
ただしテキストバージョンにはいくつか欠点が存在します: サポートしている色やフォント処理の機能 (実行中にサイズを変更したり、単一の文章で複数のサイズを使うなど) が少なくなっています。その上、emacs-nox には Speedbar や GUD (デバッグ環境) などの高度な機能について制限があり、複雑なフェイスを使おうとするとやや遅くなります ("フェイス"とは Emacs におけるテキストの外観のことです)。

== Emacs の実行 ==

emacs を起動する前に、終了の方法を知っておきましょう (特にターミナルで実行する場合): {{ic|Ctrl+x}}{{ic|Ctrl+c}} キーシーケンスを使って下さい。

Emacs を起動するには次を実行:

$ emacs

また、コンソールから使うには:

$ emacs -nw

(.emacs を使わずに) 高速でロードして CLI で編集するには:

$ emacs -Q -nw

nox バージョンをインストールしている場合、'emacs' と 'emacs -nw' は同じになります。

ファイル名を指定することですぐにファイルを開くこともできます:

$ emacs filename.txt

=== 色無し ===

デフォルトでは、Emacs はハイパーリンクが濃青で表示されるカラーテーマで起動します。Emacs をカラーテーマやスキームを使わずに起動するには:

$ emacs -nw --color=no

このコマンドでは全てのテキストがターミナルの前景色だけで表示されます。通常は黒背景に白字か、白背景に黒字となります。

=== デーモンとして ===

毎回 {{ic|.emacs}} ファイルをロードするため Emacs を起動するときには時間が多少かかります。また、別のインスタンスから同じファイルにアクセスしたいと思うときもあるかもしれません。バージョン23から、Emacs はユーザーが接続できるデーモンとして起動することが可能になっています。Emacs をデーモンとして実行するには:

$ emacs --daemon

起動時にデーモンを実行してウィンドウをデーモンに接続すると良いでしょう。さらに、グラフィカル・コンソールクライアント''両方を''同意時にデーモンに接続して GUI を素早く起動することも可能です。

デーモンに接続したいときは場合は次のコマンドを使って下さい (グラフィカル環境から実行したときはグラフィカルクライアントが、tty などのコンソールから実行したときはコンソールクライアントが起動します):

$ emacsclient

グラフィカル環境にいるときもコンソールクライアントを使いたい場合は次のコマンドを使って下さい:

$ emacsclient -t

さらに、{{ic|-a ""}} パラメータを追加することもできます。
これで、最初にコマンドを実行したときは、デーモンとして emacs が起動します。バックグラウンドで動き続けるので後で呼び出した時に起動時間が早くなります (バッファも残り続けます)。

ターミナルや他のプログラムからクライアントを起動した場合、呼び出すプログラムを使うことで Emacs クライアントを閉じなくてもクライアントを使い続けることができます。そのためには、 {{ic|-n}} ({{ic|--no-wait}}) パラメータを使ってクライアントを起動します:
$ emacsclient -nc

Mutt や Git などのプログラムは (コミットメッセージを読むための) エディタが終了するまで待機するため、{{ic|-n}} パラメータを使うことはできません。デフォルトエディタが設定されている場合、他のエディタを指定する必要があるかもしれません (例: {{ic|emacsclient -a "" -t}})。

以下のシェル設定が利用できます:

{{bc|1=
alias emt='emacsclient -nc -a ""'
alias emc='emacsclient -t -a ""'
EDITOR='emacsclient -a ""'
}}
ただしこれには注意事項があります: コマンドのスペースの関係で多数のプログラムが外部エディタをロードすることはできません。

スクリプトを書くほうがもっと使い勝手が良く信頼性があります:
{{hc|/usr/local/bin/emc|<nowiki>
#!/bin/sh
if [ -z "$DISPLAY" ]; then
IS_GRAPHICAL=true
else
IS_GRAPHICAL=$(emacs --batch -Q --eval='(if (fboundp '"'"'tool-bar-mode) (message "true") (message "false"))' 2>&1)
fi

if $IS_GRAPHICAL; then
emacsclient -a "" -nc "$@"
else
emacsclient -a "" -t "$@"
fi
</nowiki>}}
スクリプトは実行可能属性を付けて下さい:
# chmod 755 /usr/local/bin/emc

これで 'emc' が期待通りに動作するようになります。このクライアントをデフォルトのエディタにしたいときは上記のスクリプトで {{ic|EDITOR}} 環境変数を設定すれば OK です。

=== systemd ユニットとして ===

Emacs 26.1 から systemd ユニットが含まれています。Emacs のインストール後に以下のように有効化してください:

$ systemctl --user enable --now emacs

Emacs サーバーを実行したいユーザーで上記のコマンドを実行してください。サービスの起動後、Emacs の準備ができます。ユニットファイルは {{ic|/usr/lib/systemd/user/emacs.service}} に存在します。ユニットファイルの中身は以下のようになっています:

{{hc|/usr/lib/systemd/user/emacs.service|<nowiki>
[Unit]
Description=Emacs text editor
Documentation=info:emacs man:emacs(1) https://gnu.org/software/emacs/

[Service]
Type=simple
ExecStart=/usr/bin/emacs --fg-daemon
ExecStop=/usr/bin/emacsclient --eval "(kill-emacs)"
Environment=SSH_AUTH_SOCK=%t/keyring/ssh
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

systemd のユーザーユニットはログインシェル ({{ic|~/.bash_profile}} など) から環境変数を継承しないため、{{ic|~/.pam_environment}} に変数を設定すると良いでしょう。詳しくは [[Systemd/ユーザー]]を参照。

emacs をデーモンとして起動する場合、{{ic|VISUAL}} と {{ic|EDITOR}} 環境変数を {{ic|emacsclient}} に設定することでプログラムからエディタを起動するときにエディタの新しいインスタンスを起動するかわりに emacsclient が使われるようになります。外部エディタを使用するプログラムとしてメールプログラム (メッセージを編集するため) や Git (コミットメッセージを編集するため)、less ({{ic|v}} コマンドで表示されたファイルを編集するため) などが存在します。emacsclient の {{ic|-n}} ({{ic|--nowait}}) オプションは使用しないでください。基本的にプログラムはエディタが終了したときに編集が完了したと認識するためです。

GUI の Emacs のスタートメニューエントリなども emacs ではなく emacsclient が使われるように変更することを推奨します。

== クイックスタート ==

Emacs は複雑ですが、そのカスタマイズと拡張性のレベルによってもたらされる利益を理解し始めるのにそう時間はかからないでしょう。さらに、幅広い拡張を利用することで Emacs はあらゆる種類の文章編集のための強力な環境に姿を変えることができます。

Emacs には素晴らしいチュートリアルが内蔵されており、スプラッシュ画面の最初のリンクをクリックしてアクセスできます。メニューから ''Help->Emacs Tutorial'' を選択するか 'F1' の後に 't' を押して下さい。このページは Emacs を始めるのに追加的なリソースになるように書かれています。

初心者にもエキスパートにも役立つ、リファレンスカードのセットも Emacs に含まれています、{{ic|/usr/share/emacs/<version>/etc/refcards/}} を見て下さい (<version> はあなたの emacs のバージョンに置き換えて下さい)。

=== 基本的な用語と慣習 ===

始めは慣れないと思うかもしれませんが Emacs にはいくつか特別な用語法と約束事があり、必要に応じて紹介していきます。ただ、Emacs を使うにあたって当然知ってるべきとされるような、基本的な用語についてはあらかじめ説明しておいたほうが良いでしょう。

真っ先に知るべきは''バッファ''の概念です。バッファは Emacs の中のデータを表します。例えば、Emacs でファイルを開いたとき、ディスクからファイルから読み込まれてバッファに中身が保存され、バッファを編集して後でディスクに上書き保存することができます。バッファはテキストに限られず、画像やウィジェットなども含めます。作業中でもバッファでアプリケーションを表示することすらできます。こういう考え方もできます: ディスク上のデータは'ファイル'であり、一方、Emacs 上のデータは'バッファ'である。

Emacs におけるキーシーケンスの決まり事も見慣れないかもしれません。即ち:

'''C-x''' は Control-x を示します

'''M-x''' は Meta-x を示します

{{Note|'Meta' は多くの場合 Alt キーに相当します。また、Esc キーを使うことも可能です。}}

例えば、Emacs を終了するには次のキーシーケンスを使います: '''C-x C-c'''。これは "Control を押しながら 'x' を押す。手を離す。Control を押しながら 'c' を押す" と読み替えることができます。Emacs にはメニューバーが存在しますが、キーシーケンスを使いこなせるように練習することを推奨します。以下から、Emacs で使われるキーバインディングと慣習について説明します。

=== 移動 ===

カーソルの移動は他のグラフィカルエディタとよく似ています。マウスや方向キーを使ってカーソルの位置 (Emacs では''ポイント''と呼ばれます) を変更することができます。一般的な移動コマンドは方向キーで出来ますが、Emacs には他にも便利なバインディングが存在します。1文字先に移動するには '''C-f''' を使用して、1文字前に移動するには '''C-b''' を使用します。'''C-n''' と '''C-p''' でそれぞれ次の行と前の行に移動できます。基本的に、マウスや方向キーを使うよりもこれらのキーシーケンスを使うことが推奨されています。

当然、Emacs には、単語や文単位で移動できる、もっと高度な移動コマンドが用意されています。'''M-f''' は1単語先に移動して '''M-b''' は1単語前にポイント移動します。同じく、'''M-e''' は1文先にポイント移動して '''M-a''' は前に戻ります。

ここまでは、紹介した全ての移動コマンドはポイントに関連しています。'''M-<''' を使うことでバッファの最初にポイントを移動することができ、逆に、'''M->''' はバッファの最後に移動します。特定の行番号にポイントを移動するには、'''M-g g''' を使います。'''M-g g''' は移動したい行番号を尋ねます。また、現在の行の先頭と末尾に移動するには、'''C-a''' あるいは '''C-e''' を使って下さい。

{{Note|上記のコマンドを含む全てのコマンドのキーバインドは、現在有効になっているモードによって''多少''ながら変わってくる可能性があります。しかしながら、同一の機能を実行するのにコマンドを置き換えることはあまりありません。詳しくは[[#モード|モード]]を見て下さい。}}

=== ファイルとバッファ ===

Emacs にはファイルを操作するためのコマンドが用意されています。このセクションでは最もよく使われるコマンドを紹介します。ファイルを開くには '''C-x C-f''' を使います (Emacs ではこのコマンドを 'find-file' と呼びます)。指定されたファイルが存在しなかった場合、Emacs は空のバッファを開きます。バッファを保存するとバッファの中身が入ったファイルが作成されます。'''C-x C-s''' を使うことでバッファを保存できます。別のファイル名でバッファを保存するには、'''C-x C-w''' を使って下さい (this is a mnemonic for the command 'write-file')。新しいファイル名が尋ねられ、ディスクにファイルが書き込まれます。'''C-x s''' で全てのバッファを保存することも可能です。最後に保存されていた状態からバッファに変更が加えられている場合、保存を実行するかどうか訊くプロンプトが表示されます。

{{Note|ファイルに対応するバッファが既に開かれている場合 '''C-x C-f''' はディスクからファイルを読み込みません。ディスクからファイルを再度読み込むには、(1) まずバッファを閉じて ('''C-x k''')、それからファイルを開くか ('''C-x C-f''') あるいは (2) '''M-x revert-buffer''' を使ってディスク上のデータに戻して下さい。それか (3) '''C-x C-v''' でファイルを現在のバッファにロードするか (4) '''C-x RET r RET''' で同一コードでファイルを再読み込みしてください。}}

"find-file" や "write-file" などのインタラクティブなコマンドでは Emacs ウィンドウの一番下の行に入力が求められます。この行のことは''ミニバッファ''と呼びます。ミニバッファでは基本的な編集コマンドを使うことができ、多くの *nix シェルで利用できるのと同じようなタブ補完機能があります。'''<TAB>''' を2回連続で押すと補完リストが表示され、マウスを使ってリストから補完候補を選択することも可能です。ミニバッファでの補完はコマンドやファイル名など様々な形で使えます。

ミニバッファには履歴機能も存在します。前に入力したコマンドは '''Up Arrow''' または '''M-p''' を使うことで再呼び出しできます。

ミニバッファは '''C-g''' を押すことでいつでも終了できます。

ファイルを複数開いたら、ファイルを切り替える手段が必要です。Emacs 内に既に存在するバッファにファイルを開くと、Emacs はそのバッファに切り替えます。しかしながらこれは効率的とは言えません。Emacs には表示するバッファを選択する '''C-x b''' が存在します (タブ補完が使えます)。存在しないバッファの名前を入力すると、その名前で新しいバッファが作成されます。

{{Note|前のバッファに切り替えるには '''C-x b <RET>''' を使います。前のバッファがデフォルトだからです。}}

全てのバッファのリストを '''C-x C-b''' で表示することができます。バッファが必要なくなったときは '''C-x k''' で削除することが可能です。

=== 編集 ===

Emacs には多数の編集コマンドが存在します。まだ紹介していない最も重要なコマンドはおそらく 'undo' でしょう。'''C-_''' または '''C-/''' で実行することができます。基本的に移動コマンドには対応する削除コマンドが存在します。例えば '''M-<backspace>''' で後方の単語を削除することができ、{{ic|M-d}} で前方の単語を削除できます。行末または文章の終わりまで削除するにはそれぞれ {{ic|C-k}} または {{ic|M-k}} を使います。

1行は80文字を超えていはいけないという経験則が存在します。1行の長さを長くしすぎないことで、特にウィンドウの縁で改行してしまうような場合に、可読性を維持することができます。改行の自動挿入 (または削除) は Emacs では詰め込み (''filling'') と呼ばれます。{{ic|M-q}} を使うことでパラグラフを折り返させることができます。

文字列と単語はそれぞれ {{ic|C-t}} と {{ic|M-t}} で置き換えることが可能です。例えば {{ic|Hello World!}} を {{ic|World! Hello}} と置き換えられます。

単語の大文字小文字はすぐに修正できます。{{ic|M-l}} は単語を小文字に変換し ({{ic|HELLO}} は {{ic|hello}})、{{ic|M-u}} は単語を大文字に変換します ({{ic|hello}} は {{ic|HELLO}})。そして {{ic|M-c}} は単語の最初の文字を大文字にして他の文字は小文字にします ({{ic|hElLo}} は {{ic|Hello}})。

=== kill と yank とリージョン ===

リージョンとは、2点間にあるテキストです。2点のうちの1つは、''マーク'' と呼ばれ、もう1つはポイントです。 '''C-<SPC>''' によってマークの位置がセットされ、その後でポイントが移動することでリージョンが作られます。GNU Emacs 23.1 以降、リージョンはデフォルトで可視化されます。リージョン上で動作する多くのコマンドがあり、もっともよく使われるコマンドに ''killing'' コマンドがあります。

Emacs では、カット＆ペーストはそれぞれ、''kill'' と ''yank'' と呼ばれます。1文字以上の文字を削除するコマンド（ '''C-k''' や '''M-d''' といった上で記述したコマンドも含めて）は、実際にテキストをカットし、''kill-ring'' として知られるものに追加します。kill-ring は、単に kill されたテキストのリストです。kill-ring は、デフォルトでは直近60個の kill されたテキストを保存します。kill に成功すると、リストの先頭に接続されて保存されます。

'''C-w''' と '''M-w''' によって、それぞれリージョンの kill とコピーができます。

kill されたテキストをバッファに挿入する（'yanking' として知られます）ためには、'''C-y''' を使います。 '''C-y''' は、複数回使用することで、繰り返しテキストを yank できます。前述の通り、以前の kill は、リストに保存されます。しかし、'''C-y''' は、そのうち最初のものしか取得しません。それより前の kill は、'''M-y''' によってアクセスすることができます。これによって、'yank' で挿入されたテキストをリストの先頭に移動させます。 '''M-y''' は '''C-y''' に続けて使われなければならず、kill-ring をたどるために何度でも使えます。

=== 検索と置換 ===

文字列を検索することは、テキストの編集において一般的な作業です。検索は、'''C-s''' (後方検索) または '''C-r''' (前方検索) によって実行されます。これらのコマンドは、検索する文字列を入力するプロンプトを表示します。検索は1文字入力するごとに実行され、タイプごとに次に（あるいは前に）一致した文字列にマッチします。次の検索結果に行くには C-s を、前の検索結果に行くには C-r を押します。もし探しているものが見つかったのであれば、'''<RET>''' を押すことで検索を終了できます。一方、検索を開始した場所に戻りたければ '''C-g ''' を押します。

いったん検索が完了すると (たとえば '''C-g''' 等で中断していない場合)、検索された文字列は、次の検索のデフォルト検索文字となります。検索された文字を使用するには、後方検索なら '''C-s C-s''' , 前方検索なら '''C-r C-r''' をそれぞれ押します。

I-search には、いくつかの有用なコマンドがあります。 '''M-e''' によって、検索文字列の編集が可能です。 '''M-c''' によって、大文字小文字を区別するか、しないかを切り替えることができます。

正規表現検索は、検索の開始コマンド以外、上述の検索と同様に動作します。 '''C-M-s''' あるいは '''C-M-r''' によって、それぞれ正規表現による後方検索、前方検索を開始します。いったん正規表現検索を開始すると、文字列検索と同様に '''C-s''' と '''C-r''' を後方検索、前方検索に使用することができます。

検索に加え、文字列や正規表現を置換することができます（それぞれ '''M-%''' および '''C-M-%''' によって実行されます）。元のテキストと変換後のテキスト用にプロンプトが表示され、それからハイライトされた一致箇所に対する動作のために別のプロンプトが表示されます。多くのオプションが使用できますが（使用できるオプションの完全なリストは '''?''' を押してください）、もっとも一般的に使われるのは、変換を実行する '''y''' と、スキップする '''n''' 、そしてハイライトされている文字列を含め、以降すべての一致に対して変換する '''!''' になります。

=== 前置引数 ===

'''C-u''' は、'universal-argument' コマンドに対応づけられています。'universal-argument' を渡すことによって、より多くの情報をコマンドに提供できます（この情報を '前置引数' と呼びます）。たとえば

C-u 80 %

は、%記号の行を挿入します。また、

C-u 4 M-d

は4単語を削除します。この場合、'''M-d''' によって実行されるコマンドへ、要求する単語の数を渡しています。

universal argument は、'''M-<数字>''' によって少し早く入力することができます。

M-80 %

=== インデント ===

インデントは、1行をインデントする '''<TAB>''' やリージョンをインデントする '''C-M-\''' によって実行されます。リージョンが有効（''たとえば''ハイライトされている）場合、'''<TAB>''' はリージョンもインデントします。

テキストがどのようにインデントされるかは、正確には有効になっている ''メジャーモード'' に依ります。メジャーモードは、しばしば特定の種類のテキストをインデントするときに特化したインデントスタイルを定義します。（より詳しくは [[#モード|Modes]] を見てください。）

いくつかの場合、ファイルタイプに対して適したメジャーモードがありません。その場合、手動でのインデントが必要になります。リージョンを作成（ [[#kill と yank とリージョン|kill と yank とリージョン]] 参照）し、'''C-u <n> C-x <TAB>''' でインデントを実行してください。（ここで、'<n>' はリージョンに含まれるテキストがインデントされる列の数です。）例えば、

リージョンのインデントを4列追加する:

C-u 4 C-x <TAB>

リージョンのインデントを2列減らす:

C-u -2 C-x <TAB>

=== ウィンドウとフレーム ===

Emacs は、多くのファイルを同時に編集するために便利であるよう設計されています。これは、Emacs のインタフェースを3つの階層にわけることで実現されています。つまり、すでに紹介済みのバッファ、''ウィンドウ'' と ''フレーム'' です。

'''ウィンドウ''' とは、Emacsでバッファを表示している場所のことです。1つのウィンドウは、一度に1つのバッファしか表示できません。しかし、1つのバッファは複数のウィンドウに表示できます。それぞれのウィンドウの下には、''モードライン'' があります。モードラインには、そのバッファの情報が表示されています。

'''フレーム''' とは、Emacs の"ウィンドウ"（一般的な意味。たとえば最近のデスクトップパラダイムの意味での 'ウィンドウ'）です。フレームには、タイトルバー、メニューバー、1つ以上の 'ウィンドウ' (Emacs 的な意味。たとえば上で定義した 'ウィンドウ') が含まれます。

以降では、これらの単語は Emacs に存在するものでの定義として使用します。

ウィンドウを水平あるいは垂直に分割するには、それぞれ '''C-x 2''' あるいは '''C-x 3''' を使います。これは、現在のフレームにもう1つのウィンドウを生成する効果があります。複数のウィンドウ間を巡回するには、'''C-x o''' を使用します。

ウィンドウ分割の反対は、ウィンドウを削除することです。現在のウィンドウを削除するには '''C-x 0''' を使い、現在のウィンドウ以外を削除するには '''C-x 1''' を使います。

ウィンドウと同様に、フレームも生成や削除が可能です。 '''C-x 5 2''' によってフレームを生成できます。 '''C-x 5 0''' によって現在のフレームを削除し、'''C-x 5 1''' によってr現在のフレーム以外のすべてのフレームを削除します。

{{Note|これらのコマンドはバッファには影響しません。たとえば、ウィンドウを削除しても表示されているバッファは kill されません。}}

=== モード ===

Emacs モードは Emacs Lisp で書かれた拡張であり、接続されているバッファの挙動を制御します。大抵の場合、インデントやシンタックスハイライト、テキストを編集するときのキーバインドを提供します。洗練されたモードは Emacs を完全な IDE (統合開発環境) に変貌させます。Emacs は基本的にファイルの拡張子でモードをロードすべきか判断します。

シェルスクリプトを編集するのに役立つモードとして sh-mode, line-number-mode, column-number-mode が存在します。同時に使用することができ、以下のコマンドで呼び出します:

'''M-x sh-mode <RET>'''

'''M-x column-number-mode <RET>'''

line-number-mode はデフォルトで有効になっていますが、コマンドを再度実行することでオンとオフを切り替えられます:

'''M-x line-number-mode <RET>'''

sh-mode は、''メジャーモード'' の1つです。メジャーモードは Emacs を調整し、時には、特定の種類のテキストの編集用に特別なコマンドを提供します。それぞれのバッファでは、メジャーモードは1つだけが有効です。シンタックスハイライトやインデントサポートに加えて、sh-mode はシェルスクリプトを書く助けになるいくつかのコマンドを定義しています。以下に、それらの内のいくつかを示します。

'''C-c (''' 関数定義を挿入する

'''C-c C-f''' 'for' ループを挿入する

'''C-c TAB''' 'if' 文を挿入する

'''C-c C-w''' 'while' ループを挿入する

'''C-c C-l''' 1 から n までの番号付きループを挿入する

'line-number-mode' と 'column-number-mode' は''マイナーモード''です。マイナーモードはメジャーモードを拡張することができ、同時に任意の数のマイナーモードを有効にできます。

=== マニュアル ===

Emacs を本当にマスターしたいのであれば、一番よく読むべき文章はやはり公式マニュアルです:
* Emacs: 完全な Emacs ユーザーマニュアル
* Emacs FAQ
* Emacs Lisp Intro: プログラミング言語を使用したことがない場合
* Elisp: プログラミング言語をよく知っている場合

これらは、 [http://www.gnu.org/software/emacs/manual/ GNU.org] から PDF として入手できます。あるいは Emacs 自身にて組み込みの 'info' リーダー '''C-h i''' を用いて直接読むこともできます。本を選択するには '''m''' を押してください。

ユーザーの幾人かは、'info' で読むことを好みます。便利なショートカットであり、段落はウィンドウ幅に調整され、フォントは現在の画面解像度に調整されるためです。何人かは目に優しいと気づいています。最後に、本の内容を任意の Emacs バッファへ簡単にコピーでき、さらに例示されている Lisp コードを直接実行することさえできます。

'''info''' 本について、もっとよく知りたいなら、'''C-h i m info <RET>''' を実行してください。
info モードで '''?''' を押すと、ショートカットの簡易リストが表示されます。

== カスタマイズ ==

Emacs は {{ic|~/.emacs}} を編集するか '''M-x customize''' を使うことで設定をすることができます。このセクションでは手動で {{ic|~/.emacs}} を編集する方に焦点をあて、いくつかのカスタマイズ例を示すことで、一般的な Emacs の設定をデモンストレーションします。customize コマンドは調整を行うためのシンプルなインターフェイスを提供しますが、おそらく Emacs に慣れてくるにつれて制約を感じるようになるでしょう。

All of the examples here can be performed while Emacs is running. To evaluate the expression within Emacs, use:

'''C-M-x''' with point anywhere within the expression.

or

'''C-x C-e''' with point following the last ')'

For some users, typing 'yes' and 'no' in prompts can quickly become tiring. To instead use the 'y' and 'n' keys at these prompts:

(defalias 'yes-or-no-p 'y-or-n-p)

カーソルの点滅を止めるには、次を使用:

(blink-cursor-mode -1)

同じく、前のセクションにある column-number-mode を有効にするには:

(column-number-mode 1)

The similarities between the previous two commands are not a coincidence: blink-cursor-mode and column-number-mode are both minor-modes. As a rule, minor-modes can be enabled given positive argument or disabled with a negative argument. Should the argument be omitted, the minor-mode will be toggled on/off.

Here are some more examples of minor-modes. The following will disable the scroll bars, menu-bar and tool-bar, respectively.

(scroll-bar-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)

The variable, 'auto-mode-alist', can be modified to change the major-mode used by default for certain file names. The following example will make the default major-mode for '.tut' and '.req' files 'text-mode'.

(setq auto-mode-alist
(append
'(("\\.tut$" . text-mode)
("\\.req$" . text-mode))
auto-mode-alist))

Settings can also be applied on a per-mode basis. A common method for this is to add a function to a ''hook''. For example, to force indentation to use spaces instead of tabs, but only in text-mode:

(add-hook 'text-mode-hook (lambda () (setq indent-tabs-mode nil)))

Similarly, to only use spaces for indentation everywhere:

(setq-default indent-tabs-mode nil)

Keybindings can be adjusted in two ways. The first of which is 'define-key'. 'define-key' creates a keybinding for a command but only in one mode. The example below will make '''F8''' delete any whitespace from the end of each line of a 'text-mode' buffer:

(define-key text-mode-map (kbd "<f8>") 'delete-trailing-whitespace)

The other method is 'global-set-key'. This is used to bind a key to a command everywhere. To bind 'query-replace-regexp' ('''C-M-%''') to '<f7>'.

(global-set-key (kbd "<f7>") 'query-replace-regexp)

Binding a command to an alternate key does not replace any existing bindings. Which is to say, 'query-replace-regexp' would be bound to both '''F7''' and '''C-M-%''' after the above example.

Almost anything within Emacs can be configured. Browsing through the [http://emacswiki.org/ Emacs Wiki] should give a solid place to start.

=== マルチ設定 ===

複数の設定を使い、Emacs にどれか一つをロードさせることができます。

例えば、2つの設定ファイルを定義してみましょう。

{{hc|.emacs|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/plugins" nil t)
(load "~/.emacs.d/theme" nil t)
}}

This is the full configuration we load for the daemon. But the ''plugins'' file is huge and slow to load. If we want to spawn a new Emacs instance that does not need the ''plugins'' features, it can be cumbersome to load it everytime in the long run.

{{hc|.emacs-light|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/theme" nil t)
}}

And now we launch Emacs with
emacs -q -l ~/.emacs-light
You can create an alias to ease the call.

=== ローカル・カスタム変数 ===

You can define variables in your configuration file that can be later one modified locally for a file.

(defcustom my-compiler "gcc" "Some documentation")

Now in any file you can define local variables in two ways, see [https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html the manual for complete details ]

* Using {{ic| M-x add-file-local-variable-prop-line}}, which adds a commented line at the beginning similar to:
// -*- my-compiler:g++; mode:c++ -*-
* Or you can use {{ic| M-x add-file-local-variable}} to add lines near the end of the file:
// Local Variables:
// my-compiler: g++
// mode: c++
// End:

Note that for the values to take effect, you will need to call {{ic|M-x revert-buffer}}.

Custom variables are considered unsafe by default. If you try to open a file that contains local variable redefining custom variables, Emacs will ask you for confirmation.

You can declare the variable as secure, thus removing the Emacs prompt for confirmation. You need to specify a predicate that any new value has to verify so that it can be considered safe.

(defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

In the previous example, if you attempt to set anything else than a string, Emacs will consider it insecure.

=== カスタムカラーとテーマ ===

''face'' を使うことで簡単に色をカスタマイズすることができます:
(set-face-background 'region "color-17")
(set-face-foreground 'region "white")
(set-face-bold-p 'font-lock-builtin-face t )

You can have let Emacs tell you the name of the face where the point is. Use the ''customize-face'' function for that. The facility will show you how to set colors, bold, underline, etc.

Emacs in console can handle 256 colors, but you will have to use an appropriate terminal for that. For instance URxvt has support for 256 colors. You can use the ''list-colors-display'' for a comprehensive list of supported colors. This is highly terminal-dependent.

=== SyncTeX サポート ===

Emacs は強力な LaTeX エディタです。LaTeX モードを必要に応じて自由に編集・作成することができます。

Still, there might be some challenges, like SyncTeX support. First you need to make sure your TeX distribution has it. If you installed TeX Live manually, you may need to install the ''synctex'' package.
# umask 022 && tlmgr install synctex

SyncTeX support is viewer-dependent. Here we will use Zathura as an example, so the code needs to be adapted if you want to use another PDF viewer.

(defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
"PDF Viewer for TeX documents. You may want to fork the viewer
so that it detects when the same document is launched twice, and
persists when Emacs gets closed.

Simple command:

zathura --fork

We can use

emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

to reverse-search a pdf using SyncTeX. Note that the quotes and double-quotes matter and must be escaped appropriately."
:safe 'stringp)

Here we define our custom variable. If you are using AucTeX or Emacs default LaTeX-mode, you will have to set the viewer accordingly.

Now open a LaTeX source file with Emacs, compile the document, and launch the viewer. Zathura will spawn. If you press {{ic|Ctrl+Left click}} Emacs should place the point at the corresponding position.

=== Systemd ファイルのシンタックスハイライト ===

[https://github.com/holomorph/systemd-mode systemd-mode] を使うことができます。

もしくは init ファイルに以下を追加することで、簡単に emacs で systemd のファイル (サービスやタイマーなど) をカラー表示できます:

(add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

=== emacs-nox のクリップボードサポート ===

emacs-nox で [[Xorg]] クリップボードを使うには、{{Pkg|xclip}} を[[インストール]]して以下の関数を {{ic|~/.emacs}} に追加してください [https://lists.gnu.org/archive/html/help-gnu-emacs/2014-08/msg00189.html]:

{{bc|1=
;; use xclip to copy/paste in emacs-nox
(unless window-system
(when (getenv "DISPLAY")
(defun xclip-cut-function (text &optional push)
(with-temp-buffer
(insert text)
(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
(defun xclip-paste-function()
(let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
(unless (string= (car kill-ring) xclip-output)
xclip-output )))
(setq interprogram-cut-function 'xclip-cut-function)
(setq interprogram-paste-function 'xclip-paste-function)
))
}}

{{Tip|以下を追加することでターミナルマウスサポートも有効にできます:
{{bc|1=
;; xterm mouse support
(require 'mouse)
(xterm-mouse-mode t)
}}
[http://www.opensource.apple.com/source/emacs/emacs-51/emacs/lisp/mwheel.el mwheel.el] を参照。}}

== ヒントとテクニック ==

前のセクションでは基本的な編集コマンドを説明していますが、それだけでは Emacs の可能性はわかりません。このセクションではより高度なテクニックや機能を紹介します。

ただし全てを説明するとなると長くなりすぎます。そのためこのセクションはあくまで Emacs の雅やかな機能をいくつか''デモ''するだけにとどめます。

全ての機能の詳細な説明は[[#ドキュメント|ドキュメント]]を見て下さい。

=== TRAMP ===

TRAMP (Transparent Remote Access, Multiple Protocols) は多数のプロトコルで、リモートファイルに透過的にアクセスすることができる拡張です。ファイル名を入力するときに、特定の形式を入力すると TRAMP が呼びだされます。例:

{{ic|/etc/hosts}} を root 権限で開く前に root のパスワードを要求するには:

C-x C-f /sudo::/etc/hosts

SSH で 'myhost' に 'myuser' として接続して {{ic|~/example.txt}} ファイルを開くには:

C-x C-f /ssh:myuser@myhost:~/example.txt

TRAMP のパスは '/[protocol]:[[user@]host]:<file>' という形式で指定します。TRAMP がサポートしているのは上記の例に限りません。詳しくは TRAMP の info マニュアルを参照してください。マニュアルは Emacs に付属しています。

=== キーボードマクロとレジスタ ===

This section will provide a practical demonstration of the use of a couple of more powerful editing features. Namely, ''keyboard macros'' and ''registers''.

The aim will be to produce a listing of a series of characters and their corresponding position in this list. While it is possible to format each of them by hand, this would be slow and error-prone. Alternatively, some of Emacs' more powerful editing functionality could be leveraged. Before describing a solution, some details behind the techniques which will be used follow.

The first feature which will be introduced is ''registers''. Registers are used to store and retrieve a variety of data types ranging from numbers to window configurations. Each register is given a name of a single character: this character is used to access the register.

The other which will be demonstrated is ''keyboard macros''. A keyboard macro stores a sequence of commands so they can be easily repeated later. These changes will now be performed step-by-step.

Starting with a buffer containing our set of characters:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

Prepare a register by invoking the `number-to-register' command ('''C-x r n''') then storing the number '0' in register 'k':

C-x r n k

With point at the beginning of the buffer, start a keyboard macro ('''C-x (''') and begin to format the characters:

C-x ( C-f M-4 .

Insert ('''C-x r i''') and increment ('''C-x r +''') the register 'k'. The prefix argument ('''C-u''') is used to leave point positioned after the inserted text:

C-u C-x r i k C-x r + k

Complete the formatting by inserting a newline. Emacs can then repeat that process, beginning from the point where we started defining the keyboard macro, for the rest of the characters. '''C-x e''' completes then invokes the keyboard macro. The prefix argument, '''M-0''', causes the macro to repeat until it comes across an error. In this case it aborts once it reaches the end of the buffer.

<RET> M-0 C-x e

The result:

A....0
B....1
C....2
[...]
x....49
y....50
z....51

If you want to save your macro for later use, you must give it a name and save it to your configuration file:
name-last-kbd-macro
insert-kbd-macro

All defined macros are stored in the macro ring. To cycle between macros, use
'''C-x C-k C-n''' next macro
'''C-x C-k C-p''' previous macro

You can also use registers to save virtually anything.

'''C-x r SPC''' Copy current point (position) to register
'''C-x r w''' Copy current window configuration to register.
'''C-x r j''' Restore register.

So if you often work with windows side by side, for different project, you can save the configuration for the different projects and easily switch from one view to the other.

You can list used registers with the '''list-registers''' command.

=== 正規表現 ===

Emacs Manual より: "正規表現 (''regexp'' と略す) とは、一致する可能性がある一連の (無限個でもよい) 文字列を表現するパターンである"。このセクションでは正規表現自体には深くは立ち入りません (単純に説明しきれない)。そのかわり正規表現のパワーを簡単にデモンストレーションします。詳しい説明は Emacs Manual の [https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html#Regular-Expressions Regular Expressions] セクションを見て下さい。

Given the same scenario presented above: A list of characters which are to be formatted to represent their respective position in the list. (see [[#キーボードマクロとレジスタ|Keyboard macros and registers]]). Again, starting with a buffer containing.

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

At the beginning of the buffer, use '''C-M-%''' (if the key-sequence is difficult to perform, it may be more comfortable to use '''M-x query-replace-regexp'''). At the prompt:
$.$
which simply matches one character. Then, when prompted for the replacement:
\1....\#^J
{{Note|'^J' represents where a newline should be placed, it should not be entered into the prompt. The newline must instead be inserted literally using '''C-q C-j'''.}}
The replacement expression reads: "Insert the matched text between the first set of parentheses (in this case, a single character), followed by 4 periods then insert an automatically incremented number followed by a newline.

Finally, press '''!''' to apply this across the entire buffer. All of the formatting that was performed in the previous section was performed with a single regexp replacement.

=== 矩形選択 ===

先進的なテキストエディタが当然備えているべき強力な機能として、テキストを矩形で選択・編集できるというのがあるでしょう。

Emacs でも矩形選択は可能です。'''C-SPC''' で普通にテキストを選択してから、複数の矩形コマンドを使うことができます。

'''C-x r t''' Replace rectangle with text.
'''C-x r k''' Kill (and save in kill-ring) rectangle.
'''C-x r y''' Yank rectangle.
'''C-x r o''' Blank out rectangle.

たとえハイライトされていても、上記のコマンドが矩形の外のテキストに影響を与えることはありません。

=== ブックマーク ===

Emacs は開いたファイルのリストを記録できます。

'''C-x r m''' カレントバッファをブックマークに追加。
'''C-x r b''' ブックマークからバッファを開く。
'''C-x r l''' ブックマークの確認。

=== Elisp インタプリタ ===

Evaluate an elisp expression using '''eval-last-sexp''' ('''C-x C-e'''). Emacs always spawns a '''*scratch*''' buffer when started. It will not be saved to disk, feel free to add any text / code you want. It is especially useful for elisp evaluation. Note that this buffer starts using '''lisp-interaction-mode''' by default.

Alternatively, Emacs provides a top-level elisp interpreter with the '''ielm''' command.

=== スマートなウィンドウ切り替え ===

長い間使っていると '''C-x o''' による伝統的なウィンドウ切り替えは面倒かもしれません。'''windmove''' コマンドはもっと便利にウィンドウを切り替えることができます。{{ic|Shift}} を押しながら方向キーでウィンドウを指定するだけです。

windmove キーを有効にするには、設定ファイルに以下を記述してください:

{{hc|~/.emacs|
(when (fboundp 'windmove-default-keybindings)
(windmove-default-keybindings))
}}

=== シェルコマンドの実行 ===

Use '''M-!''' to call an external command. Use a prefix argument ('''C-u M-!''') to output the result to current buffer at point.

You can use '''M-|''' on a region to use it as input for a command. For instance

'''C-u M-| sort -u RET'''

will sort region, remove duplicates and replace the region with the result.

=== シェルバッファ ===

You can spawn a shell buffer and execute commands just like you would do in any terminal.
A classic shell buffer can be spawned with the '''shell''' command.

Emacs features a very powerful shell entirely written in Emacs Lisp, the '''eshell'''. The major advantage over shells like csh or zsh is that the native shell language is elisp itself. So you can use all advanced feature of elisp for your shell functions.

=== 対応する括弧のハイライト ===

'''show-paren''' モードを使うことができます。デフォルトでは、対応する括弧が表示されるまで少し遅延がありますが、'''show-paren-delay''' を 0 に設定することでなくすことができます。

{{hc|~/.emacs|
(setq show-paren-delay 0)
(show-paren-mode 1)
}}

=== スペルチェック ===

辞書を選択するには:
'''M-x ispell-change-dictionary'''

To check a single work use '''M-$'''.
You can start checking the whole buffer with
'''M-x ispell-buffer'''

You can enable on-the-fly spell checking by enabling the '''flyspell-mode'''. For source code files you can restrict the mode to comments by using the '''flyspell-prog-mode''' instead. You will also need the ''aspell'' package for spelling in Emacs. There are corresponding packages for each language, so for English, you'd also want ''aspell-en'' (as well as ''aspell'').

=== テーブル ===

Emacs comes with some powerful functions to handle and generate tables for various languages. Let's show an example.

Fruits Quantity
Apples 5
Melons 2

Now select the previous content in a region, and run
table-capture

Use two spaces for the column delimiter, and a line break ('''C-q C-j''') for the row delimiter.
This will lead to the following result.

+------+--------+
|Fruits|Quantity|
+------+--------+
|Apples|5 |
+------+--------+
|Melons|2 |
+------+--------+

You can revert back the operation with
table-release
There is a lot of handy ''table-*'' functions, like ''table-insert-row'', ''table-span-cell'', ''table-widen-cell'', etc.

Finally, the ultimate purpose of the ''table'' functions is to convert it to the desired markup language.
Use the ''table-generate-source'' for that.
For LaTeX, the previous table would result in

% This LaTeX table template is generated by emacs 24.2.1
\begin{tabular}{|l|l|}
\hline
Fruits & Quantity \\
\hline
Apples & 5 \\
\hline
Melons & 2 \\
\hline
\end{tabular}

Using the table mode you can also do some spreadsheet work like sum on rows and columns, but you will quickly find it limited. Besides it is quite slow. Have a look at the [[#予定表、スプレッドシート、文章作成|org-mode]] for much more powerful possibilities.

=== 予定表、スプレッドシート、文章作成 ===

Emacs can offer powerful office features thanks to the famous and powerful [http://orgmode.org/ Org mode]. This mode is part of the standard Emacs distribution.

Org mode is originally a powerful TODO and Agenda agent, but has quickly evolved to a much wider set of features.
There is simply too much to tell about Org that we cannot aford even to skim over all the features. So we will only whet your appetite with a few exemples.

Open a new file TODO.org file, Org mode should be loaded. If not, switch to it with '''M-x org-mode'''.
{{hc|TODO.org|
* First entry
** Subentry
Some comments
*** Subsubentry
* Second entry
- List item 1
- List item 2
}}

Now a few useful bindings.
* '''TAB''' to cycle-fold current entry.
* '''S-TAB''' to cycle-fold all entries.
* '''M-RET''' to start a new item on the same level as the current one.
* '''M-<left>''' and '''M-<right>''' to change level.
* '''M-<up>''' and '''M-<down>''' to move item together with all its subsections.
* '''S-<left>''' and '''S-<right>''' to change status. On list items it will change the item style.
* '''S-<up>''' and '''S-<down>''' to change priority.
* '''C-c ^''' to sort all subentries of the current entry.
* '''C-c .''' to add a timestamp to the current entry. Use {{ic|Shift}} and arrows to skip days or weeks. Use the mouse on the calendar or press {{ic|Enter}} on a specific day to choose it.

The spreadsheet features are very comprehensive. Let's give an excerpt from the manual:

{{bc|<nowiki>
Finally, just to whet your appetite for what can be done with the
fantastic `calc.el' package, here is a table that computes the Taylor
series of degree `n' at location `x' for a couple of functions.

|---+-------------+---+-----+--------------------------------------|
| | Func | n | x | Result |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x) | 1 | x | 1 + x |
| # | exp(x) | 2 | x | 1 + x + x^2 / 2 |
| # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 |
| * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3
</nowiki>}}
Org mode recognizes a table when the pipe '''|''' is the first non-whitespace character on line. In the previous text, no line was drawn. This is done automatically when '''TAB''' is pressed after an entry or the '''|-''' sequence. The result column was not written by hand neither, it is computed from the calc formula on the last line. Use '''C-u C-c C-c''' to recompute all values in a table.

There is also some handy row and column manipulation bindings like those for the TODO file. {{ic|Alt}} plus arrows will move columns and arrows.

For more in-depth details, refer to the official manual: '''C-h i m Org mode RET'''.

=== リファクタリングとスマート補完 ===

(Eclipse などの) IDE が大抵備えているプログラミング機能が必要な場合、[http://cedet.sourceforge.net/semantic.shtml Semantic] ツールが役に立ちます。Semantic は Emacs の標準ディストリビューションに含まれています。現在 C, C++, Scheme, Javascript, Java, HTML, Make がサポートされています。現在のサポート状況は [http://cedet.sourceforge.net/languagesupport.shtml CEDET のページ] で確認できます。

Open a file in your favorite programming language supported by Semantic and turn on the Semantic minor mode with
M-x semantic-mode
Semantic will work for a few seconds parsing the libraries included from your file (in C that would mostly be the standard library for instance).

==== 機能 ====

Once done, you can start using the great Semantic features:
;Smart completion
Press '''C-c , SPC''' to complete a symbol at point. If it is an argument, it will check for type correctness.

;Jump to symbol
Press '''C-c , j''' to prompt for a symbol and jump to its definition. You can use auto-completion with '''TAB'''. Use a capital '''J''' to search for symbol accross files.

;List symbol calls
Press '''C-c , g''' to prompt for a symbol and list the places where it is being referred to. You can use '''n''' and '''p''' to navigate through the resulting entries. Press '''RET''' to toggle details, and '''RET''' again on a reference to jump to it. Use a capital '''G''' in the first command to work across files.

;Refactoring
First list use of the symbol you want to refactor with the aforementioned command. Now press '''(''' to start defining a macro on the symbol. This is actually much more powerful than refactoring since you can apply any function to the symbol and even act on its surrounding symbols. Press '''C-x )''' to finish the macro and '''E''' to call it.

;Describe symbol
Call the following function to display details on a symbol.
semantic-ia-show-summary
This can be very useful for complexe data structures and function prototypes. There is no binding by default.

==== 設定 ====

Here follows a sample configuration for use of Semantic with all supported programming languages: an example binding and a display configuration.
;; Semantic with ghost display (allows M-n and M-p to browse completion).
(semantic-mode 1)
(define-key my-keys-minor-mode-map (kbd "C-c , d") 'semantic-ia-show-summary)
(setq semantic-complete-inline-analyzer-displayor-class 'semantic-displayor-ghost)

You can also add some specialization for a specific language. Here for C:
(add-hook
'c-mode-hook
(lambda ()
(local-set-key (kbd "M-TAB") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)))

==== 文献 ====

Emacs から直接 info マニュアルにアクセスすることが可能です: '''C-h i m Semantic RET'''。

=== Emacs を git のマージツールとして使う ===

By default, Git provides support for using Emacs' Emerge mode as a merge tool. However you may prefer the Ediff mode. Unfortunately this mode is not supported by git for technical reasons. There is still a way to use it by evaluating some elisp code upon emacs call.

{{hc|.gitconfig|<nowiki>
[mergetool.ediff]
cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

[merge]
tool = ediff
</nowiki>}}

Note that the command has to be on a single line.
In the above example, we launch a new instance of Emacs. You might want to use emacsclient for quicker startup; it is not recommended though since the Ediff call is not really clean: it could mess with your current Emacs session.

If you want an instant startup you can use the '''-q''' parameter. If you want to launch Emacs quickly while preserving at least a part of your configuration, you can call Emacs with
emacs -q -l ~/.emacs-light
where the light configuration file loads only what you need for Ediff.

See [http://kerneltrap.org/mailarchive/git/2007/7/1/250424 kerneltrap.org] and [https://stackoverflow.com/questions/1817370/using-ediff-as-git-mergetool stackoverflow] for more details on this trick and the Ediff issue.

=== Caps Lock キーを Control キーとして使う ===
いわゆる 'emacs 小指' にならないようにこちらの挙動を好むユーザーもいます。X で試用してみたいときは、次を実行:
$ setxkbmap -option 'ctrl:nocaps'

また、キーを'''交換'''するには、次を実行:
$ setxkbmap -option 'ctrl:swapcaps'

永続的に設定したくなったら、{{ic|.xinitrc}} ファイルに上のコマンドを追加してください。

リージョンを小文字から大文字にする必要がある場合は、デフォルトの {{ic|C-x C-u}} キーバインディングを使って下さい、{{ic|upcase-region}} 関数が呼び出されます。

Caps Lock がない場合は、両方の "Shift" にマッピングしてください:
$ setxkbmap -option "shift:both_capslock"

一部のデスクトップ環境にはキーボードのマッピングを変更するためのグラフィカルなツールが含まれています。例えば [[Plasma|Plasma 5]] ならシステム設定を開いて入力デバイスをクリックしてください。キーボードを選択して高度な設定タブから Caps Lock を Ctrl として使用するように設定できます。

== パッケージ ==

Emacs の機能はサードパーティ製のパッケージで拡張できます。公式にサポートされているパッケージマネージャとして {{ic|package.el}} が組み込まれていますが、Emacs のコミュニティメンバーによって書かれたパッケージマネージャが他にも存在します。{{ic|package.el}} は {{ic|package-archives}} 変数を使ってパッケージを検索します。デフォルトでは [https://elpa.gnu.org/ Emacs Lisp Package Archive (ELPA)] が含まれています。{{ic|M-x list-packages}} で Emacs が認識している全てのパッケージが列挙されたバッファが作成されます。マニュアル ({{ic|[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html (info "(emacs) Packages")]}}) にはさらに詳しい情報が載っています。

サードパーティ製のパッケージのアーカイブを追加することもできます。[https://melpa.org/ MELPA] が広く使われています。

人気の拡張の多くは {{ic|[community]}} リポジトリのパッケージや [[AUR]] からインストールできます。大抵の場合、パッケージの名前の前に 'emacs-' が付きますが (例: {{Pkg|emacs-lua-mode}})、常にそうなっているわけではありません (例: {{AUR|auctex}})。

{{Tip|Arch Linux の Wiki を編集している場合は [[Emacs Mediawiki]] パッケージが役に立ちます。}}

パッケージによっては設定ファイルに変更を加えないと機能が有効にならない場合があります。例えば、{{AUR|auctex}} をインストールしたときは、設定ファイルに以下を追加:

{{bc|
(load "auctex.el" nil t t)
(load "preview-latex.el" nil t t)}}

パッケージのソースコードや README で有効化する方法が書かれているはずです。

== トラブルシューティング ==

=== Emacs が 'Undefined color: "WINDOW_FOREGROUND"' というエラーメッセージで起動しない ===

{{Pkg|mcpp}} パッケージまたは {{Pkg|gcc}} パッケージをインストールする必要があります。''xrdb'' は [[X resources]] を前処理するために C のプリプロセッサ ''cpp'' を使用します。C のプリプロセッサがインストールされていない場合、''xrdb'' は C のプリプロセッサを実行しないため WINDOW_FOREGROUND が16進数のカラーコードに展開されません。

=== カラー出力の問題 ===

デフォルトでは、Emacs シェルはカラー表示に使われるエスケープシーケンスをそのまま表示してしまいます。つまり、カラー出力がされるべきところに変な記号が表示されます。

この問題を解決するには以下を {{ic|~/.emacs}} に記述してください:
(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

=== X ウィンドウでの文字の表示問題 ===

X ウィンドウで emacs を起動した時にメインウィンドウの文字が全て黒縁の白四角になってしまう場合 (対応するフォントがインストールされていない文字を表示したときと同じような記号)、{{Pkg|xorg-fonts-75dpi}} や {{Pkg|xorg-fonts-100dpi}} をインストールして X ウィンドウを再起動してください。

=== 起動が遅い ===

{{Tip|[[#systemd ユニットとして|systemd ユニットとして]] Emacs を起動する方法でも起動時間を短縮できます。}}

しばしば起動時間が遅くなる原因は2つあります。

どちらが原因なのか調べるために、次のコマンドで Emacs を実行してください:

$ emacs -q

このコマンドでも Emacs の起動が遅い場合、[[#不適切なネットワーク設定|不適切なネットワーク設定]]を参照してください。そうでない場合は、ほぼ確実に .emacs に問題があります。

* {{ic|/etc/hosts}} の設定が間違っていると、Emacs の起動が5秒以上遅くなることになります。詳しくはネットワーク設定ガイドの '[[ネットワーク設定#ホストネームの設定|ホストネームの設定]]' を見てください。

* A simple way to search for the cause is to comment-out (i.e., prefix lines with ';') suspect sections of your {{ic|~/.emacs}} (or {{ic|~/.emacs.d/init.el}}) then start Emacs again to see if there's any change. Keep in mind use of "require" and "load" can slow the startup down, especially when used with larger extensions. They should, as a rule, only be used when their target is either: needed once Emacs starts or provides little more than "autoloads" for an extension. Otherwise, use the 'autoload function directly. For example, instead of:

(require 'anything)

you might use:

(autoload 'anything "anything" "Select anything" t)

=== Cannot open load file: ... ===

The most common cause of this error is the 'load-path' variable not including the path to the directory within which the extension is located. To solve this, add the appropriate path to the list to be searched prior to attempting to load the extension:

(add-to-list 'load-path "/path/to/directory/")

When attempting to use packages for extensions and Emacs has been configured with a prefix other than '/usr', the load-path will need to be updated. Place the following in {{ic|~/.emacs}} prior to the instructions provided by the package:

(add-to-list 'load-path "/usr/share/emacs/site-lisp")

If compiling Emacs by hand, keep in mind that the default prefix is '/usr/local'.

=== デッドアクセントキーの問題: '<dead-acute> is undefined' ===

このバグについて Google で検索すると、次のリンクが見つかります:
https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

Explaining the problem: in recent versions of
b72
Emacs, the normal way to use accent keys doesn't work as expected. Trying to accent a word like 'fiancé' will produce the message above.

A way to solve it is just put the line above on your startup file, {{ic|~/.emacs}}:

(require 'iso-transl)

And no, it isn't a bug, but a feature of new Emacs versions. Reading the subsequent messages about it on the mail list, we found it (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html):

:''It seems that nothing is loaded automatically because there is a choice betwee iso-transl and iso-acc. Both seem to provide an input method with C-x 8 or Alt-<accent> prefix, but what you and I are doing is just pressing a dead key (^, ´, `, ~, ¨) for the accent and then another key to "compose" the accented character. And there is no Alt key used in this! And according to documentation it seems be appropriate for 8-bit encodings, so it should be pretty useless in UTF-8. I reported this bug when it was introduced, but the bug seems to be classified as a feature ... Maybe it's just because the file is auto-loaded though pretty useless. ''

=== C-M-% やその他のバインディングが emacs nox で動作しない ===

これはターミナルが Xorg よりも制限的であることが原因です。ただし、ターミナルによっては多くのバインディングを扱うことができることがあります。2つの解決法が考えられます:
* グラフィカルバージョンを使用する。
* サポートされているバインディングに変更する。

例:
{{hc|.emacs|
(global-set-key (kbd "C-M-y") 'query-replace-regexp)
}}

=== Emacs がフリーズする ===

シングルスレッドであるがゆえに、Emacs は様々な操作でブロックします。フリーズが発生する状況は様々です。例えば、Emacs はあなたからの入力を待っているのかもしれません (例えばあるフレームでミニバッファを開いているのに他のフレームで作業しようとしている場合など)。あるいは、Emacs は完了するまで時間のかかるコードを実行中なのかもしれません。あるいはバグを踏んだという可能性もあります。Emacs プロセスを殺さずに Emacs のブロックを解除する方法は複数存在します。

* {{ic|C-g}} を押してみる。Emacs が行っていることによっては、複数回押す必要があります。
* {{ic|ESC ESC ESC}} を押してみる。
* 他のターミナルで {{ic|killall -SIGUSR2 emacs}} を実行する。

=== Emacs-nox の出力が汚い ===

When working in a terminal, the color, indentation, or anything related to the output might become crazy. This is (probably?) because Emacs was sent a special character at some point which may conflict with the current terminal.
If this happens you can do {{ic|M-x redraw-display}}, which will redraw the terminal's display. If this problem happens frequently, you might want to bind the command to a key, e.g. by putting something like
(global-set-key (kbd "<f7>") 'redraw-display)
in your .emacs file.

Graphical Emacs does not suffer from this issue.

=== emacs ターミナルにおかしなエスケープ数字 (utf-8) が表示される ===

{{ic|.bashrc}} または {{ic|.zshrc}} で以下の変数をエクスポートしてください:

{{hc|1=~/.bashrc|2=
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export TERM=xterm-256color
}}

小文字の utf を使っていることがエラーの原因です (例: en_US.utf-8)。

利用可能なロケールは {{ic|locale -a}} で確認できます。

=== tmux で emacs を使っているときに Shift + 矢印キーが動作しない ===

まず [[tmux]] の設定で xterm-keys を有効にしてください:
{{hc|.tmux.conf|
setw -g xterm-keys on
}}

しかしながら、この設定は他のキーコンビネーションを破壊します。それを修正するために、以下を emacs の設定に記述します:
{{hc|~/.emacs|
(defadvice terminal-init-screen
;; The advice is named `tmux', and is run before `terminal-init-screen' runs.
(before tmux activate)
;; Docstring. This describes the advice and is made available inside emacs;
;; for example when doing C-h f terminal-init-screen RET
"Apply xterm keymap, allowing use of keys passed through tmux."
;; This is the elisp code that is run before `terminal-init-screen'.
(if (getenv "TMUX")
(let ((map (copy-keymap xterm-function-map)))
(set-keymap-parent map (keymap-parent input-decode-map))
(set-keymap-parent input-decode-map map))))
}}

詳しくは [https://github.com/tmux/tmux/blob/master/FAQ#L242 tmux FAQ] を参照。

=== KDE でウィンドウのリサイズがおかしい ===
KDE ユーザーには Emacs のウィンドウが正しくリサイズされないという現象がおこることがあります。リサイズした部分が透過されマウスでクリックしても下のウィンドウがクリックされます。この挙動を修正するには、KDE の GTK3 テーマを oxygen-gtk 以外のテーマに変更してください。例えば、{{Pkg|gtk3}} に含まれている Emacs テーマを使って下さい。

KDE で Emacs を完全に最大化するには、タイトルバーの Emacs アイコンをクリックして、More Actions > Special Window Settings を選択してください。そして "Size & Position" タブで "Obey geometry restrictions" を選択して、ドロップダウンメニューで "Force" を選んで右のラジオボタンで "No" を選んで下さい。

== 派生 ==

Emacs の実装は多数存在します。おそらく GNU/Emacs が一番ポピュラーです。

軽量な Emacs 互換のテキストエディタは Arch のリポジトリや [[AUR]] にあります。

=== mg ===

mg (旧名 MicroGnuEmacs) は C で書かれた軽量な Emacs の実装です。

{{Pkg|mg}} パッケージから入手できますが、上流の [http://homepage.boetes.org/software/mg/ ページ] からソースをダウンロードすることも可能です。mg は UTF-8 をサポートしていません。

=== zile ===

公式ウェブ[https://www.gnu.org/software/zile/ ページ]によると "GNU Zile は軽量な Emacs クローンです。Zile は Zile Is Lossy Emacs の略となっています。Zile は出来る限り Emacs に近づくように書かれており、きっと全ての Emacs ユーザーの手に馴染むでしょう"。Zile は UTF-8 をサポートしていません。

{{Pkg|zile}} パッケージからインストールできます。

最新の tarball は公式の GNU [http://ftp.sh.cvut.cz/MIRRORS/gnu/pub/gnu/zile/ ミラー] から落とせます。

=== uemacs ===

Linus Torvalds によるカスタム版 Micro-emacs。{{AUR|uemacs-git}} でインストール可能。

最新 (2005) の tarball は [ftp://ftp.cs.helsinki.fi/pub/Software/Local/uEmacs-PK/ こちら] にあります。

=== remacs ===

'''remacs''' はコミュニティによる Emacs の Rust 移植です。{{AUR|remacs-git}} パッケージでインストールできます。

== 参照 ==

* [https://www.gnu.org/software/emacs/ GNU Emacs ホームページ]
* [https://www.gnu.org/software/emacs/manual/emacs.html GNU Emacs マニュアル]
* [http://www.emacswiki.org/cgi-bin/wiki/ Emacs Wiki]
* [http://wikemacs.org WikEmacs - 読みやすいが不完全な Emacs wiki]
* [http://www2.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html Emacs とそのショートカットの有用な紹介]
* [https://d0edfcdc0ccc1cd13cdab5eb986fb92e8660dbef.googledrive.com/host/0B6LMD0u8OhYYZEotN2QyR1hwR1k/ Emacs 教会 (Google ドライブ)]
* [https://www.gnu.org/software/emacs/refcards/pdf/refcard.pdf 公式リファレンスカード]
* [[EXWM]] - Emacs X Window Manager