'\" t .TH gpinyin 1 "2026-03-15" "groff 1.24.1" .SH "نام (NAME)" gpinyin \- استفاده از نویسه‌گردانی هانیو پینیین چینی در اسناد groff . . .\" ==================================================================== .\" Legal Terms .\" ==================================================================== .\" .\" Copyright 2014-2020 Free Software Foundation, Inc. .\" .\" This file is part of gpinyin. .\" .\" gpinyin is distributed with groff, the GNU roff typesetting system. .\" .\" groff 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 version 3 of the License, or .\" (at your option) any later version. .\" .\" groff 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 this program. If not, see .\" . . . .\" Save and disable compatibility mode (for, e.g., Solaris 10/11). .do nr *groff_gpinyin_1_man_C \n[.cp] .cp 0 . .\" Define fallback for groff 1.23's MR macro if the system lacks it. .nr do-fallback 0 .if !\n(.f .nr do-fallback 1 \" mandoc .if \n(.g .if !d MR .nr do-fallback 1 \" older groff .if !\n(.g .nr do-fallback 1 \" non-groff *roff .if \n[do-fallback] \{\ . de MR . ie \\n(.$=1 \ . I \%\\$1 . el \ . IR \%\\$1 (\\$2)\\$3 . . .\} .rr do-fallback . . .\" ==================================================================== .\" Local definitions .\" ==================================================================== . .\" Define a string for the TeX logo. .ie t .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X .el .ds TeX TeX . . .\" ==================================================================== .SH "خلاصه دستور (SYNOPSIS)" .\" ==================================================================== . .SY gpinyin .RI [ file\~ .\|.\|.] .YS . . .P .SY gpinyin .B \-h .YS . .SY gpinyin .B \-\-help .YS . . .P .SY gpinyin .B \-v .YS . .SY gpinyin .B \%\-\-version .YS . . .\" ==================================================================== .SH "توضیحات (DESCRIPTION)" .\" ==================================================================== . دستور .I gpinyin یک پیش‌پردازنده برای .MR groff 1 است که استفاده از هانیو پینیین چینی را در فایل‌های .MR groff 7 تسهیل می‌کند. . پینیین روشی برای نوشتن زبان چینی ماندارین با استفاده از الفبای لاتین است. . چینی ماندارین از بیش از چهارصد هجای پایه تشکیل شده است، که هر یک با یکی از پنج نواخت مختلف بیان می‌شوند. . تغییر نواخت اعمال‌شده بر روی هجا معمولاً معنای کلمه‌ای را که تشکیل می‌دهد تغییر می‌دهد. . در پینیین، یک هجا با الفبای لاتین نوشته می‌شود و یک نشانگر عددی نواخت می‌تواند به انتهای هر هجا افزوده شود. . . .P هر .I input-file یک نام فایل یا نویسه .RB \[lq] \- \[rq] برای اشاره به خواندن از جریان ورودی استاندارد است. . طبق معمول، شناسه .RB \[lq] \-\- \[rq] می‌تواند برای وادار کردن برنامه به تفسیر تمامی شناسه‌های باقی‌مانده به عنوان نام فایل به کار رود، حتی اگر یک شناسه .I input-file با نویسه .RB \[lq] \- \[rq] آغاز شود. . گزینه‌های .B \-h و .B \-\-help پیام نحوه استفاده را نمایش می‌دهند، در حالی که گزینه‌های .B \-v و .B \%\-\-version اطلاعات نسخه برنامه را نمایش می‌دهند؛ تمامی آن‌ها پس از اجرا بلافاصله خارج می‌شوند. . . .\" ==================================================================== .SS "بخش‌های پینیین" .\" ==================================================================== . بخش‌های پینیین در فایل‌های .I groff بین دو درخواست .B .pinyin با آرگومان‌های متفاوت محصور می‌شوند. . درخواست شروع به صورت زیر است: .RS .EX \&.pinyin start .EE .RE یا .RS .EX \&.pinyin begin .EE .RE و درخواست پایانی به صورت زیر است: .RS .EX \&.pinyin stop .EE .RE یا .RS .EX \&.pinyin end .EE .RE \&. . . .\" ==================================================================== .SS "هجاها" .\" ==================================================================== . در پینیین، هر هجا با یک تا شش حرف برگرفته از پنجاه و دو حرف کوچک و بزرگ مجموعه نویسه‌های لاتین پایه یونیکد، به همراه حرف \[lq]U\[rq] با دونقطه (اوملاوت / dieresis) در هر دو حالت کوچک و بزرگ نشان داده می‌شود\[em]به عبارت دیگر، اعضای مجموعه \[lq][a\[en]zA\[en]Z\[:u]\[:U]]\[rq]. . . .P در ورودی .IR groff ، تمامی حروف لاتین پایه به همان صورت اصلی خود نوشته می‌شوند. . حرف \[lq]u با دونقطه\[rq] می‌تواند به صورت \[lq]\e[:u]\[rq] در حالت کوچک یا \[lq]\e[:U]\[rq] در حالت بزرگ نوشته شود. . درون بخش‌های .BR .pinyin ، دستور .I gpinyin از شکل \[lq]ue\[rq] برای حالت کوچک و از شکل‌های \[lq]Ue\[rq] و \[lq]UE\[rq] برای حالت بزرگ پشتیبانی می‌کند. . . .\" ==================================================================== .SS "نواخت‌ها" .\" ==================================================================== . هر هجا دقیقاً یکی از پنج .I نواخت را داراست. . نواخت پنجم به هیچ وجه به صراحت نوشته نمی‌شود، اما هر یک از نواخت‌های اول تا چهارم با یک علامت تفکیک‌کننده بر فراز یک مصوت خاص درون هجا مشخص می‌شوند. . . .P در یک فایل منبع .IR gpinyin ، این نواخت‌ها با افزودن یک رقم در محدوده 0 تا 5 پس از هجا نوشته می‌شوند. . شماره‌های نواخت 1 تا 4 در خروجی به علامت‌های اعراب (آکسان) بالای مصوت‌ها تبدیل می‌شوند. . شماره‌های نواخت 0 و 5 مترادف یکدیگر هستند. . . .P .nr gpinyin*do-table 0 .if t .nr gpinyin*do-table 1 .if n .if '\*[.T]'utf8' .nr gpinyin*do-table 1 .\" XXX: One hack necessitates another; since our table is conditional, .\" we need to save the input line counter. .nr gpinyin*.c \n[.c] .ie \n[gpinyin*do-table] \{\ نواخت‌ها به شرح زیر نوشته می‌شوند: . . .P .\" XXX: This is so gross. Why can't grops and gropdf figure this out? .if t .ds a- \za\[a-] .if n .ds a- \[a a-] .if t .ds a< \za\[ah] .if n .ds a< \[a ah] .if t .ne 8 \" Try to keep the table on one page for printed output. .TS l l l l l. نواخت توضیح علامت ورودی نمونه خروجی نمونه _ اول صاف \[a-] ma1 m\*[a-] دوم صعودی \[aa] ma2 m\[a aa] سوم افت‌وخیز \[ah] ma3 m\*[a<] چهارم نزولی \[ga] ma4 m\[a ga] پنجم خنثی (ندارد) ma0 ma \^ \^ \^ ma5 \^ .TE .\} .lf (\n[gpinyin*.c] + 25) \" XXX part 2: Restore input line counter. .el \{\ [جدول علامت‌های نواخت از این خروجی صفحه راهنما حذف شده است زیرا دستگاه خروجی انتخاب‌شده \[lq]\*[.T]\[rq] فاقد نویسه‌های لازم برای نمایش آن است. . یک دستگاه خروجی دیگر را امتحان کنید.] .\} .rm a- .rm a< .rr gpinyin*do-table . . .P شماره نواخت خنثی را می‌توان از هجای پایانی کلمه حذف کرد، اما در غیر این صورت خیر. . . .\" ==================================================================== .SH "نویسندگان (AUTHORS)" .\" ==================================================================== . دستور .I gpinyin توسط .MT groff\-bernd\:.warken\-72@\:web\:.de Bernd Warken .ME نوشته شده است. . . .\" ==================================================================== .SH "همچنین ببینید (SEE ALSO)" .\" ==================================================================== . اسناد مفید مرتبط با پینیین در وب جهان‌گستر شامل موارد زیر است: .RS 4n .UR http://\:www\:.foolsworkshop\:.com/\:ptou/\:index\:.html .I Pinyin to Unicode .UE , . .br .UR http://\:www\:.mandarintools\:.com .I On-line Chinese Tools \" sic: On-line .UE , . .br .\" XXX: Turning off adjustment like this is ugly; thanks to meter-long .\" URLs we need an escape sequence that selectively disables adjustment .\" at the end of a word. .na .UR http://\:www\:.pinyin\:.info/\:index\:.html .I Pinyin.info: a guide to the writing of Mandarin Chinese in \ romanization .UE , .\" XXX: cringe .ie d AD .ad \*[AD] .el .ad b . .br .UR http://\:www\:.pinyin\:.info/\:rules/\:where.html \[lq]Where do the tone marks go?\[rq] .UE , . .br .UR http://\:git\:.savannah\:.gnu\:.org/\:gitweb/\:\ ?p=cjk\:.git\:;a=blob_plain\:;f=doc/\:pinyin\:.txt\:;hb=HEAD .I pinyin.txt از بسته ماکروی CJK برای \*[TeX] .UE , .br .RS -4n و .RE . .br .\" XXX: Same ugliness as before. .na .UR http://\:git\:.savannah\:.gnu\:.org/\:gitweb/\:\ ?p=cjk\:.git\:;a=blob_plain\:;f=texinput/\:pinyin\:.sty\:;hb=HEAD .I pinyin.sty از بسته ماکروی CJK برای \*[TeX] .UE . .\" XXX: cringe .ie d AD .ad \*[AD] .el .ad b . .RE . . .P صفحات راهنمای .MR groff 1 و .MR grog 1 نحوه مشاهده اسناد .I roff را توضیح می‌دهند. . . .P صفحات راهنمای .MR groff 7 و .MR groff_char 7 مراجع جامعی هستند که به ترتیب عناصر زبانی GNU .I troff \" GNU و مجموعه گلیف‌های دردسترس را پوشش می‌دهند. . . .\" Clean up. .rm TeX . .\" Restore compatibility mode (for, e.g., Solaris 10/11). .cp \n[*groff_gpinyin_1_man_C] .do rr *groff_gpinyin_1_man_C . . .\" Local Variables: .\" fill-column: 72 .\" mode: nroff .\" End: .\" vim: set filetype=groff textwidth=72: