XDG ユーザーディレクトリ

関連記事

• xdg-menu
• デフォルトアプリケーション
• XDG Base Directory サポート

freedesktop.org より:

xdg-user-dirs はデスクトップフォルダや音楽フォルダのような、「よく知られた」ユーザーディレクトリを管理するためのツールです。また、ファイル名のローカライズ (すなわち翻訳) も行います。

仕組みとしては、xdg-user-dirs-update(1) がログイン時の非常に早い段階で実行されます。このプログラムは設定ファイルとデフォルトのディレクトリのセットを読み込みます。このプログラムは設定ファイルと一連のデフォルトディレクトリを読み込み、ユーザーのホームディレクトリにこれらのディレクトリのローカライズ版を作成し、$XDG_CONFIG_HOME/user-dirs.dirs (XDG_CONFIG_HOME のデフォルトは ~/.config) にアプリケーションがこれらのディレクトリを見つけるために読める設定ファイルを設定します。

ほとんどのファイルマネージャは、XDG ユーザーディレクトリを特別なアイコンで表示します。

インストール

xdg-user-dirs パッケージをインストールしてください。

ヒント: 一部の デスクトップ環境 ではすでにインストールされています。例: GNOME

デフォルトディレクトリの作成

$HOME ディレクトリの中に、ローカライズされた完全なデフォルトユーザーディレクトリを作成するには、次のコマンドを入力:

$ xdg-user-dirs-update

ヒント: 英語のディレクトリを作成するには、LC_ALL=C xdg-user-dirs-update --force を使います。

コマンドを実行すると、以下も自動的に作成されます:

• ローカルの ~/.config/user-dirs.dirs 設定ファイル: アカウントごとのホームディレクトリを見つけて使用するのにアプリケーションが使用。
• グローバルの /etc/xdg/user-dirs.defaults 設定ファイル: 一般のホームディレクトリを見つけて使うのにアプリケーションが使用。
• ローカルの ~/.config/user-dirs.locale 設定ファイル: 使用しているロケールにあわせて言語を設定するのに使用。

カスタムディレクトリの作成

ローカルの ~/.config/user-dirs.dirs とグローバルの /etc/xdg/user-dirs.defaults どちらの設定ファイルも次のような環境変数を使ってユーザーディレクトリを指定しています: XDG_DIRNAME_DIR="$HOME/directory_name"。設定ファイルのサンプルは以下のようになります (どれもテンプレートのディレクトリです):

XDG_DESKTOP_DIR="$HOME/Desktop"
XDG_DOCUMENTS_DIR="$HOME/Documents"
XDG_DOWNLOAD_DIR="$HOME/Downloads"
XDG_MUSIC_DIR="$HOME/Music"
XDG_PICTURES_DIR="$HOME/Pictures"
XDG_PUBLICSHARE_DIR="$HOME/Public"
XDG_TEMPLATES_DIR="$HOME/.Templates"
XDG_VIDEOS_DIR="$HOME/Videos"

xdg-user-dirs は、適当なユーザーディレクトリを記述しているローカルの設定ファイルを読み込むため、カスタムフォルダを指定することが可能です。例えば ~/.config/user-dirs.dirs の XDG_DOWNLOAD_DIR 変数のカスタムフォルダを $HOME/Internet にすれば、どのアプリケーションもこの変数でこのディレクトリを使用します。

ノート: 多くの設定ファイルと同じように、ローカル設定はグローバル設定を上書きします。新しいカスタムディレクトリを作成する必要もあります。

また、コマンドラインを使ってカスタムフォルダを指定することもできます。例えば以下のコマンドは上述のように設定ファイルを編集したのと同じになります:

$ xdg-user-dirs-update --set DOWNLOAD ~/Internet

設定されているディレクトリを確認

一度設定されれば、xdg-user-dirs で全てのユーザーディレクトリを表示することができます。例えば、以下のコマンドは Templates ディレクトリの場所を表示します (ローカルの設定ファイルの XDG_TEMPLATES_DIR 変数に相当):

$ xdg-user-dir TEMPLATES