.\" derb.1: صفحه راهنمای ابزار derb
.\"
.\" Copyright (C) 2016 and later: Unicode, Inc. and others.
.\" License & terms of use: http://www.unicode.org/copyright.html
.\" Copyright (C) 2000-2014 IBM, Inc. and others.
.\"
.TH "DERB" "1" "مه ۲۰۲۵" "icu" "دستورهای کاربری"
.SH "نام (NAME)"
derb \- بازگشایی و دیساسمبل بستههای منابع در کتابخانه بینالمللیسازی ICU
.SH "خلاصه دستور (SYNOPSIS)"
\fBderb\fP [ \fIگزینهها\fP... ] [ \fIبسته_منبع\fP... ]
.SH "توضیحات (DESCRIPTION)"
دستور \fBderb\fR بستههای منابع باینری کتابخانه ICU را خوانده و ساختار و متون آن را به فرمت متنی قابل خواندن باز میگرداند.
فایل‌های متنی حاصل دارای پسوند
.B .txt
خواهند بود، در حالی که فایل‌های بسته منبع کامپایل‌شده معمولاً دارای پسوند
.B .res
هستند.
.PP
مرسوم است که بسته‌های منابع بر اساس نام محلی‌سازی (locale) خود نام‌گذاری شوند، یعنی از یک شناسه محلی برای نام فایل
.I bundle
استفاده شود؛ به عنوان مثال
.B ja_JP.res
برای داده‌های ژاپنی (ژاپن)، یا
.B root.res
برای بسته ریشه. این امر به ویژه برای
.B derb
اهمیت دارد زیرا نام محلی مستقیماً از درون بسته منبع کامپایل‌شده قابل دسترسی نیست، و برای اطلاع از اینکه هنگام باز کردن بسته کدام محلی‌سازی درخواست شود الزامی است.
.B derb
فایلی تولید می‌کند که نام پایه آن برابر با نام پایه خود فایل منبع کامپایل‌شده است. با این حال اگر گزینه
.BI "\-\-to\-stdout\fP, \fB\-c\fP"
استفاده شود، متن در خروجی استاندارد نوشته خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
چاپ راهنمای نحوه استفاده و خروج.
.TP
.BR "\-V\fP, \fB\-\-version"
چاپ نسخه
.B derb
و خروج.
.TP
.BR "\-v\fP, \fB\-\-verbose"
نمایش پیام‌های اطلاعاتی بیشتر در حین اجرا.
.TP
.BR "\-A\fP, \fB\-\-suppressAliases"
عدم دنبال کردن نام‌های مستعار (aliases) هنگام تولید خروجی.
.TP
.BI "\-e\fP, \fB\-\-encoding" " encoding"
تنظیم کدگذاری مورد استفاده برای نوشتن فایل‌های خروجی روی
.IR encoding .
کدگذاری پیش‌فرض، صفحه کد دگرگون‌ناپذیر (زیرمجموعه‌ای از ASCII یا EBCDIC) برای سیستم است (بخش
.BR "نویسه‌های دگرگون‌ناپذیر (INVARIANT CHARACTERS)"
را ببینید).
انتخاب کدگذاری روی خود داده‌ها تأثیری ندارد و تنها نمایش آن‌ها را مشخص می‌کند. نویسه‌هایی که در
.I encoding
قابل بازنمایی نباشند، با استفاده از توالی‌های گریز
.BI \eu "hhhh"
نمایش داده می‌شوند.
.TP
.BI "\-\-bom"
نوشتن علامت ترتیب بایت (BOM) در ابتدای فایل.
.TP
.BI "\-l\fP, \fB\-\-locale" " locale"
تنظیم
.I locale
برای بسته منبع، که هم در متن تولیدشده و هم به عنوان نام پایه فایل خروجی استفاده می‌شود.
.TP
.BI "\-t\fP, \fB\-\-truncate" " \fR[ \fPsize\fR ]\fP"
کوتاه کردن منابع منفرد (رشته‌ها یا داده‌های باینری) به
.I size
بایت. در صورتی که
.I size
مشخص نشود، مقدار پیش‌فرض
.B 80
بایت است.
.TP
.BI "\-s\fP, \fB\-\-sourcedir" " source"
تنظیم دایرکتوری منبع روی
.IR source .
دایرکتوری منبع پیش‌فرض، دایرکتوری جاری است.
اگر برای
.IR source
مقدار
.B \-
داده شود، بسته منبع
(\fIbundle\fP)
در مسیر پیش‌فرض خود جستجو خواهد شد که توسط متغیر محیطی
.B ICU_DATA
مشخص می‌شود (یا در صورت عدم تنظیم
.BR ICU_DATA ،
مسیر پیش‌فرضی که در زمان ساخت ICU تنظیم شده است).
.TP
.BI "\-d\fP, \fB\-\-destdir" " destination"
تنظیم دایرکتوری مقصد روی
.IR destination .
دایرکتوری مقصد پیش‌فرض توسط متغیر محیطی
.B ICU_DATA
مشخص می‌شود، یا اگر
.B ICU_DATA
تنظیم نشده باشد، مقداری است که در زمان ساخت ICU مشخص شده است.
.TP
.BI "\-i\fP, \fB\-\-icudatadir" " directory"
جستجو برای هرگونه فایل داده مورد نیاز ICU در
.IR directory .
به عنوان مثال، هنگام پردازش بازنویسی‌های تطبیق (collation overrides)، فایل
.B ucadata.dat
باید مکان‌یابی شود.
دایرکتوری داده پیش‌فرض ICU توسط متغیر محیطی
.B ICU_DATA
مشخص می‌شود.
.TP
.BI "\-c\fP, \fB\-\-to\-stdout"
نوشتن بسته منبع
(\fIbundle\fP)
دیساسمبل‌شده در خروجی استاندارد به جای نوشتن در یک فایل.
.SH "هشدارها (CAVEATS)"
هنگامی که از گزینه
.BI \-\-bom
استفاده می‌شود، نویسه
.B U+FEFF
در کدگذاری مقصد
(\fIencoding\fP)
نوشته می‌شود، صرف‌نظر از اینکه آن کدگذاری یک قالب تبدیل یونیکد (UTF) باشد یا خیر.
این گزینه فقط باید با کدگذاری‌های UTF استفاده شود، زیرا علامت‌های ترتیب بایت (BOM) برای سایر کدگذاری‌ها بی‌معنی هستند.
.SH "نویسه‌های دگرگون‌ناپذیر (INVARIANT CHARACTERS)"
.B مجموعه نویسه‌های دگرگون‌ناپذیر
شامل نویسه‌های زیر است که در قالب یک عبارت باقاعده استاندارد POSIX بیان شده است:
.PP
.B [a-z]|[A-Z]|[0-9]|_| |+|-|*|/
.PP
این مجموعه‌ای است که در دسترس بودن آن صرف‌نظر از صفحه کد تضمین شده است.
.SH "محیط (ENVIRONMENT)"
.TP 10
.B ICU_DATA
دایرکتوری حاوی داده‌های ICU را مشخص می‌کند. مقدار پیش‌فرض آن
.B ${prefix}/share/icu/76.1/
است. برخی از ابزارهای ICU به وجود اسلش پایانی وابسته هستند، بنابراین در صورت تنظیم
.B ICU_DATA
باید اطمینان حاصل شود که اسلش پایانی در انتهای مسیر درج شده باشد.
.SH "نویسندگان (AUTHORS)"
ولادیمیر واینستین (Vladimir Weinstein)
.br
ایو آرویه (Yves Arrouye)
.SH "نسخه (VERSION)"
1.0
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2002 IBM, Inc. and others.
.br
حق نشر \(co 2016 and later: Unicode, Inc. and others.
.br
مجوز و شرایط استفاده: <http://www.unicode.org/copyright.html>
.SH "همچنین ببینید (SEE ALSO)"
.BR genrb (1)