1GPINYIN(1) General Commands Manual GPINYIN(1)
2
3
4
6 gpinyin - Chinese European-like writing within groff
7
9 gpinyin [-] [--] [ filespec ....]
10 gpinyin -h|--help
11 gpinyin -v|--version
12
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
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
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
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
57 ⟨http://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
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 pinyin ⟨http://en.wikipedia.org/wiki/Pinyin⟩,
115 Pinyin Table ⟨http://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 pinyintoUnicode ⟨http://www.foolsworkshop.com/ptou/index.html⟩,
119 Online Chinese Tools ⟨http://www.mandarintools.com/⟩,
120 Main pinyin website ⟨http://www.pinyin.info/index.html⟩,
121 Where do the tone marks go? ⟨http://www.pinyin.info/rules/
122 where.html⟩,
123 Pinyin for TeX 1 ⟨http://git.savannah.gnu.org/gitweb/
124 ?p=cjk.git;a=blob_plain;f=doc/pinyin.txt;hb=HEAD⟩,
125 Pinyin for TeX 2 ⟨http://git.savannah.gnu.org/gitweb/
126 ?p=cjk.git;a=blob_plain;f=texinput/pinyin.sty;hb=HEAD⟩.
127
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
139 ⟨http://www.gnu.org/licenses/gpl-2.0.html⟩.
140
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)