Difference between revisions of "Xdg user directories"

From ArchWiki
Jump to: navigation, search
(Created page with "Category:Desktop environments {{i18n|xdg-user-dirs-update}} '''xdg-user-dirs-update''' is a desktop-independent tool for configuring the location of certain user director...")
 
(typo, lk)
Line 5: Line 5:
  
 
== Installation ==
 
== Installation ==
xdg-user-dirs-update is part of the {{pkg|xdg-user-dirs}} package available in [local].
+
xdg-user-dirs-update is part of the {{pkg|xdg-user-dirs}} package available in [extra].
  
 
== Configuration ==
 
== Configuration ==
Line 43: Line 43:
 
User directories are used internally by many applications: For instance, the template directory is used by [[GNOME#Nautilus|Nautilus]]
 
User directories are used internally by many applications: For instance, the template directory is used by [[GNOME#Nautilus|Nautilus]]
 
and [[Thunar]] to determine where to look for files to be passed to the ''Create Document'' context menu, whereas the desktop directory is used by Xfdesktop to find ''.desktop'' files to be shown on the Desktop.
 
and [[Thunar]] to determine where to look for files to be passed to the ''Create Document'' context menu, whereas the desktop directory is used by Xfdesktop to find ''.desktop'' files to be shown on the Desktop.
 +
 +
== External Resource ==
 +
* [http://freedesktop.org/wiki/Software/xdg-user-dirs xdg-user-dirs] - freedesktop.org

Revision as of 00:18, 17 May 2012

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

xdg-user-dirs-update is a desktop-independent tool for configuring the location of certain user directories. Many applications of various desktop environments use the directories specified by xdg-user-dirs-update internally.

Installation

xdg-user-dirs-update is part of the xdg-user-dirs package available in [extra].

Configuration

The config file

xdg-user-dirs uses a configuration file located at ~/.config/user-dirs.dir. Its format is as follows:

 XDG_DIRNAME_DIR="$HOME/Dirname"

A complete file might contain multiple entries:

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

xdg-user-dirs-update

The contents of the configuration file can be modified directly with a call to xdg-user-dirs-update. As an example, xdg-user-dirs-update --set TEMPLATES ~/.templates will set the template directory to the specified directory with respect to the current user's $HOME:

 XDG_TEMPLATES_DIR="$HOME/.templates"

xdg-user-dir

Once set, any user directory can be viewed with xdg-user-dir. For example:

$ xdg-user-dir TEMPLATES

will show the template directory, which of course corresponds to the XDG_TEMPLATES_DIR variable in the config file.

Applications using user directories

User directories are used internally by many applications: For instance, the template directory is used by Nautilus and Thunar to determine where to look for files to be passed to the Create Document context menu, whereas the desktop directory is used by Xfdesktop to find .desktop files to be shown on the Desktop.

External Resource