February 20, 2015

GDF User Guide - Tutorial 2

In this tutorial, we'll try to accomplish the same task as the previous page (looking up a Chinese word in Genggoro Chinese-English Dictionary (GCED), but this time with Genggoro Dictionary Client for Mozilla Firefox® (GDC-FF) instead of GDC for Google Chrome™ (GDC-CR). I assume that you've already read Tutorial 1. If not, read it before moving on as I omit information already provided there.

Other non-Chrome GDCs work the same way as GDC-FF, so even if you don't intend to use GDC-FF, it's still worth giving a quick read through.

The development of GDC-FF is suspended now because Firefox's add-on system is in the process of migrating to the model similar to Chrome's. I'll resume the development once the new system has matured enough.

Install Genggoro Dictionary Server Basic

Install Genggoro Dictionary Server Basic (GDS-B) if you haven't done it yet. See Tutorial 1 for detail.

Install GCED

Install GCED if you haven't done it yet. See Tutorial 1 for detail.

Register GCED to GDS-B

Register GCED to GDS-B if you haven't done it yet. See Tutorial 1 for detail.

Install GDC-FF

  1. Download the latest version of GDC-FF (gdc-ff-X.Y.Z.xpi ("X.Y.Z" part indicates the version number)) from this page and save it in a folder of your choice. I have a plan to have GDC-FF hosted on AMO, but it seems to take some time to be approved.

  2. Launch Firefox. Open the add-on manager page (about:addons) and select "Install Add-on From File" from the drop-down menu to install GDC-FF.

Test the search functionality

  1. To allow non-Chrome GDCs to connect to the GDS, you need to run a "local server". A local server is a server running on your machine but never connects to or be connected from the outside world (thus no security issue involved, don't worry). To start a local server, open the dictionary manager and click the "Run" button as shown below. Now, you can close either the dictionary manager or Chrome browser if you want, but don't close both.

    If you get a message saying "Failed to run local server", that's most likely because other program running on your machine already uses the same "port number" as we attempted to use (it's not important what "port number" means here but if you want to learn more about it, please read this). In that case, open the settings window (by clicking the "Settings" button) and change the value in the "port number" field ("8000" by default) to something else such as "8001", "8002", etc. and copy the new port number to the "port number" field found in the options page of GDC-FF.

    The settings window of GDS
    The options page of GDC-FF
  2. Click the "balloon" icon on the toolbar to connect to the GDS and get a list of the available GDDs. Then, click "Genggoro Chinese Dictionary" (or check the checkbox next to the label) to select GCED. A small icon (badge) with the two-letter code for the selected GDD ("ZH" in this case) will be shown on top of the "balloon" icon if GCED is ready to use.

  3. Press the Ctrl key, then (while holding down the Ctrl key) move the cursor to the first character of the sample text below (), then wait a while without moving the cursor.


  4. You should see a popup as shown below.

  5. Click the "(-)" icon (or press the Esc key) to hide the popup.

  6. Open the panel again and click "Genggoro Chinese Dictionary" (or uncheck the checkbox) to deselect GCED.

  7. Open the dictionary manager and click the "Disconnect" button to close the connection between the GDS and GCED.

  8. Stop the local server by clicking the "Stop" button.

Next: GDS-B Reference

No comments:

Post a Comment