Jump to content

# XDG user directories (Português)

From ArchWiki
Status de tradução: Esse artigo é uma tradução de XDG user directories. Data da última tradução: 2020-07-06. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Artigos relacionados

- xdg-menu
- Aplicativos padrão
- Suporte a XDG Base Directory

Do freedesktop.org:

  xdg-user-dirs é uma ferramenta para ajudar a gerenciar diretórios de usuário "bem conhecidos", como a pasta de área de trabalho e a pasta de música. Também lida com localização (isto é, tradução) dos nomes de arquivo.

  A maneira como funciona é que o xdg-user-dirs-update(1) é executado muito cedo na fase de login. Este programa lê um arquivo de configuração e um conjunto de diretórios padrão. Em seguida, ele cria versões localizadas desses diretórios no diretório inicial dos usuários e configura um arquivo de configuração em `$XDG_CONFIG_HOME/user-dirs.dirs` (`XDG_CONFIG_HOME` tem como padrão `~/.config`) que os aplicativos podem ler para localizar esses diretórios.

A maioria dos gerenciadores de arquivos indica diretórios de usuário XDG com ícones especiais.

## Instalação

Instale xdg-user-dirs.

Dica Alguns ambientes de desktop podem já tê-lo instalado como, por exemplo, o GNOME.

## Criando diretórios padrão

A criação de um conjunto completo de diretórios de usuários padrão localizados dentro do diretório `$HOME` pode ser feito automaticamente executando:

    $ xdg-user-dirs-update

Dica Para forçar a criação de diretórios com nome em inglês, `LC_ALL=C xdg-user-dirs-update --force` pode ser usado.

Quando executado, ele também vai automaticamente:

- Criar um arquivo de configuração local `~/.config/user-dirs.dirs`: usado por aplicativos para localizar e usar diretórios home específicos para uma conta.
- Criar um arquivo de configuração local `~/.config/user-dirs.locale`: usado para definir o idioma conforme o locale em uso.

O serviço de usuário `xdg-user-dir-update.service` também será instalado e ativado por padrão, para manter seus diretórios atualizados executando este comando no início de cada sessão de login.

## Criando diretórios personalizados

Ambos os arquivos de configuração local `~/.config/user-dirs.dirs` e o global `/etc/xdg/user-dirs.defaults` usam o seguinte formato de variável de ambiente para apontar para diretórios de usuário: `XDG_DIRNAME_DIR="$HOME/nome_do_diretório"`. Um arquivo de configuração vai/pode se parecer com esse exemplo abaixo (esses são diretórios modelo):

    ~/.config/user-dirs.dirs

    XDG_DESKTOP_DIR="$HOME/Área de trabalho"
    XDG_DOWNLOAD_DIR="$HOME/Downloads"
    XDG_TEMPLATES_DIR="$HOME/Modelos"
    XDG_PUBLICSHARE_DIR="$HOME/Público"
    XDG_DOCUMENTS_DIR="$HOME/Documentos"
    XDG_MUSIC_DIR="$HOME/Música"
    XDG_PICTURES_DIR="$HOME/Imagens"
    XDG_VIDEOS_DIR="$HOME/Vídeos"

Como xdg-user-dirs vai carregar o arquivo de configuração local para apontar para os diretórios de usuário apropriados, é então possível especificar pastas personalizadas. Por exemplo, se uma pasta personalizada para a variável `XDG_DOWNLOAD_DIR` tiver sido nomeada `$HOME/Internet` no `~/.config/user-dirs.dirs`, qualquer aplicativo que usa essa variável vai usar esse diretório.

Nota Como com muitos arquivos de configuração, as configurações locais substituem as configurações globais. Também será necessário criar novos diretórios personalizados.

Alternativamente, também é possível especificar pastas personalizadas usando a linha de comando. Por exemplo, o seguinte comando produzirá os mesmos resultados que a edição do arquivo de configuração acima:

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

## Consultando diretórios configurados

Uma vez definido, qualquer diretório de usuário pode ser visto com xdg-user-dirs. Por exemplo, o comando a seguir vai mostrar a localização do diretório `Templates` (em português, `Modelos`), que, é claro, corresponde à variável `XDG_TEMPLATES_DIR` no arquivo de configuração local:

    $ xdg-user-dir TEMPLATES

Category:

- Freedesktop.org (Português)

XDG user directories (Português)
Add topic