.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "gtk4-builder-tool" "1" "" "GTK" "GTK commands"
.SH "نام (NAME)"
gtk4-builder-tool \- ابزار اعتبارسنجی و تبدیل فایل‌های UI در GTK4
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBgtk4\-builder\-tool\fP <COMMAND> [OPTIONS...] <FILE>

\fBgtk4\-builder\-tool\fP validate [OPTIONS...] <FILE>
\fBgtk4\-builder\-tool\fP enumerate [OPTIONS...] <FILE>
\fBgtk4\-builder\-tool\fP simplify [OPTIONS...] <FILE>
\fBgtk4\-builder\-tool\fP preview [OPTIONS...] <FILE>
\fBgtk4\-builder\-tool\fP render [OPTIONS...] <FILE>
\fBgtk4\-builder\-tool\fP screenshot [OPTIONS...] <FILE>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgtk4\-builder\-tool\fP می‌تواند عملیات مختلفی را روی فایل‌های تعریف رابط کاربری (UI) در GtkBuilder انجام دهد.
.SH "دستورات (COMMANDS)"
.SS "اعتبارسنجی (Validation)"
.sp
دستور \fBvalidate\fP فایل تعریف رابط کاربری داده‌شده را اعتبارسنجی کرده و خطاها را به \fBstderr\fP گزارش می‌دهد.
.sp
توجه داشته باشید که برای قالب‌ها (templates) محدودیت‌هایی در اعتبارسنجی وجود دارد، زیرا آن‌ها پیوند نزدیکی با تابع class_init که در آن استفاده می‌شوند دارند. اگر فایل رابط کاربری شما از انواع متعلق به کتابخانه‌های شخص ثالث استفاده می‌کند، افزودن آن کتابخانه‌ها به متغیر محیطی \fILD_PRELOAD\fP می‌تواند کمک‌کننده باشد.
.sp
\fB\-\-deprecations\fP
.INDENT 0.0
.INDENT 3.5
درباره استفاده از انواع منسوخ‌شده (deprecated) در فایل تعریف رابط کاربری هشدار می‌دهد.
.UNINDENT
.UNINDENT
.SS "شمارش (Enumeration)"
.sp
دستور \fBenumerate\fP تمامی اشیای نام‌گذاری‌شده موجود در فایل تعریف رابط کاربری را چاپ می‌کند.
.sp
\fB\-\-callbacks\fP
.INDENT 0.0
.INDENT 3.5
نام فراخوانی‌های بازگشتی (callbacks) را نیز چاپ می‌کند.
.UNINDENT
.UNINDENT
.SS "پیش‌نمایش (Preview)"
.sp
دستور \fBpreview\fP فایل تعریف رابط کاربری را نمایش می‌دهد.
.sp
این دستور گزینه‌هایی برای مشخص کردن شناسه (ID) شیء سطح‌بالا و فایل CSS مورد استفاده می‌پذیرد.
.sp
\fB\-\-id=ID\fP
.INDENT 0.0
.INDENT 3.5
شناسه شیء برای پیش‌نمایش. در صورت عدم تعیین، gtk4\-builder\-tool شیء مناسب را خود انتخاب می‌کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-css=FILE\fP
.INDENT 0.0
.INDENT 3.5
اطلاعات سبک (style) را از فایل CSS داده‌شده بارگذاری می‌کند.
.UNINDENT
.UNINDENT
.SS "رندر (Render)"
.sp
دستور \fBrender\fP خروجی رندرشده فایل تعریف رابط کاربری را به صورت یک تصویر png یا یک فایل node ذخیره می‌کند. نام فایل خروجی را می‌توان به عنوان آرگومان دوم FILE مشخص کرد.
.sp
این دستور گزینه‌هایی برای مشخص کردن شناسه شیء سطح‌بالا و فایل CSS مورد استفاده می‌پذیرد.
.sp
\fB\-\-id=ID\fP
.INDENT 0.0
.INDENT 3.5
شناسه شیء برای رندر. در صورت عدم تعیین، gtk4\-builder\-tool شیء مناسب را خود انتخاب می‌کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-css=FILE\fP
.INDENT 0.0
.INDENT 3.5
اطلاعات سبک را از فایل CSS داده‌شده بارگذاری می‌کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-node\fP
.INDENT 0.0
.INDENT 3.5
به جای تصویر png، یک فایل گره سریال‌سازی‌شده (serialized node file) می‌نویسد.
.UNINDENT
.UNINDENT
.sp
\fB\-\-force\fP
.INDENT 0.0
.INDENT 3.5
فایل موجود را رونویسی می‌کند.
.UNINDENT
.UNINDENT
.SS "اسکرین‌شات (Screenshot)"
.sp
دستور \fBscreenshot\fP نام مستعاری برای \fBrender\fP است.
.SS "ساده‌سازی (Simplification)"
.sp
دستور \fBsimplify\fP فایل تعریف رابط کاربری را با حذف ویژگی‌هایی که روی مقادیر پیش‌فرض خود تنظیم شده‌اند ساده‌سازی کرده و XML حاصل را در خروجی استاندارد، یا درون همان فایل ورودی می‌نویسد.
.sp
هنگامی که گزینه \fB\-\-3to4\fP مشخص شود، دستور \fBsimplify\fP ورودی را به عنوان یک فایل تعریف رابط کاربری GTK 3 تفسیر کرده و تلاش می‌کند آن را به معادل‌های GTK 4 تبدیل کند. این دستور تبدیل‌های مختلفی انجام می‌دهد؛ از جمله تغییر نام ویژگی‌ها، تبدیل ویژگی‌های فرزند به ویژگی‌های چیدمان (layout properties)، بازنویسی پیکربندی برای GtkNotebook، GtkStack، GtkAssistant یا تبدیل نوار ابزارها (toolbars) به جعبه‌ها (boxes).
.sp
همیشه باید فایل‌های تعریف رابط کاربری تغییریافته تولیدشده توسط gtk4\-builder\-tool را پیش از استفاده در محیط عملیاتی آزمایش کنید.
.sp
به‌ویژه توجه داشته باشید که تبدیل انجام‌شده با \fB\-\-3to4\fP به عنوان نقطه شروعی برای مهاجرت از GTK 3 به GTK 4 در نظر گرفته شده است. انتظار می‌رود که پس از تبدیل اولیه نیاز به اصلاحات دستی داشته باشید.
.sp
\fB\-\-replace\fP
.INDENT 0.0
.INDENT 3.5
محتوا را به جای خروجی استاندارد، مجدداً درون فایل تعریف رابط کاربری می‌نویسد.
.UNINDENT
.UNINDENT
.sp
\fB\-\-3to4\fP
.INDENT 0.0
.INDENT 3.5
یک فایل تعریف رابط کاربری GTK 3 را به تعاریف معادل در GTK 4 تبدیل می‌کند.
.UNINDENT
.UNINDENT
.\" End of generated man page.