# XDG user directories (简体中文)

From ArchWiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

相关文章

- xdg-menu
- Default applications (简体中文)
- XDG Base Directory support

翻译状态：本文是 XDG user directories 的翻译。上次翻译日期：2017-02-22。如果英文版本有所更改，则您可以帮助同步翻译。

用户目录指位于 `$HOME` 下的一系列常用目录，例如 `Documents`，`Downloads`，`Music`，还有 `Desktop`。用户目录会在文件管理器中显示为不同的图标，且被多种应用程序所参照。可以使用 xdg-user-dirs 自动生成这些目录。进一步信息请参照 freedesktop.org。

提示： 对于那些想要用文件管理器来给 Window manager (简体中文)（例如 Openbox (简体中文)）显示桌面的人来说这个程序尤其有用，因为它会自动创建 `~/Desktop` 目录。

## 创建默认目录

可以用 xdg-user-dirs 在 `$HOME` 下创建一整套默认的经本地化的用户目录。请运行：

    $ xdg-user-dirs-update

提示： 使用 `LC_ALL=C xdg-user-dirs-update --force` 命令可以强制创建英语目录。

运行后该命令还会自动地：

- 创建一个本地的 `~/.config/user-dirs.dirs` 配置文件：应用程序通过他来查找使用特定帐号指定的用户目录。
- 创建一个本地的 `~/.config/user-dirs.locale` 配置文件：根据使用的 locale 指定语言。

## 创建自定义目录

本地的 `~/.config/user-dirs.dirs` 和全局的 `/etc/xdg/user-dirs.defaults` 配置文件都使用如下的环境变量格式： `XDG_DIRNAME_DIR="$HOME/目录名"`。一个例子：

    ~/.config/user-dirs.dirs

    XDG_DESKTOP_DIR="$HOME/桌面"
    XDG_DOCUMENTS_DIR="$HOME/文档"
    XDG_DOWNLOAD_DIR="$HOME/下载"
    XDG_MUSIC_DIR="$HOME/音乐"
    XDG_PICTURES_DIR="$HOME/图片"
    XDG_PUBLICSHARE_DIR="$HOME/公共"
    XDG_TEMPLATES_DIR="$HOME/模板"
    XDG_VIDEOS_DIR="$HOME/视频"

因为 xdg-user-dirs 会参照本地配置文件来了解正确的用户目录，所以可以自定义。比如若将 `~/.config/user-dirs.dirs` 下 `XDG_DOWNLOAD_DIR` 变量设为了 `$HOME/Internet`，那么任何参照了该变量的程序都会改用这个目录。

注意： 和其他的配置文件一样，本地设定覆盖全局设定。另外自定义的目录要自己创建。

或者也可以用命令行修改默认目录。下列命令会产生和上面一样的效果：

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

## 查询配置好的目录

可以用 xdg-user-dirs 来查询配置好的目录路径。例如，下列命令可以查询 `模板` 目录的位置，对应于本地配置文件中 `XDG_TEMPLATES_DIR` 变量的值：

    $ xdg-user-dir TEMPLATES

Category:

- Desktop environments (简体中文)