.\" $Id: kakasi.1,v 1.3 2014-02-03 07:07:16 knok Exp $ .\" Copyright (C) 1992 .\" Hironobu Takahashi (takahasi@tiny.or.jp) .\" Translated to English by J. Grant, and H. Baba .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either versions 2, or (at your option) .\" any later version. .\" .\" This program is distributed in the hope that it will be useful .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with KAKASI, see the file COPYING. If not, write to the Free .\" Software Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, USA. .\" .de Sp .if t .sp .5v .if n .sp .. .de Ip .br .ie \\n.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH KAKASI 1 LOCAL .UC 6 .SH "نام (NAME)" KAKASI \- مبدل ساده کانجی به کانا (تبدیل بین کانجی، هر دو نوع کانا و روماجی) .SH "خلاصه دستور (SYNOPSIS)" .B kakasi [گزینه‌ها] [jisyo1 [jisyo2 [jisyo1,,]]] .SH "توضیحات (DESCRIPTION)" .I KAKASI جملات در زبان ژاپنی اغلب از ترکیبی از نویسه‌های چینی (Kanji)، کانا (شامل Hiragana و Katakana) و روماجی (Romaji، تلفظ آوایی به خط لاتین) تشکیل شده‌اند. این برنامه کار تبدیل بین این چهار شیوه مختلف نوشتن زبان ژاپنی را انجام می‌دهد. این برنامه برای کسانی که پایانه یا میزکار آن‌ها از نمایش بومی ژاپنی پشتیبانی نمی‌کند بسیار کاربردی است. همچنین ابزاری عالی برای زبان‌آموزان ژاپنی (دانشجویان بین‌المللی، کودکان و غیره) به شمار می‌رود. یک کلمه را می‌توان به ورودی استاندارد (stdin) فرستاد تا تبدیل شود و در خروجی استاندارد (stdout) قرار گیرد. در مثال زیر کانجی «bunchu» به Hiragana تبدیل می‌شود: .PP .Ip "" 10 kakasi \-JH < document .PP از نگارش 2.3.0 به بعد، متن دارای فاصله بین کلمات پشتیبانی می‌شود. در مثال زیر، خروجی دارای فاصله میان تک‌تک کلمات است: .Ip "" 10 kakasi \-w < document .PP از نگارش 2.3.5 به بعد، حالت تبدیل سطحی پشتیبانی می‌شود. در مثال زیر، کانجی‌های ساده دست‌نخورده باقی می‌مانند و کانجی‌های دشوار به Hiragana ترجمه می‌شوند: .Ip "" 10 kakasi \-l4 < document .PP توسط .I KAKASI امکان تبدیل حروف به نویسه‌های الفبایی وجود دارد. همچنین حروف Katakana در مجموعه نویسه JIS x0201 و Hiragana در مجموعه نویسه JIS x0208 را می‌توان به یکدیگر تبدیل کرد. .PP مجموعه نویسه‌های زیر که درون قلاب‌ها قرار دارند، پشتیبانی می‌شوند: .PP .Ip "ASCII (a)" 10 به عنوان مجموعه نویسه «ascii» شناخته می‌شود. .PP .Ip "JISROMAN (j)" 10 به عنوان مجموعه نویسه «jis roman» شناخته می‌شود. .PP .Ip "GRAPHIC (g)" 10 مجموعه نویسه گرافیکی DEC است. .PP .Ip "Katakana (k)" 10 .br JIS x0201، که به عنوان بخشی از مجموعه نویسه GR تعریف شده است. .PP .Ip "" 10 جهت سهولت، مجموعه JIS x0208 به شرح زیر تقسیم‌بندی شده است: .PP .Ip "Kanji (J)" 10 .br نویسه‌های JIS x0208 قرار گرفته در بخش‌های ۱۶ تا ۹۴. .Ip "Hiragana (H)" 10 .br نویسه‌های JIS x0208 قرار گرفته در بخش ۴ (Hiragana). .Ip "Katakana (K)" 10 .br نویسه‌های JIS x0208 قرار گرفته در بخش ۵ (Katakana). .Ip "Sign (E)" .br نویسه‌های JIS x0208 قرار گرفته در بخش‌های ۱، ۲، ۳، ۶، ۷ و ۸. (توجه داشته باشید که بخش‌های ۹ تا ۱۵ در JIS x0208 تعریف نشده‌اند.) .PP تبدیل میان مجموعه‌های نویسه زیر در دسترس است: .PP .Ip "ASCII" 13 -> JISROMAN, Sign .Ip "JISROMAN" 13 -> ASCII, Sign .Ip "GRAPHIC" 13 -> ASCII, JISROMAN, Sign .Ip "JISx0201 Katakana" 13 -> ASCII, JISROMAN, Kana, Hiragana .Ip "Sign" 13 -> ASCII, JISROMAN .Ip "Katakana" 13 -> ASCII, JISROMAN, JISx0201 Katakana, Hiragana .Ip "Hiragana" 13 -> ASCII, JISROMAN, JISx0201 Katakana, Kana .Ip "Kanji" 13 -> ASCII, JISROMAN, JISx0201 Katakana, Kana, Hiragana .PP با تبدیل ASCII و JISROMAN، تبدیل نویسه الفبایی از JISx0201 Katakana، Katakana، Hiragana و Kanji انجام می‌پذیرد. .PP .Ip "مثال‌ها:" 4 .sp ۱. تمام نویسه‌های کانجی به Hiragana تبدیل می‌شوند: .sp kakasi \-JH .sp ۲. تمام نویسه‌های JIS x0208 به JIS X 0201 تبدیل می‌شوند: .sp .sp kakasi \-Hk \-Kk \-Jk \-Ea .sp ۳. تمام نویسه‌ها به JIS X 0208 تبدیل می‌شوند: .sp kakasi \-aE \-jE \-gE \-kK .sp ۴. تمام نویسه‌ها به ascii تبدیل شده و کلمات جدا می‌شوند: .sp kakasi \-Ha \-Ka \-Ja \-Ea \-ka .sp ۵. تبدیل متقابل میان نویسه‌های Katakana و Hiragana: .sp kakasi \-HK \-KH .PP .SH "مجموعه نویسه‌های تعیین‌شده برای تبدیل (CONVERSION DESIGNATED CHARACTER SET)" برخی از مجموعه‌های نویسه توسط kakasi دسته‌بندی شده و با نشانه‌های اختصاری زیر مشخص می‌شوند: a، j، g، k، E، H، K، J. a \-\-\- نویسه‌های ASCII j \-\-\- نویسه‌های JIS ROMAN (تقریباً معادل ASCII؛ نمادهای «~» و «\» متفاوت هستند) تعریف‌شده توسط JIS x0201 g \-\-\- نویسه‌های گرافیکی DEC k \-\-\- نویسه‌های KATAKANA تعریف‌شده توسط JIS x0201 نویسه‌های E، H، K و J در مجموعه نویسه JIS x0208 قرار دارند. J \-\-\- نویسه‌های KANJI در JIS x0208. H \-\-\- نویسه‌های HIRAGANA در JIS x0208. K \-\-\- نویسه‌های KATAKANA در JIS x0208. E \-\-\- باقی نویسه‌های فوق در JIS x0208 شامل حروف لاتین، اعداد، نمادها و غیره. عبارت \-(from)(to) به معنی تبدیل از مجموعه نویسه (from) به (to) است. برای نمونه، گزینه \-JK باعث تبدیل نویسه‌های KANJI به HIRAGANA می‌شود. ترکیب‌های جدول زیر قابل استفاده هستند: (نیازی به حفظ آن نیست، چرا که گزینه \-h نیز همین اطلاعات را نمایش می‌دهد) to\\from| a j k E H K J g \-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- a | \- o o1 o o1 o1 o12 o j | o \- o1 o o1 o1 o12 o k | \- o o o2 E | o o \- o H | o \- o o2 K | o o \- o \-\- تبدیل می‌شود. 1 \-\- به Romaji تبدیل می‌شود. 2 \-\- تبدیل Kanji \-> Kana. .SH "تبدیل کدگذاری کانجی (KANJI CODING CONVERSION)" متأسفانه سامانه‌های کدگذاری گوناگونی در ژاپن استفاده می‌شوند و استاندارد JIS x0208 نیز در سال ۱۹۸۳ دستخوش تغییر شد. بنابراین KAKASI می‌تواند به‌طور خودکار سامانه کدگذاری و نسخه آن را تشخیص داده و در صورتی که سند شامل JIS x0201 KATAKANA نباشد، از همان سامانه کدگذاری خروجی استفاده کند. اگر JIS x0201 KATAKANA در سند وجود دارد یا مایلید سامانه کدگذاری کانجی را تغییر دهید، می‌توانید از گزینه‌های زیر استفاده نمایید: \-i : کدگذاری ورودی \-o : کدگذاری خروجی jis \-\- کاربرد گسترده در اینترنت (مانند گروه‌های خبری fj، jp و...). برگرفته از روش کدگذاری ISO\-2022. newjis: JISx0208 (1983) فراخوانی‌شده توسط ESC\-$\-B. oldjis: JISx0208 (1978) فراخوانی‌شده توسط ESC\-$\-@. euc,dec \-\- اغلب در رایانه‌های شبه‌یونیکس استفاده می‌شود. JISx0208 به ‏GR اختصاص داده شده است (MSB برابر ۱ است). تفاوت اصلی میان euc و dec در تخصیص JISx0201 KATAKANA و نویسه گرافیکی DEC است. sjis \-\- تعریف‌شده توسط شرکت مایکروسافت. استفاده گسترده در رایانه‌های شخصی (MSDOS، Mac و...). utf8 \-\- استاندارد بین‌المللی کنونی. تمامی سیستم‌عامل‌های مدرن از این کدگذاریِ مجموعه نویسه Unicode به صورت پیش‌فرض استفاده می‌کنند. .SH "تبدیل روماجی (ROMAJI CONVERSION)" گزینه‌های تبدیل کانجی به کانا؛ که همراه با گزینه \-J? به کار می‌روند. دو شیوه نگارش Romaji وجود دارد: روش نخست روش Kunrei تعریف‌شده توسط دولت ژاپن است، و روش دوم روش Hepburn می‌باشد. روش Hepburn برای افراد غیرژاپنی بسیار طبیعی‌تر به گوش می‌رسد. \-rhepburn : روش Hepburn (پیش‌فرض) \-rkunrei : روش Kunrei .SH "گزینه‌های دیگر (OTHER OPTIONS)" \-p: فهرست کردن تمامی خوانش‌های ممکن. در صورت وجود دو یا چند خوانش ممکن، KAKASI آن‌ها را درون آکولاد {aaa,bbb} نمایش می‌دهد. \-s: درج نویسه جداکننده میان کلمات. \-f: حالت Furigana. نمایش کلمه اصلی کانجی به همراه نحوه خواندن آن. \-c: نادیده‌گرفتن نویسه‌های درون کلمه (پیش‌فرض TAB CR LF BLANK). \-C: بزرگ نوشتن حرف اول کلمه Romaji (همراه با گزینه \-Ja یا \-Jj). \-U: بزرگ نوشتن تمام حروف کلمه romaji (همراه با گزینه \-Ja یا \-Jj). \-u: فراخوانی ()fflush. \-w: حالت wakatigaki. اصطلاح «wakatigaki» تفکیک و بخش‌بندی کلمات در جملات ژاپنی است. .SH "فرهنگ‌های لغت (DICTIONARIES)" برنامه .I KAKASI می‌تواند علاوه بر فرهنگ لغت سیستم، فرهنگ‌های لغت تکمیلی را نیز بپذیرد. قالب قابل قبول برای فرهنگ لغت تکمیلی شامل قالب .I SKK قالب .I Wnn و غیره است. بدین معنا که هر رکورد یک خط شامل دو فیلد Yomi (خواندن) و Jukugo (اصطلاح/ترکیب) است. فیلدها با کاما (یا TAB یا فاصله) از هم جدا می‌شوند. کد کانجی به JIS یا EUC محدود است. برای جزئیات بیشتر به سند دیگری به نام JISYO مراجعه نمایید. .SH "محیط (ENVIRONMENT)" عملکرد برنامه تحت تأثیر متغیرهای محیطی زیر قرار می‌گیرد: .Ip KANWADICTPATH مسیر فایل kanwadict را مشخص می‌کند (مسیر کامل شامل نام فایل). مقدار پیش‌فرض $prefix/share/kakasi/kanwadict است. .Ip ITAIJIDICTPATH مسیر فایل itaijidict را مشخص می‌کند (مسیر کامل شامل نام فایل). مقدار پیش‌فرض $prefix/share/kakasi/itaijidict است. .SH "نویسندگان (AUTHORS)" Hironobu Takahasi .SH "فایل‌ها (FILES)" .Ip "$prefix/share/kakasi/kanwadict" فرهنگ لغت باینری .I KAKASI است. این فایل هنگام نصب بسته، به‌طور خودکار توسط mkkanwa از kakasidict تبدیل می‌شود. .SH "همچنین ببینید (SEE ALSO)" mkkanwa(1) .SH "خطاها (DIAGNOSTICS)" در صورت بروز هرگونه مشکل، وضعیت خروجی مقداری غیر از ۰ خواهد بود. .SH "گزارش باگ‌ها (BUGS)" گزارش اشکالات را به پروژه KAKASI به نشانی ارسال فرمایید. لطفاً با پدیدآورنده اصلی (جناب Takahasi) تماس نگیرید. .SH "نکته درباره راهنمای انگلیسی (NOTE ABOUT ENGLISH MANUAL)" محتوای راهنمای انگلیسی دقیقاً با محتوای راهنمای ژاپنی یکسان نیست.