.\" Man page generated from reStructuredText.
.
.
.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 "GLIB-COMPILE-RESOURCES" "1" "مه ۲۰۲۵" "glib2" "دستورهای کاربری"
.SH "نام (NAME)"
glib-compile-resources \- کامپایل منابع برنامهها به فایلهای منبع باینری یا C
.\" SPDX-FileCopyrightText: 2012, 2016 Red Hat, Inc.
.\" SPDX-FileCopyrightText: 2012 Christian Persch
.\" SPDX-FileCopyrightText: 2016 Sam Thursfield
.\" SPDX-FileCopyrightText: 2016 Patrick Griffis
.\" SPDX-FileCopyrightText: 2018 Ninja-Koala
.\" SPDX-FileCopyrightText: 2018, 2021 Emmanuele Bassi
.\" SPDX-FileCopyrightText: 2020 Endless OS Foundation, LLC
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBglib-compile-resources\fP [ \fIگزینهها\fP... ] \fIفایل_gresource.xml\fP
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
دستور \fBglib-compile-resources\fR فایل توضیحات منبع XML را خوانده و فایل بسته منبع باینری GResource یا کدهای منبع C متناظر را برای پیوند در برنامه ایجاد میکند.
.sp
فایل‌های منبع XML معمولاً دارای پسوند نام فایل
\fB\&.gresource.xml\fP
هستند. برای مشاهده توضیحات دقیق درباره قالب فایل XML، به مستندات
\fBGResource\fP
در نشانی <https://docs.gtk.org/gio/struct.Resource.html>
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h\fP, \fB\-\-help\fP
.INDENT 0.0
.INDENT 3.5
نمایش راهنما و خروج.
.UNINDENT
.UNINDENT
.sp
\fB\-\-version\fP
.INDENT 0.0
.INDENT 3.5
نمایش نگارش برنامه و خروج.
.UNINDENT
.UNINDENT
.sp
\fB\-\-target <TARGET>\fP
.INDENT 0.0
.INDENT 3.5
ذخیره منابع کامپایل‌شده در فایل \fBTARGET\fP\&. اگر مشخص نشود، از نام فایلی بر اساس نام پایه (basename) فایل \fBFILE\fP استفاده می‌شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-sourcedir <DIRECTORY>\fP
.INDENT 0.0
.INDENT 3.5
فایل‌های مورد ارجاع در \fBFILE\fP از این دایرکتوری بارگذاری می‌شوند. اگر مشخص نشود، از دایرکتوری جاری استفاده خواهد شد. در صورتی که گزینه \fB\-\-sourcedir\fP بیش از یک بار به کار رود، دایرکتوری‌های مشخص‌شده به ترتیب جستجو می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-generate\fP
.INDENT 0.0
.INDENT 3.5
نوشتن فایل خروجی در قالبی که بر اساس پسوند نام آن انتخاب می‌شود:
.sp
\fB\&.c\fP
.INDENT 0.0
.INDENT 3.5
کد منبع C
.UNINDENT
.UNINDENT
.sp
\fB\&.h\fP
.INDENT 0.0
.INDENT 3.5
سرآیند C (فایل header)
.UNINDENT
.UNINDENT
.sp
\fB\&.gresource\fP
.INDENT 0.0
.INDENT 3.5
بسته منابع (resource bundle)
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fB\-\-generate\-source\fP
.INDENT 0.0
.INDENT 3.5
به جای نوشتن بسته منبع در قالب باینری، یک فایل منبع C ایجاد می‌کند که حاوی بسته منابع است. سپس این فایل می‌تواند برای دسترسی آسان درون برنامه کامپایل شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-generate\-header\fP
.INDENT 0.0
.INDENT 3.5
تولید یک فایل سرآیند (header) برای استفاده به همراه کدهای C تولیدشده توسط \fB\-\-generate\-source\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-\-generate\-dependencies\fP
.INDENT 0.0
.INDENT 3.5
فهرست فایل‌هایی را که بسته منابع به آن‌ها ارجاع می‌دهد در خروجی استاندارد چاپ می‌کند. این گزینه می‌تواند برای ردیابی وابستگی‌ها در سیستم ساخت استفاده شود. برای نمونه، دستور ساخت (make rule) زیر فایل \fBtest.gresource\fP را وابسته به تمام فایل‌های موجود در \fBtest.gresource.xml\fP قرار می‌دهد تا در صورت تغییر هر یک از آن‌ها، به صورت خودکار بازسازی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test.gresource: test.gresource.xml $(shell $(GLIB_COMPILE_RESOURCES) \-\-generate\-dependencies test.gresource.xml)
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که این قابلیت ممکن است در نسخه‌های غیر گنو (non\-GNU) ابزار \fBmake\fP قابل حمل (portable) نباشد.
.sp
همچنین گزینه \fB\-\-dependency\-file\fP را ببینید.
.UNINDENT
.UNINDENT
.sp
\fB\-\-c\-name\fP
.INDENT 0.0
.INDENT 3.5
تعیین پیشوند مورد استفاده برای شناسه‌های C در کدهای تولیدشده توسط \fB\-\-generate\-source\fP و \fB\-\-generate\-header\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-\-manual\-register\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، کدهای تولیدشده توسط \fB\-\-generate\-source\fP از مقداردهی اولیه خودکار برای منابع استفاده می‌کنند. این کار در اکثر سیستم‌ها با استفاده از پشتیبانی کامپایلر از توابع سازنده (constructors) به درستی عمل می‌کند. با این حال، برخی از کامپایلرهای خاص ممکن است از آن پشتیبانی نکنند؛ در این صورت می‌توانید گزینه \fB\-\-manual\-register\fP را مشخص کنید که توابع سفارشی ثبت (register) و لغو ثبت (unregister) را تولید می‌کند تا کد شما بتواند آن‌ها را هنگام راه‌اندازی و آزادسازی به صورت دستی فراخوانی کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-internal\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، کدهای تولیدشده توسط \fB\-\-generate\-source\fP تمام توابع مقداردهی اولیه را به عنوان \fBextern\fP اعلان می‌کنند؛ بنابراین این توابع صادر (export) می‌شوند مگر اینکه توسط اسکریپت پیوند (link script) یا روش‌های دیگر از آن جلوگیری شود. از آنجا که کتابخانه‌ها معمولاً مایلند از این توابع تنها به صورت داخلی استفاده کنند، اعلان آن‌ها به عنوان \fBG_GNUC_INTERNAL\fP کاربردی‌تر است که این کار توسط گزینه \fB\-\-internal\fP انجام می‌شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-external\-data\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، کدهای تولیدشده توسط \fB\-\-generate\-source\fP داده‌های منبع را به صورت لیترال رشته‌ای (string literal) جاسازی می‌کنند. هنگامی که گزینه \fB\-\-external\-data\fP داده شود، داده‌ها فقط در فایل C تولیدشده اعلان می‌شوند و باید به صورت خارجی پیوند (link) داده شوند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-dependency\-file <FILE>\fP
.INDENT 0.0
.INDENT 3.5
وابستگی‌ها را به همان شیوه دستور \fBgcc \-M \-MF\fP در فایل مشخص‌شده می‌نویسد. اگر مقدار \fBFILE\fP برابر با \fB\-\fP باشد، وابستگی‌ها در خروجی استاندارد نوشته می‌شوند. بر خلاف گزینه \fB\-\-generate\-dependencies\fP، این گزینه می‌تواند با سایر گزینه‌های \fB\-\-generate\fP ترکیب شود تا وابستگی‌ها را به عنوان اثر جانبیِ تولید کدهای منبع ایجاد کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-generate\-phony\-targets\fP
.INDENT 0.0
.INDENT 3.5
هنگام ایجاد فایل وابستگی با گزینه \fB\-\-dependency\-file\fP، هدف‌های ساختگی (phony targets) را به همان شیوه \fBgcc \-MP\fP اضافه می‌کند. این گزینه معمولاً به همراه \fBmake\fP استفاده می‌شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-compiler <NAME>\fP
.INDENT 0.0
.INDENT 3.5
تولید کدی که برای کامپایلر مشخص‌شده با \fBNAME\fP بهینه‌سازی می‌شود. دو حالت کامپایلر موجود عبارتند از \fBgcc\fP برای تمام زنجیره‌ابزارهای سازگار با GCC، و \fBmsvc\fP برای کامپایلر ویژوال سی مایکروسافت (Microsoft Visual C Compiler). اگر این گزینه تنظیم نشود، مقدار پیش‌فرض از متغیر محیطی \fBCC\fP گرفته خواهد شد.
.UNINDENT
.UNINDENT
.SH "متغیرهای محیطی (ENVIRONMENT)"
.sp
\fBXMLLINT\fP
.INDENT 0.0
.INDENT 3.5
مسیر کامل به فایل اجرایی \fBxmllint\fP\&. این متغیر برای پیش‌پردازش منابع با گزینه پیش‌پردازش \fBxml\-stripblanks\fP به کار می‌رود. اگر این متغیر محیطی تنظیم نشده باشد، برنامه \fBxmllint\fP در متغیر محیطی \fBPATH\fP جستجو می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBGDK_PIXBUF_PIXDATA\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.32 بسته gdk\-pixbuf منسوخ شده است، زیرا \fBGResource\fP از جاسازی قالب‌های مدرن تصویر بدون نیاز به تبدیل پشتیبانی می‌کند.
.sp
مسیر کامل به فایل اجرایی \fBgdk\-pixbuf\-pixdata\fP\&. این متغیر برای پیش‌پردازش منابع با گزینه پیش‌پردازش \fBto\-pixdata\fP به کار می‌رود. اگر این متغیر محیطی تنظیم نشده باشد، برنامه \fBgdk\-pixbuf\-pixdata\fP در متغیر محیطی \fBPATH\fP جستجو می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBJSON_GLIB_FORMAT\fP
.INDENT 0.0
.INDENT 3.5
مسیر کامل به فایل اجرایی \fBjson\-glib\-format\fP\&. این متغیر برای پیش‌پردازش منابع با گزینه پیش‌پردازش \fBjson\-stripblanks\fP به کار می‌رود. اگر این متغیر محیطی تنظیم نشده باشد، برنامه \fBjson\-glib\-format\fP در متغیر محیطی \fBPATH\fP جستجو می‌شود.
.UNINDENT
.UNINDENT