.\" 
.\" resgen manual page.
.\" (C) 2007 Novell, Inc. 
.\" Author:
.\"   Miguel de Icaza (miguel@gnu.org)
.\"
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.TH Mono "resgen"
.SH "نام (NAME)"
resgen, resgen2 \- تولیدکننده منابع Mono/CLI
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B resgen source.ext [dest.ext] 
.PP
.B resgen /compile source.ext[,dest.resources] [...]
.PP
.B resgen2 
.SH "توضیحات (DESCRIPTION)"
تبدیل یک فایل منبع (resource) از یک قالب به قالب دیگر.
.PP
قالب‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از text، resources، resx و po.
.TP
.I .txt, .text
.Sp
برای پردازش فایل‌های متنی به کار می‌رود؛ قالب فایل متنی به صورت زیر است:
.nf

	key=value

.fi
آرگومان value می‌تواند حاوی نویسه‌های ویژه باشد به شرطی که گریز داده شده (escape) باشند. توالی‌های گریز که در حال حاضر پشتیبانی می‌شوند عبارتند از \\n، \\r، \\t، \\\\ (برای دریافت خود نویسه گریز)، و در resgen2 توالی‌های گریز یونیکد با ساختار \\uXXXX پشتیبانی می‌شوند که در آن XXXX یک عدد چهار رقمی است.
.Sp
خطوطی که با نویسه # یا ; شروع می‌شوند، به عنوان توضیح در نظر گرفته شده و نادیده گرفته می‌شوند.
.TP
.I '.resources'
.Sp
این قالب باینری پیاده‌سازی‌شده توسط کلاس \fISystem.Resources.ResourceReader\fR است که بخشی از mscorlib.dll می‌باشد.
.TP
.I '.resx'
.Sp
این قالب باینری پیاده‌سازی‌شده توسط کلاس \fISystem.Resources.ResXResourceReader\fR است. این کلاس بخشی از mscorlib.dll نبوده و متعلق به System.Windows.Forms است.
.TP
.I '.po'.
.Sp
فایل‌های PO فایل‌های منبع مورد استفاده توسط زیرساخت gettext یونیکس هستند که معمولاً برای بین‌المللی‌سازی برنامه‌ها به کار می‌رود.
.Sp
خطوطی که با نویسه '#' آغاز می‌شوند، خطوط توضیح هستند.
.Sp
فایل شامل نمونه‌های متعددی از رشته‌هایی مانند این است:
.nf

     msgid KEY
     msgstr VALUE

.fi
معمولاً KEY رشته‌ای است که باید ترجمه شود و VALUE ترجمه آن است. در فایل‌های PO به جای استفاده از کدها به عنوان KEY (چنانکه در فایل‌های منبع مرسوم است)، معمولاً KEY یک پیام انگلیسی کامل است که برنامه‌ها در کد منبع خود قرار می‌دهند و در صورتی که هیچ منبع ترجمه‌ای استفاده نشود، به عنوان جایگزین (fallback) استفاده خواهد شد.
.Sp
از آنجا که منابع، جفت‌های کلید-مقدار هستند، ویژگی‌های پیشرفته در فایل‌های PO پشتیبانی نمی‌شوند (حالت‌های جمع و پشتیبانی از N-cases).
.Sp
برای کسب اطلاعات بیشتر درباره قالب فایل po، از مرورگر info خود استفاده کرده و به گره «(gettext)PO Files» مراجعه کنید.
.PP
اگر فایل مقصد مشخص نشده باشد، از source.resources استفاده خواهد شد.
.PP
گزینه /compile فهرستی از فایل‌های .resX یا .txt را برای تبدیل به فایل‌های .resources در یک عملیات دسته‌ای دریافت می‌کند و در نام فایل خروجی، .ext را با .resources جایگزین می‌نماید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.I "-compile"
.Sp
این سوئیچ به \fIresgen\fR دستور می‌دهد تا چندین فایل را کامپایل کند. این گزینه باید پیش از مشخص شدن هرگونه منبع در خط فرمان قرار گیرد.
.TP
.I "-usesourcepath"
.Sp
این گزینه تنها برای \fIresgen2\fR در دسترس است و به resgen دستور می‌دهد تا مسیرهای نسبی را با استفاده از دایرکتوری فایل resx به عنوان دایرکتوری جاری حل کند.
.SH "فایل‌ها (FILES)"
این برنامه اسمبلی‌های ارجاع‌شده را از حافظه پنهان اسمبلی Mono بارگذاری خواهد کرد.
.SH "فهرست‌های پستی (MAILING LISTS)"
برای جزئیات بیشتر به http://lists.ximian.com/mailman/listinfo/mono-devel-list مراجعه کنید.
.SH "وب‌گاه (WEB SITE)"
برای جزئیات بیشتر مراجعه کنید به: http://www.mono-project.com
.SH "همچنین ببینید (SEE ALSO)"
.BR mcs(1), mono(1), mono-config(5).