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

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

خلاصه دستور (SYNOPSIS)
       xdg-user-dirs-update [OPTION...] [--set NAME PATH...]

توضیحات (DESCRIPTION)
       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 را مطابق با محلی‌سازی کاربر
       به‌روزرسانی کند.

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

       --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.

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

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

همچنین ببینید (SEE ALSO)
       xdg-user-dir(1), user-dirs.dirs(5), user-dirs.defaults(5), user-
       dirs.conf(5).

نویسندگان (AUTHORS)
       Alexander Larsson <alexl@redhat.com>
           توسعه‌دهنده

XDG                               04/08/2026              XDG-USER-DIRS-UPD(1)