Mono(resgen) Mono(resgen)

resgen, resgen2 - تولیدکننده منابع Mono/CLI

resgen source.ext [dest.ext]

resgen /compile source.ext[,dest.resources] [...]

resgen2

تبدیل یک فایل منبع (resource) از یک قالب به قالب دیگر.

قالب‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از text، resources، resx و po.

.txt, .text

برای پردازش فایل‌های متنی به کار می‌رود؛ قالب فایل متنی به صورت زیر است:

key=value
آرگومان value می‌تواند حاوی نویسه‌های ویژه باشد به شرطی که گریز داده شده (escape) باشند. توالی‌های گریز که در حال حاضر پشتیبانی می‌شوند عبارتند از \n، \r، \t، \\ (برای دریافت خود نویسه گریز)، و در resgen2 توالی‌های گریز یونیکد با ساختار \uXXXX پشتیبانی می‌شوند که در آن XXXX یک عدد چهار رقمی است.

خطوطی که با نویسه # یا ; شروع می‌شوند، به عنوان توضیح در نظر گرفته شده و نادیده گرفته می‌شوند.

'.resources'

این قالب باینری پیاده‌سازی‌شده توسط کلاس System.Resources.ResourceReader است که بخشی از mscorlib.dll می‌باشد.

'.resx'

این قالب باینری پیاده‌سازی‌شده توسط کلاس System.Resources.ResXResourceReader است. این کلاس بخشی از mscorlib.dll نبوده و متعلق به System.Windows.Forms است.

'.po'.

فایل‌های PO فایل‌های منبع مورد استفاده توسط زیرساخت gettext یونیکس هستند که معمولاً برای بین‌المللی‌سازی برنامه‌ها به کار می‌رود.

خطوطی که با نویسه '#' آغاز می‌شوند، خطوط توضیح هستند.

فایل شامل نمونه‌های متعددی از رشته‌هایی مانند این است:

msgid KEY
msgstr VALUE
معمولاً KEY رشته‌ای است که باید ترجمه شود و VALUE ترجمه آن است. در فایل‌های PO به جای استفاده از کدها به عنوان KEY (چنانکه در فایل‌های منبع مرسوم است)، معمولاً KEY یک پیام انگلیسی کامل است که برنامه‌ها در کد منبع خود قرار می‌دهند و در صورتی که هیچ منبع ترجمه‌ای استفاده نشود، به عنوان جایگزین (fallback) استفاده خواهد شد.

از آنجا که منابع، جفت‌های کلید-مقدار هستند، ویژگی‌های پیشرفته در فایل‌های PO پشتیبانی نمی‌شوند (حالت‌های جمع و پشتیبانی از N-cases).

برای کسب اطلاعات بیشتر درباره قالب فایل po، از مرورگر info خود استفاده کرده و به گره «(gettext)PO Files» مراجعه کنید.

اگر فایل مقصد مشخص نشده باشد، از source.resources استفاده خواهد شد.

گزینه /compile فهرستی از فایل‌های .resX یا .txt را برای تبدیل به فایل‌های .resources در یک عملیات دسته‌ای دریافت می‌کند و در نام فایل خروجی، .ext را با .resources جایگزین می‌نماید.

این سوئیچ به resgen دستور می‌دهد تا چندین فایل را کامپایل کند. این گزینه باید پیش از مشخص شدن هرگونه منبع در خط فرمان قرار گیرد.

این گزینه تنها برای resgen2 در دسترس است و به resgen دستور می‌دهد تا مسیرهای نسبی را با استفاده از دایرکتوری فایل resx به عنوان دایرکتوری جاری حل کند.

این برنامه اسمبلی‌های ارجاع‌شده را از حافظه پنهان اسمبلی Mono بارگذاری خواهد کرد.

برای جزئیات بیشتر به http://lists.ximian.com/mailman/listinfo/mono-devel-list مراجعه کنید.

برای جزئیات بیشتر مراجعه کنید به: http://www.mono-project.com

mcs(1),mono(1),mono-config(5).