| gtk4-builder-tool(1) | GTK commands | gtk4-builder-tool(1) |
نام (NAME)
gtk4-builder-tool - ابزار اعتبارسنجی و تبدیل فایل‌های UI در GTK4
خلاصه دستور (SYNOPSIS)
gtk4-builder-tool <COMMAND> [OPTIONS...] <FILE> gtk4-builder-tool validate [OPTIONS...] <FILE> gtk4-builder-tool enumerate [OPTIONS...] <FILE> gtk4-builder-tool simplify [OPTIONS...] <FILE> gtk4-builder-tool preview [OPTIONS...] <FILE> gtk4-builder-tool render [OPTIONS...] <FILE> gtk4-builder-tool screenshot [OPTIONS...] <FILE>
توضیحات (DESCRIPTION)
دستور gtk4-builder-tool می‌تواند عملیات مختلفی را روی فایل‌های تعریف رابط کاربری (UI) در GtkBuilder انجام دهد.
دستورات (COMMANDS)
اعتبارسنجی (Validation)
دستور validate فایل تعریف رابط کاربری داده‌شده را اعتبارسنجی کرده و خطاها را به stderr گزارش می‌دهد.
توجه داشته باشید که برای قالب‌ها (templates) محدودیت‌هایی در اعتبارسنجی وجود دارد، زیرا آن‌ها پیوند نزدیکی با تابع class_init که در آن استفاده می‌شوند دارند. اگر فایل رابط کاربری شما از انواع متعلق به کتابخانه‌های شخص ثالث استفاده می‌کند، افزودن آن کتابخانه‌ها به متغیر محیطی LD_PRELOAD می‌تواند کمک‌کننده باشد.
--deprecations
شمارش (Enumeration)
دستور enumerate تمامی اشیای نام‌گذاری‌شده موجود در فایل تعریف رابط کاربری را چاپ می‌کند.
--callbacks
پیش‌نمایش (Preview)
دستور preview فایل تعریف رابط کاربری را نمایش می‌دهد.
این دستور گزینه‌هایی برای مشخص کردن شناسه (ID) شیء سطح‌بالا و فایل CSS مورد استفاده می‌پذیرد.
--id=ID
--css=FILE
رندر (Render)
دستور render خروجی رندرشده فایل تعریف رابط کاربری را به صورت یک تصویر png یا یک فایل node ذخیره می‌کند. نام فایل خروجی را می‌توان به عنوان آرگومان دوم FILE مشخص کرد.
این دستور گزینه‌هایی برای مشخص کردن شناسه شیء سطح‌بالا و فایل CSS مورد استفاده می‌پذیرد.
--id=ID
--css=FILE
--node
--force
اسکرین‌شات (Screenshot)
دستور screenshot نام مستعاری برای render است.
ساده‌سازی (Simplification)
دستور simplify فایل تعریف رابط کاربری را با حذف ویژگی‌هایی که روی مقادیر پیش‌فرض خود تنظیم شده‌اند ساده‌سازی کرده و XML حاصل را در خروجی استاندارد، یا درون همان فایل ورودی می‌نویسد.
هنگامی که گزینه --3to4 مشخص شود، دستور simplify ورودی را به عنوان یک فایل تعریف رابط کاربری GTK 3 تفسیر کرده و تلاش می‌کند آن را به معادل‌های GTK 4 تبدیل کند. این دستور تبدیل‌های مختلفی انجام می‌دهد؛ از جمله تغییر نام ویژگی‌ها، تبدیل ویژگی‌های فرزند به ویژگی‌های چیدمان (layout properties)، بازنویسی پیکربندی برای GtkNotebook، GtkStack، GtkAssistant یا تبدیل نوار ابزارها (toolbars) به جعبه‌ها (boxes).
همیشه باید فایل‌های تعریف رابط کاربری تغییریافته تولیدشده توسط gtk4-builder-tool را پیش از استفاده در محیط عملیاتی آزمایش کنید.
به‌ویژه توجه داشته باشید که تبدیل انجام‌شده با --3to4 به عنوان نقطه شروعی برای مهاجرت از GTK 3 به GTK 4 در نظر گرفته شده است. انتظار می‌رود که پس از تبدیل اولیه نیاز به اصلاحات دستی داشته باشید.
--replace
--3to4
| GTK |