gpinyin(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

gpinyin(1)

gpinyin(1)                  General Commands Manual                 gpinyin(1)

Name
       gpinyin - use Hanyu Pinyin Chinese in groff documents

Synopsis
       gpinyin [file ...]

       gpinyin -h
       gpinyin --help

       gpinyin -v
       gpinyin --version

Description
       gpinyin  is  a  preprocessor for groff(1) that facilitates use of Hanyu
       Pinyin in groff(7) files.  Pinyin is a method for writing the  Mandarin
       Chinese  language  with  the Latin alphabet.  Mandarin consists of more
       than four hundred base syllables, each spoken with one of five  differ‐
       ent  tones.  Changing the tone applied to the syllable generally alters
       the meaning of the word it forms.  In Pinyin, a syllable is written  in
       the Latin alphabet and a numeric tone indicator can be appended to each
       syllable.

       Each  input-file  is  a file name or the character “-” to indicate that
       the standard input stream should be read.  As usual, the argument  “--”
       can be used in order to force interpretation of all remaining arguments
       as  file  names,  even if an input-file argument begins with a “-”.  -h
       and --help display a usage message, while -v and --version show version
       information; all exit afterward.

   Pinyin sections
       Pinyin sections in groff files are enclosed  by  two  .pinyin  requests
       with different arguments.  The starting request is
              .pinyin start
       or
              .pinyin begin
       and the ending request is
              .pinyin stop
       or
              .pinyin end
       .

   Syllables
       In  Pinyin,  each  syllable  is represented by one to six letters drawn
       from the fifty-two upper- and lowercase letters of  the  Unicode  basic
       Latin character set, plus the letter “U” with dieresis (umlaut) in both
       cases—in other words, the members of the set “[a–zA–ZüÜ]”.

       In groff input, all basic Latin letters are written as themselves.  The
       “u  with dieresis” can be written as “\[:u]” in lowercase or “\[:U]” in
       uppercase.  Within .pinyin sections, gpinyin supports the form “ue” for
       lowercase and the forms “Ue” and “UE” for uppercase.

   Tones
       Each syllable has exactly one of five tones.  The fifth tone is not ex‐
       plicitly written at all, but each of the first through fourth tones  is
       indicated with a diacritic above a specific vowel within the syllable.

       In  a  gpinyin source file, these tones are written by adding a numeral
       in the range 0 to 5 after the syllable.  The tone numbers 1  to  4  are
       transformed  into accents above vowels in the output.  The tone numbers
       0 and 5 are synonymous.

       The tones are written as follows.

       l l l l l.  Tone Description    Diacritic Example Input  Example Output
       _     first     flat ¯    ma1  mā      second    rising    ´    ma2  má
       third     falling-rising ˇ    ma3  mǎ  fourth    falling   `    ma4  mà
       fifth     neutral   (none)    ma0  ma                ma5

       The neutral tone number can be omitted from a word-final syllable,  but
       not otherwise.

Authors
       gpinyin was written by Bernd Warken ⟨groff-bernd.warken-72@web.de⟩.

See also
       Useful documents on the World Wide Web related to Pinyin include
           Pinyin to Unicode ⟨http://www.foolsworkshop.com/ptou/index.html⟩,
           On-line Chinese Tools ⟨http://www.mandarintools.com/⟩,
           Pinyin.info: a guide to the writing of Mandarin Chinese in roman‐
           ization ⟨http://www.pinyin.info/index.html⟩,
           “Where  do  the  tone  marks  go?”   ⟨http://www.pinyin.info/rules/
           where.html⟩,
           pinyin.txt from the CJK macro package for TeX  ⟨http://git.savannah
           .gnu.org/gitweb/?p=cjk.git;a=blob_plain;f=doc/pinyin.txt;hb=HEAD⟩,
       and
           pinyin.sty from the CJK macro package for TeX ⟨http://git.savannah
           .gnu.org/gitweb/?p=cjk.git;a=blob_plain;f=texinput/pinyin.sty
           ;hb=HEAD⟩.

       groff(1) and grog(1) explain how to view roff documents.

       groff(7)  and  groff_char(7)  are comprehensive references covering the
       language elements of GNU troff and the available glyph repertoire,  re‐
       spectively.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   text/groff = Stability Uncommitted

NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://ftp.gnu.org/gnu/groff/groff-1.23.0.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/groff.

groff 1.23.0                      2 July 2023                       gpinyin(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3