XDG-USER-DIRS-UPD(1) User Commands XDG-USER-DIRS-UPD(1)

xdg-user-dirs-update - به‌روزرسانی پیکربندی دایرکتوری‌های کاربر XDG

xdg-user-dirs-update [OPTION...] [--set NAME PATH...]

xdg-user-dirs-update وضعیت کنونی فایل user-dirs.dirs کاربران را به‌روزرسانی می‌کند. اگر پیش از این چنین فایلی وجود نداشته باشد، فایلی بر اساس مقادیر پیش‌فرض سیستم ایجاد می‌شود، یا در صورت وجود چنین دایرکتوری‌هایی، از نام‌های قدیمیِ ترجمه‌نشده استفاده خواهد شد. فهرست دایرکتوری‌های قدیمی مورد استفاده عبارتند از: ~/Desktop، ~/Templates و ~/Public.

اگر یک پیکربندی قدیمی وجود داشته باشد، با هر دایرکتوری پیش‌فرض جدیدی به‌روزرسانی می‌شود. علاوه بر این، هر دایرکتوری پیکربندی‌شده‌ای که به مکان‌های ناموجود اشاره دارد، با اشاره به دایرکتوری خانه (home) کاربر بازنشانی می‌شود. این حالت معمولاً زمانی رخ می‌دهد که کاربر دایرکتوری را حذف کرده باشد، بنابراین احتمالاً تمایلی به استفاده مجدد از آن ندارد.

در اولین اجرا، یک فایل user-dirs.locale ایجاد می‌شود که حاوی محلی‌سازی (locale) استفاده‌شده برای ترجمه است. این فایل بعداً توسط ابزارهای گرافیکی مانند xdg-user-dirs-gtk-update استفاده می‌شود تا تغییر محلی‌سازی را تشخیص داده و امکان انتقال از نام‌های قدیمی را فراهم سازد.

xdg-user-dirs-update به طور معمول در آغاز نشست کاربر به صورت خودکار اجرا می‌شود تا دایرکتوری‌های کاربر XDG را مطابق با محلی‌سازی کاربر به‌روزرسانی کند.

گزینه‌های زیر پشتیبانی می‌شوند:

--help

نمایش خروجی راهنما و خروج.

--force

به‌روزرسانی user-dirs.dirs موجود، اما با اجبار به بازنشانی کامل. این به این معناست: دایرکتوری‌های ناموجود را به HOME بازنشانی نکن، بلکه دایرکتوری را دوباره بساز. هرگز از نام‌های ترجمه‌نشده سازگار با نسخه‌های پیشین استفاده نکن. همیشه user-dirs.locale را دوباره ایجاد کن.

--dummy-output PATH

نوشتن پیکربندی در PATH به جای فایل پیکربندی پیش‌فرض. همچنین، هیچ دایرکتوری‌ای ایجاد نمی‌شود.

--set NAME PATH

تنظیم دایرکتوری کاربر XDG با نام داده‌شده.

NAME باید یکی از موارد زیر باشد:

DESKTOP
DOWNLOAD
TEMPLATES
PUBLICSHARE
DOCUMENTS
MUSIC
PICTURES
VIDEOS

PATH باید یک مسیر مطلق باشد، مانند $HOME/Some/Directory.

پیکربندی دایرکتوری‌های کاربر XDG در فایل user-dirs.dirs در مکانی که توسط متغیر محیطی XDG_CONFIG_HOME مشخص می‌شود، ذخیره می‌گردد.

متغیر محیطی XDG_CONFIG_HOME تعیین می‌کند که فایل user-dirs.dirs در کجا قرار دارد.

xdg-user-dir(1), user-dirs.dirs(5), user-dirs.defaults(5), user-dirs.conf(5).

Alexander Larsson <alexl@redhat.com>

توسعه‌دهنده
04/08/2026 XDG