.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "JGMENU\-I18N" "1" "15 February, 2020" "" ""
.hy
.SH "نام (NAME)"
.PP
jgmenu\-i18n \- بین‌المللی‌سازی و محلی‌سازی منوی jgmenu
.SH "خلاصه دستور (SYNOPSIS)"
.PP
jgmenu_run i18n <\f[I]translation\-file\f[]>
.PP
jgmenu_run i18n \-\-init [<\f[I]translation\-file\f[]>]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\f[C]jgmenu_run\ i18n\f[]
داده‌های منوی CSV با فرمت jgmenu را از ورودی استاندارد (stdin) خوانده و آن را ترجمه می‌کند یا یک فایل ترجمه با ساختار po ایجاد می‌نماید.
.PP
آرگومان
<\f[I]translation\-file\f[]>
می‌تواند یک فایل یا یک دایرکتوری باشد. اگر دایرکتوری مشخص شود، فایل‌های ترجمه بر اساس متغیر محیطی
.B $LANG
در این دایرکتوری جستجو خواهند شد؛ فرض می‌شود که فرمت این متغیر به‌صورت
\f[C]ll_CC.UTF8\f[]
است که در آن
\f[C]ll\f[]
کد زبان دوحرفی ISO 639 و
\f[C]CC\f[]
کد کشور دوحرفی ISO 3166 است.
فایل‌هایی با نام‌های
\f[C]ll_CC\f[]
و
\f[C]ll\f[]
به همین ترتیب اولویت استفاده خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \f[C]\-\-init\f[]
ایجاد یک فایل قالب ترجمه با ساختار po همراه با مقادیر خالی msgstr برای شناسه‌های msgid.
.RS
.RE
.SH "مثال‌ها (EXAMPLES)"
.SS "ایجاد قالب فایل ترجمه برای ترجمه دستی"
.PP
ماژول‌های
.BR jgmenu\-apps (1)
و
.BR jgmenu\-ob (1)
دارای پشتیبانی داخلی از i18n (بین‌المللی‌سازی) هستند. برای استفاده از این قابلیت‌ها، یک فایل ترجمه لازم است.
در ادامه مثال‌هایی از نحوه ایجاد فایل ترجمه آورده شده است:
.PP
مثال ۱:
.IP
.nf
\f[C]
jgmenu_run\ ob\ |\ jgmenu_run\ i18n\ \-\-init\ >sv
\f[]
.fi
.PP
مثال ۲:
.IP
.nf
\f[C]
jgmenu_run\ i18n\ \-\-init\ <prepend.csv\ >sv
\f[]
.fi
.PP
نتیجه دستورات بالا یک فایل اسکلت ترجمه (در این مثال
\f[C]sv\f[]
برای زبان سوئدی) خواهد بود که شامل ورودی‌هایی شبیه به این است:
.IP
.nf
\f[C]
msgid\ "Web\ Browser"
msgstr\ ""
\f[]
.fi
.PP
فیلدهای خالی msgstr را به‌صورت دستی ترجمه کنید.
.SS "استفاده از فایل ترجمه"
.PP
در صورت استفاده از ماژول‌های
.BR jgmenu\-apps (1)
یا
.BR jgmenu\-ob (1) ،
کافی است گزینه
\f[C]csv_i18n\f[]
را در فایل پیکربندی jgmenurc طوری تنظیم کنید که مستقیماً به یک translation\-file یا یک دایرکتوری حاوی فایل‌های ترجمه اشاره کند.
.PP
در شرایط خاص، ممکن است بخواهید i18n را در خط لوله (پایپ) دستورات بگنجانید.
در ادامه یک مثال از نحوه انجام این کار آورده شده است:
.IP
.nf
\f[C]
<csv\-generating\-command>\ \\
\ \ \ \ |\ jgmenu_run\ i18n\ <translation\-file>\ \\
\ \ \ \ |\ jgmenu\ \-\-vsimple
\f[]
.fi
.SH "نویسندگان (AUTHORS)"
Johan Malm.