JGMENU-I18N(1) JGMENU-I18N(1)

jgmenu-i18n - بین‌المللی‌سازی و محلی‌سازی منوی jgmenu

jgmenu_run i18n <translation-file>

jgmenu_run i18n --init [<translation-file>]

دستور jgmenu_run i18n داده‌های منوی CSV با فرمت jgmenu را از ورودی استاندارد (stdin) خوانده و آن را ترجمه می‌کند یا یک فایل ترجمه با ساختار po ایجاد می‌نماید.

آرگومان <translation-file> می‌تواند یک فایل یا یک دایرکتوری باشد. اگر دایرکتوری مشخص شود، فایل‌های ترجمه بر اساس متغیر محیطی $LANG در این دایرکتوری جستجو خواهند شد؛ فرض می‌شود که فرمت این متغیر به‌صورت ll_CC.UTF8 است که در آن ll کد زبان دوحرفی ISO 639 و CC کد کشور دوحرفی ISO 3166 است. فایل‌هایی با نام‌های ll_CC و ll به همین ترتیب اولویت استفاده خواهند شد.

--init
ایجاد یک فایل قالب ترجمه با ساختار po همراه با مقادیر خالی msgstr برای شناسه‌های msgid.

ماژول‌های jgmenu-apps(1) و jgmenu-ob(1) دارای پشتیبانی داخلی از i18n (بین‌المللی‌سازی) هستند. برای استفاده از این قابلیت‌ها، یک فایل ترجمه لازم است. در ادامه مثال‌هایی از نحوه ایجاد فایل ترجمه آورده شده است:

مثال ۱:

jgmenu_run ob | jgmenu_run i18n --init >sv

مثال ۲:

jgmenu_run i18n --init <prepend.csv >sv

نتیجه دستورات بالا یک فایل اسکلت ترجمه (در این مثال sv برای زبان سوئدی) خواهد بود که شامل ورودی‌هایی شبیه به این است:

msgid "Web Browser"
msgstr ""

فیلدهای خالی msgstr را به‌صورت دستی ترجمه کنید.

در صورت استفاده از ماژول‌های jgmenu-apps(1) یا jgmenu-ob(1)، کافی است گزینه csv_i18n را در فایل پیکربندی jgmenurc طوری تنظیم کنید که مستقیماً به یک translation-file یا یک دایرکتوری حاوی فایل‌های ترجمه اشاره کند.

در شرایط خاص، ممکن است بخواهید i18n را در خط لوله (پایپ) دستورات بگنجانید. در ادامه یک مثال از نحوه انجام این کار آورده شده است:

<csv-generating-command> \
    | jgmenu_run i18n <translation-file> \
    | jgmenu --vsimple

Johan Malm.

15 February, 2020