April 16, 2015

Genggoro Cantonese-English Dictionary User Guide


Genggoro Cantonese-English Dictionary (GDD-CT) functions as a database component (GDD: Genggoro Dictionary Database) in Genggoro Dictionary Framework (GDF) and therefore you rarely need to interact with it directly except for the options page. For more information about GDF, please read Genggoro Dictionary Framework User Guide. You can download and install GDD-CT from Chrome Web Store.

The following sections assume that you've already read GDF User Guide.

Most of the functionalities described below (except for "romanization schemes" and "tone number styles" options) are only available in Genggoro Dictionary Server Advanced (GDS-A) which is an advanced version of GDS offered to people supporting the GDF project financially via Patreon. Genggoro Dictionary Server Basic (GDS-B) which is freely available on the Chrome Web Store only supports the "hover search" functionality (no popup customization, no search box).


Romanization options

You can change how "romanization" sections of dictionary entries are displayed in the options page. To open the options page, click on GDD-CT's app icon found on the apps page (chrome://apps).

These options are available in GDS-B, too.

Romanization schemes

You can choose a romanization scheme used to display search results (output) and to parse your search terms typed into the search tool (input) from:

  • Yale with tone numbers (default)
  • Yale with tone marks
  • Jyutping

Tone number styles

You can choose a tone number style from:

  • Normal (e.g. [gwong2 dung1])
  • Superscript (e.g. [gwong2 dung1])
  • Subscript (e.g. [gwong2 dung1])

Style Editor

You can define different style information for each (inline) item listed below.

  • Traditional script
    • 1st tone
    • 2nd tone
    • 3rd tone
    • 4th tone
    • 5th tone
    • 6th tone
  • Simplified script
    • 1st tone
    • 2nd tone
    • 3rd tone
    • 4th tone
    • 5th tone
    • 6th tone
  • Romanization
  • Definition

Currently, you can't apply different styles to Chinese characters embedded in the "definition" item. However, setting the "font names" property for the "definition" item like this "{font for English}, {font for Chinese}, {generic font}" (e.g. "Arial, SimSun, serif") makes them rendered reasonably well.

Style Editor

Search Tool

Search Tool

GDD-CT supports the following search methods.

Search by Hanzi

Type a Cantonese word to look up and press the Enter key.

You can use the wildcard characters shown in the table below.

?any character"?菜"
?(full-width)any character"?包"
*zero or more characters"*人"

Search by Romanization


Start your search term with "[" (square bracket) to do a romanization search.

  • Use the romanization scheme chosen in the options page.

  • You can optionally add "]" to the end of your search term (e.g. "[gwong dung]" (good),"[gwong dung" (good)).

  • Syllables must be separated by a space character (e.g. "[gwong dung]" (good), "[gwongdung]" (wrong)).

  • You can optionally add one or more tone numbers to the end of each syllable (e.g. "[gwong2 dung1]", "[ji1 dim23]").

  • You can use (half-width) "?" and "*" as wildcards (e.g. "[gwong dung ?]", "[gwong dung *]").

Search options

The search options allow you to treat certain classes of sounds as the same when you perform a romanization search. You can enable (disable) them in the options page (all options are enabled by default).

The search options can be enabled (disabled) temporarily by adding "search option modifiers" to your search term (e.g. "[yut yu] -i").

  • Modifiers can be placed inside or outside of square brackets (e.g. "[pa1] -h" (good), "[pa1 -h]" (good)).

  • You can use more than one modifiers at the same time (e.g. "[pan] -h -m" (good), "[pan] -hm" (good)).

  • Use the uppercase version to negate the option (e.g. "[pan] -H").

  • Use "-r" ("-R") to enable (disable) all options temporarily. If you combine this modifier with other modifiers, this modifier is applied first regardless of the order in which they appear in your search term (e.g. "[pan] -hR" has the same effect as "[pan] -Rh" (disabling all options but the "h" option)).

The available search options
ModifierDescriptionExample (search term: matched syllables)
-r (-R)Enable (disable) all the romanization search options temporarily.[pa] -R: pa
-a (-A)Treat the long vowel "aa" and the short vowel "a" as the same.[bat] -a: bat, baat
-h (-H)Treat the initial aspirated consonants ("p", "t", "k", "kw", "ch/c") and the corresponding unaspirated ones ("b", "d", "g", "gw", "j/z") as the same.[pa] -h: pa, ba
-p (-P)Treat the final plosive consonants ("-p", "-t", "-k") as the same.[kap] -p: kap, kak, kat
-m (-M)Treat the final nasal consonants ("-m", "-n", "-ng") as the same.[dim] -m: dim, din, ding
-i (-I)Treat the vowel "i" and the vowel "yu" as the same.[din] -i: din, dyun
-w (-W)Treat the initial velar consonants ("g", "k") and the corresponding labialized ones ("gw", "kw") as the same.[gwong] -w: gwong, gong
-l (-L)Treat the initial consonants "l" and "n" as the same.[lap] -l: lap, nap
-n (-N)Treat the initial consonant "ng" (e.g. "nga") and the null initial (e.g. "a") as the same.[nga] -n: nga, a
-o (-O)Treat the vowel "o" and the vowel "ou" as the same.[do] -o: do, dou

Reverse search

Start your search term with "=" (equals) to do a reverse search.

  • If your search term starts with single equals ("=foo"), entries at least one of whose definitions exactly matches the word "foo" are matched.

  • If your search term starts with double equals ("==foo"), entries at least one of whose definitions includes the word "foo" are matched.

  • If your search term starts with triple equals ("===foo"), entries at least one of whose definitions includes the text strings "foo" (e.g. "foot") are matched.

Copyright and License

Genggoro Cantonese-English Dictionary

Copyright (c) 2015 Genggoro. All rights reserved.

No copy, reuse, modification or redistribution is allowed without prior permission from Genggoro.

The statement above doesn't apply to the third-party components bundled with this product. For more information, read the next section.

Third-party components

No comments:

Post a Comment