1GPINYIN(1)                  General Commands Manual                 GPINYIN(1)
2
3
4

NAME

6       gpinyin - Chinese European-like writing within groff
7

SYNOPSIS

9       gpinyin [-] [--] [ filespec ....]
10       gpinyin -h|--help
11       gpinyin -v|--version
12

DESCRIPTION

14       This is a preprocesor for groff(1).  It allows to add the Chinese Euro‐
15       pean-like language Pinyin into groff(7) files.
16

OPTIONS

18   Breaking Options
19       An option is breaking, when the program  just  writes  the  information
20       that was asked for and then stops.  All other arguments will be ignored
21       by that.  The breaking options are here
22
23       -h | --help
24              Print help information with a short explanation  of  options  to
25              standard output.
26
27       -v | --version
28              Print version information to standard output.
29
30   Filespec Options
31       So far, there are only filespec and breaking options.
32
33       filespec  arguments  are  file  names  or the minus sign - for standard
34       input.  As usual, the argument -- can be used in order to let all  fol‐
35       lowing  arguments mean file names, even if the names begin with a minus
36       character -.
37

PINYIN PARTS

39       Pinyin parts in groff files are enclosed by two .pinyin  requests  with
40       different arguments.  The starting request is
41              \.pinyin start
42       or
43              \.pinyin begin
44       and the ending request is
45              \.pinyin stop
46       or
47              \.pinyin end
48

PINYIN DETAILS

50       Pinyin  is  used  for  writing  the Chinese language in a European-like
51       (romanization) way.  The Chinese language consists  of  more  than  400
52       syllables,  each  with one of 5 different tones.  In Pinyin, such toned
53       syllables can be appended to word-like connections.
54
55   Syllables
56       The Chinese language is based  on  about  411  defined  syllables,  see
57http://en.wikipedia.org/wiki/Pinyin_table⟩.
58
59       In  Pinyin, each syllable consists of 1 to 6 European-like letters, the
60       normal ASCII characters in upper and lower case, the only unusual char‐
61       acters are the U dieresis (umlaut) in both cases, i.e.  [a-zA-ZüÜ].
62
63       In  the  groff  gpinyin  input, all ASCII letters are written as usual.
64       But the u/U dieresis can be written as either as \['u] or ue  in  lower
65       case or \['U], Ue, UE in upper case.
66
67   Tones
68       Each  syllable has exactly one of 5 defined tones.  The 5th tone is not
69       written at all, but each tone 1 to 4 is written as an  accent  above  a
70       defined vowel within the syllable.
71
72       In  the  source file, these tones are written by adding a number 0 to 5
73       after the syllable name.
74
75       In each writing, the tone numbers 1 to 4 are transformed  into  accents
76       above vowels.
77
78       The  1st  tone is the horizontal macron \[a-] ¯ , similar to a minus or
79       sub character, but on top of the vowel.  In each source file, write the
80       1st tone as syllable1.
81
82       The  2nd tone is the accute accent \[aa] ´.  In each source file, write
83       the 2nd tone as syllable2.
84
85       The 3rd tone is the caron sign, \[ah] ˇ , which  looks  a  bit  like  a
86       small  v  above  the vowel.  In each source file, write the 3rd tone as
87       syllable3.
88
89       The 4th tone is the grave accent \[ga] `.  In each source  file,  write
90       the 4th tone as syllable4.
91
92       The  5th  tone is the no-tone.  The numbers 0 and 5 can be used for the
93       (no-tone).  The no-tone number can be omitted, when the syllable is the
94       end  of  some word.  But within a word of syllables, one of the no-tone
95       numbers 0 or 5 must be written.
96

SEE ALSO

98       groff(1)
99       grog(1)
100       groffer(1)
101              Man-pages with section 1 related to groff.  They can  be  called
102              with either
103                     man name
104                     groffername
105
106       groff(7)
107       groff_char(7)
108              Man-pages  with  section 7 related to groff.  They can be called
109              with either
110                     man 7 name
111                     groffer 7 name
112
113       Internet documents related to pinyin are
114              Wikipedia pinyinhttp://en.wikipedia.org/wiki/Pinyin⟩,
115              Pinyin Tablehttp://en.wikipedia.org/wiki/Pinyin_table⟩,
116              Unicode vowels for  Pinyin  ⟨http://;www.sino.uni-heidelberg.de/
117              course_resources/s02/py-vowels.htm⟩,
118              pinyintoUnicodehttp://www.foolsworkshop.com/ptou/index.html⟩,
119              Online Chinese Toolshttp://www.mandarintools.com/⟩,
120              Main pinyin websitehttp://www.pinyin.info/index.html⟩,
121              Where  do  the  tone  marks  go?http://www.pinyin.info/rules/
122              where.html⟩,
123              Pinyin   for    TeX    1http://git.savannah.gnu.org/gitweb/
124              ?p=cjk.git;a=blob_plain;f=doc/pinyin.txt;hb=HEAD⟩,
125              Pinyin    for    TeX    2http://git.savannah.gnu.org/gitweb/
126              ?p=cjk.git;a=blob_plain;f=texinput/pinyin.sty;hb=HEAD⟩.
127

COPYING

129       Copyright © 2014 Free Software Foundation, Inc.
130
131       This file is part of gpinyin, which is part of groff, a  free  software
132       project.
133
134       You  can  redistribute  it  and/or modify it under the terms of the GNU
135       General Public License version 2 as  published  by  the  Free  Software
136       Foundation.
137
138       The    license    text    is    available    in    the    internet   at
139http://www.gnu.org/licenses/gpl-2.0.html⟩.
140

AUTHORS

142       This file was written by Bernd Warken <groff-bernd.warken-72@web.de>.
143
144
145
146Groff Version 1.22.3            4 November 2014                     GPINYIN(1)
Impressum