Avaktavyam » Chinese http://lddubeau.com/avaktavyam Some things just can't be expressed... Sat, 23 Apr 2011 00:36:14 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 OOHanzi 0.7 released http://lddubeau.com/avaktavyam/2009/04/25/oohanzi-07-released http://lddubeau.com/avaktavyam/2009/04/25/oohanzi-07-released#comments Sat, 25 Apr 2009 11:35:21 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/?p=559 OOHanzi 0.7 has been released.

As usual please refer to the documentation to know how to use it.

I have not been able to work on getting OOHanzi to work on OS X so I presume it still does not work.

List of changes:

* Updated packaging dependencies for Ubuntu 9.04.

* Performance improvements in “Mark Words Present In…”.

* Added support for variant readings when using “Mark Words Present In…/DDB”.

]]> http://lddubeau.com/avaktavyam/2009/04/25/oohanzi-07-released/feed 0 OOHanzi 0.6 released http://lddubeau.com/avaktavyam/2008/11/28/oohanzi-06-released http://lddubeau.com/avaktavyam/2008/11/28/oohanzi-06-released#comments Fri, 28 Nov 2008 05:38:13 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/?p=333 Warning: OOHanzi 0.6 does not seem to be installable on Mac OS X. I have tried this week to install it on a Mac without success. I do not know whether previous versions would work or not.

OOHanzi 0.6 has been released.

Of all the releases of OOHanzi so far this is the one which has required the most work and which contains the most substantial changes. There are significant visible improvements but the bulk of the work happened under the hood and is invisible to regular users.

There is one major usability improvement: OOHanzi can now be installed by downloading and installing a single package instead of 5 packages. Please refer to the documentation to learn how to use this new method.

List of changes:

  • The user documentation is now stored in an OpenOffice document rather than in an XML document. This will allow for nicer, more friendly formatting of the documentation in the future.
  • OOHanzi now uses the officially recommended method to set preferences.
  • OOHanzi now checks whether strings passed for lookups are bigger than defined size and warns the user if it is the case.
  • OOHanzi now checks whether strings passed for lookups are Chinese and warns the user if the string does now look Chinese.
  • When performing a lookup, OOHanzi now sets the system clipboard to the selected text.
  • Major restructuring of the selection logic. This allowed the next two changes.
  • It now is possible to use OOHanzi in oobase.
  • OOHanzi would crash on any operation having to do with text in footnotes. This has been fixed.
  • Fixed a bug which caused “Mark Words Present In…”->”DDB” to fail to scan the last character of a selection.
]]> http://lddubeau.com/avaktavyam/2008/11/28/oohanzi-06-released/feed 0 OOHanzi and Open Office 3 http://lddubeau.com/avaktavyam/2008/10/12/oohanzi-and-open-office-3 http://lddubeau.com/avaktavyam/2008/10/12/oohanzi-and-open-office-3#comments Sun, 12 Oct 2008 06:29:43 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/?p=296 I’ve tested OOHanzi in Open Office 3 and have good news to report:

  1. OOHanzi will work with Open Office 3 without modification.
  2. There was a bug in Open Office 2.x which affected only people using compiz. If compiz was running, all dialog boxes which were created by the Java virtual machine running in Open Office would be displayed smaller than they should have been. This bug crippled OOHanzi pretty badly. After testing Open Office 3, I found the bug has been fixed.
]]> http://lddubeau.com/avaktavyam/2008/10/12/oohanzi-and-open-office-3/feed 0 OOHanzi 0.5 released http://lddubeau.com/avaktavyam/2008/06/28/oohanzi-05-released http://lddubeau.com/avaktavyam/2008/06/28/oohanzi-05-released#comments Sat, 28 Jun 2008 23:58:18 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/06/28/oohanzi-05-released/

Change Log

  • 20080628:

    • Updated for OOHanzi 0.5.
    • Added support for marking up words that are present in DDB.
    • OOHanzi is now fully installable in Ubuntu 8.04 (Hardy Heron).

  • 20080302:

    • Updated for OOHanzi 0.3: the only new functionality is the addition of an “About…” menu item.

  • 200802??:

    • Added some code to make things a bit more user friendly when a JRE is not properly installed.
    • Modified the way web browsers are launched.
    • Changed the nomenclature of menus and some functions.
    • General fixes to improve stability in Windows.

Status

This documentation deals with version 0.5 of OOHanzi. This software is very much at the Alpha stage of its life-cycle. Expect bugs. Expect nonsensical design decisions. Expect quirks.

Note: Version 0.4 was never officially released.

Imagine a paper even before it is at the draft stage, when it is still just a bunch of thoughts quickly put together. Or notes taken at a conference. At this stage, OOHanzi is very much the programmatic equivalent of that paper or those notes.

If you use OOHanzi and find it useful, please manifest yourself. If I do not hear from users I’m going to produce releases as I see fit and I’ll just cater ot my own needs.

Acknowledgments

My thanks go to Charles Muller for prompting me to release this and for testing and reporting bugs. I was planing to release it for a long time but never got around to it. When he asked to see what this was all about, I had to finally package it for other people.

Support

OOHanzi is hosted on Launchpad. Please use the Launchpad facilities to report bugs and ask questions.

You can keep informed of the latest development by subscribing to either of these RSS feeds:

All of the code is available on Launchpad. If you want to hack the code, either leave a comment on this blog or find my email address on Launchpad and contact me.

Prerequisites

This code has been tested with Open Office 2.4.1. I have used it with older versions of Open Office (2.0.x and higher, and specifically with 2.3.0) but the latest version of the code has not been tested on anything older than 2.1.1.

You need to be able to run Java code on your computer. The extensions have been tested with Java 6 or higher.

Linux: People running Ubuntu 7.4 or 7.10 must install either sun-java6-jre or icedtea-java7-jre. (The latter seems preferable.) People running Ubuntu 8.04 should install openjdk-6-jre. Other distributions probably have equivalent packages that can be installed.

NOTE FOR PEOPLE UPGRADING TO HARDY: It seems that IcedTea does not exist for Hardy. Unfortunately, if you have used OOHanzi in Gutsy with IcedTea as the JVM, OpenOffice recorded the JVM to be IcedTea. Once you move to Hardy, you have a problem because that JVM no longer exists. In order to get OpenOffice to forget which JVM you used, you need to execute the following in a shell:

$ rm ~/.openoffice.org2/user/config/javasettings_Linux_x86.xml

If you do not do this, the installation will fail.

Windows:There are many options for Windows. It is possible to download Open Office together with a Java 6 from the Open Office web site. This is the option I used when I installed OO in Windows for testing OOHanzi. I know nothing about the other options.

People running other systems should refer to their system’s documentation.

Automatic Installation

If you use Ubuntu, you can add my PPA archive to your apt sources. Look at the main page of my PPA archive for the specific lines you must add. Then you can issue “apt-get install oohanzi”. Whenever installing or removing extensions it is better to close all of Open Office. The packages will install if Open Office is running and you will get a warning about that but the new extensions won’t be usable unless you restart Open Office.

If you used the manual installation first and want to switch to the automatic system, you should first remove everything you’ve installed manually.

Eventually there will be an automatic installation system for Windows but it may take a while before that is developed.

Manual Installation

  1. If you use the Open Office Quickstarter, please pay attention to the following. If you don’t know what the Quickstarter is, please read page 6 of this document. Note that the OO Quickstarter is installed by default in Windows. Here is the important part: if you use the Quickstarter, then whenever the instructions tell you to restart Open Office, you must also go into the Quickstarter and select “Exit Quickstarter”. If you do not exit the Quickstarter, Open Office will not be unloaded from memory and thus will not restart when you open it again. It will just work from what is already loaded.

  2. You need to get three items:

    • http://lddubeau.com/downloads/java/unihan-lib-[version].jar
    • http://lddubeau.com/downloads/java/webdict-lib-[version].jar
    • http://lddubeau.com/downloads/openoffice/extensions/oounihan-[version].oxt
    • http://lddubeau.com/downloads/openoffice/extensions/oowebdict-[version].oxt
    • http://lddubeau.com/downloads/openoffice/extensions/oohanzi-[version].oxt

    The string “[version]” stands for the version number of the respective packages. Always use the latest version numbers. It is normal if all files do not have the same version number. Here are links to the directories containing the files above:

  3. Make sure that your Open Office setup is set to find the Java JRE. Go in “Tools->Options”. Get to the “Java” tab (located under “Open Office.org” in the hierarchy on the left). Once you open that tab, it will take a little bit of time but Open Office will search your disk for JREs already installed. After it has found them, it will populate the table labeled “Java runtime environments (JRE) already installed:”. Select the one you want to use (usually you want the latest version), and click “Ok”.

    On Ubuntu systems, Open Office is able to find all properly packaged JREs. (That is, all JREs provided by the Ubuntu repositories.)

    If Open Office is unable to find your JRE, then you need to click “Add…”, find where your JRE is located and add it to the list. Because I run Ubuntu, I’ve never had to do this so I do not know the ins and outs of adding a JRE manually.

    After you select your JRE, you will most likely have to restart Open Office. You will get a dialog that will tell you to do so. If you use the Quickstarter, please also exit the Quickstarter. [NOTE: you can wait until you preform step 4 to restart Open Office.]

  4. You must make unihan-lib-[version].jar and webdict-lib-[version].jar available to the Java JRE. Whichever method you use is fine so if you already have your own method to make 3rd party jars available, use your method. Otherwise, do the following.

    Go back into the same Java configuration tab as you did in step 3. This time around you need to click “Class Path…” and then “Add Archive…”. Find the unihan-lib-[version].jar that you saved in step 2 and click “Open”. Do the same thing for webdict-lib-[version].jar

    Restart Open Office so that the library will be loaded next time the JRE is run. If you use the Quickstarter, remember to exit the Quickstarter too.

  5. Start Open Office. Go in “Tools->Extension Manager…”.

  6. Click on “Add…”, find oounihan-[version].oxt and click “Open”. Click on “Add…” again, find oowebdict-[version].oxt and click “Open”. Click on “Add…” again, find oohanzi-[version].oxt and click “Open”.

  7. You’re done! You should now have menu item called “OOHanzi” in your menubar. If you do not get that menu item, then something went wrong. Contact me.

[IMPORTANT NOTE:When you use OOHanzi, if you immediately get some horrible message that says that it cannot load a Java class, it means that your java environment is not working properly.]

Automatic Upgrading

If you use my PPA repository then you can use use apt-upgrade to upgrade to the latest version.

Manual Upgrading

When you get a newer version of an oxt file you can just double click on it and Open Office will install it over the old version. However, I have noticed that Open Office does not register menu changes until I restart it. This seems to be a quirk in how Open Office operates.

Upgrading to a new jar requires that you uninstall the older jar and install the new one. Go to the menu item “Tools->Options”. Go to the Java tab. Click “Class Path…”, remove the old archive and add the new one.

Usage

After installation, you have a new menu called “OOHanzi”.

[KNOWN BUG:None of the items in the menu "OOHanzi" are ever grayed out, even when they should not be usable. For instance "Clear Pronunciation" should ideally be grayed out when no text is selected. If no text is selected, there is no point using "Clear Pronunciation" since it works on the current selection. Several other items in "OOHanzi" are the same. Unfortunately, the documentation for writing extensions for OO is terrible. Most of it is in a half-baked state or out of date or does not cover everything needed. There is probably a way to ensure that menu items are active only when they should be active but I do not know how to do this.]

The functions under it are:

Display Unihan Information

This searches the Unihan database for the currently selected character and displays a window with the data found in Unihan. See the Unihan documentation for meaning of each field.

Mark Words Present In…

This menu provides functionality to mark all words in text selected by the user. The typical use would be to first select a passage from the text being edited. Then select one item under this menu. OOHanzi will then scan the selected passage and mark each word it finds in the database that the user has selected. For instance, if the user select “Mark Words Present In…/DDB”, OOHanzi will mark all the words that are present in the DDB.

There are several things to keep in mind when using this function:

  1. The algorithm will try to find the longest possible terms from the start to the end of the selection.
  2. The algorithm uses a two color scheme: blue and red, and alternates between them.
  3. The algorithm is stupid. It does not know which terms would provide a better payoff for the user. For instance, if characters ABCD appear together and AB and BCD both exist in the database. The algorithm will mark AB as one term and will not mark BCD. If CD also exists, it will mark CD. So basically, it does not handle overlapping hits very well. It is a general problem when performing this kind of function and requires a) careful design and b) a proper interface for showing overlapping hits.

Lookup

This menu contains menu items to perform searches in dictionaries hosted at various web sites. The selected text is looked up at the web site which corresponds to the menu item selected.

DDB is Charles Muller’s Digital Dictionary of Buddhism.

CJKV is Charles Muller’s Chinese Japanese Korean Vietnamese Dictionary.

Etymology is YellowBridge’s Etymology Dictionary.

Fill Rubies Using Unihan

This adds pronunciation to the selected text. The pronunciation is taken from the Unihan database and added as “rubies” to each character of the selected text. See this page if you don’t know the term “ruby” in this context.

The algorithm actually works in 2 steps:

  1. For a given character on which the user wants to add the pronunciation, it first tries to find the same character in the current document. If that character already has its pronunciation in its ruby, then that pronunciation is copied to the current character.
  2. If the search in step 1 fails, then Unihan is used to get the pronunciation. The pronunciation extracted from Unihan is Mandarin.

[FOR FUTURE DEVELOPMENT: Configure OOHanzi to be able to get various pronunciations out of Unihan rather than just Mandarin.]

Fill Rubies Using Documents

This adds pronunciation to the selected text. The pronunciation is taken from any *currently opened Text* document (i.e. Open Office Writer documents). This is like step 1 in “Fix Pronunciation Using Unihan” but the search is made across all currently opened Text documents. If the search fail, Unihan is *not* consulted.

Adjust Rubies

The problem with doing Unihan lookups is that Unihan records all regular pronunciations of a character. I vaguely remember doing a computation showing that there are at most 5 pronunciations for a given character (in Mandarin). So under this item, you find 5 menu items that are used to select which pronunciation to keep. Usage scenario:

  1. 1. You select some text.

  2. 2. You use “Fix Pronunciation Using Unihan”.

    After that is done, the first character has 5 pronunciations in its ruby. You cant to fix it.

  3. You select that character.

  4. You execute “OOHanzi->Adjust Pronunciation->Keep 3rd”.

  5. Now that character only has the 3rd of the 5 pronunciations.

Note that it is always possible to arbitrarily edit the ruby of any character by going in “Format->Asian phonetic guide…”.

Clear Rubies

This removes all the rubies from the selected text.

Preferences

This menu item brings up a dialog that allows the user to specify how “Display Unihan Information” presents information extracted from the Unihan database. It is a good idea to filter that information because Unihan contains a lot of data and some of that data is useful only to some users.

At the top of the dialog there is a checkbox labeled “Filter returned Unihan fields”. If it is unchecked, then OOHanzi does not filter the data provided by Unihan. If it is checked, OOHanzi will include only the fields listed in the “Included fields” list which appears just under the checkbox.

All fields which appear in the “Included fields” list will be displayed by “Display Unihan Information”. All fields which appear in the “Excluded fields” list will not be displayed. Use the two buttons between the two lists to move items from one list to the other.

About…

This item brings up a dialog which tells you which versions of OOHanzi, OOUnihan and the Java Unihan library are in use. This is useful if you want to check what you are running or if you want to produce a bug report.

Known Bugs

As of June 26th, 2008 the “Mark Words Present In…” function does not work in Windows. I suspect the problem is with the default encoding in which the Java JRE opens HTTP streams in Windows but I have not had time to investigate.

Other Issues

In Ubuntu, when running Open Office 2.3.0 or later with compiz the dialog windows are sometimes not sized properly. This is not a bug with OOHanzi. I have reported the bug. This issue does not occur if compiz is turned off. Moreover, this issue does not happen in Windows.

Hacking

Eventually the entire code for everything will be made available on the web. Right now however, only the OOBasic portions are available. To get to them, go into “Tools->Macros->Organize Macros->OpenOffice.org Basic…”. All the OOBasic code for OOHanzi will appear in the hierarchy under “My Macros/OOHanzi”.

]]> http://lddubeau.com/avaktavyam/2008/06/28/oohanzi-05-released/feed 4 Summer weirdness http://lddubeau.com/avaktavyam/2008/06/11/summer-weirdness http://lddubeau.com/avaktavyam/2008/06/11/summer-weirdness#comments Thu, 12 Jun 2008 00:26:04 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/06/11/summer-weirdness/ Well, the Mandarin intensive at UVA started yesterday. Small class (6 students). That’s good. For me though, the setting is a little weird.

This is my third summer language intensive. I took my second year of Hindi in an intensive summer program at Madison, WI. I took my 4th year of Sanskrit in an intensive summer program in Pune, India. Now I’m taking my first year of Mandarin in an intensive summer program at UVA. For the first two programs, I had to temporarily live away. In Madison, I shared a room with a student from Korea (who was studying something else than Hindi… I don’t remember what). In Pune I shared a flat with an American student who was also in the Sanskrit program. But UVA is where I’m doing my Ph.D. So for the length of the program, I’m just using the same old efficiency I was using during the past academic year. My lodging is the same. The university is the same. In the other programs, I was away from my wife for the whole duration of the program but during this program the isolation will be broken by weekend visits. Somehow, without having to live in a different city, it does not feel like a summer intensive. It’s not like I’m not doing all the work. I’m practicing my pinyin and my Chinese characters to death. There’s just some other intangible element missing.

Then there’s something more tangible missing: my friend Llerena. We took our first year of Hindi together and then went into the summer program together. After that, life took us into different directions. One day during the Hindi intensive, our entire class was walking together. I don’t quite remember what we were doing but what I remember however was that I was mumbling to Llerena that our path was not optimized. Of course, I meant optimized for speed towards our final destination. Instead of taking a direct but more boring route, we took the scenic route which meandered by the lake shore. Llerena just laughed at me and asked, grosso modo: What about how pleasant the walk is? Doesn’t that count? She insightfully pointed out how my obsession with optimizing for speed was flawed: optimizing for speed would have meant sacrificing other, more pleasant, aspects of our walk.

I should drop her a line…

]]> http://lddubeau.com/avaktavyam/2008/06/11/summer-weirdness/feed 0 OOHanzi on Ubuntu 8.04 (Hardy Heron) http://lddubeau.com/avaktavyam/2008/04/17/oohanzi-on-ubuntu-804-hardy-heron http://lddubeau.com/avaktavyam/2008/04/17/oohanzi-on-ubuntu-804-hardy-heron#comments Thu, 17 Apr 2008 13:40:28 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/04/17/oohanzi-on-ubuntu-804-hardy-heron/ I’ve started using Hardy Heron in its beta incarnation. Right now, it is not possible to use my repository to install OOHanzi on Hardy. The interface to install Open Office extensions has changed very slightly but that causes installation of my extensions to fail. A few notes:

  1. If you upgrade to Hardy form Gutsy, all the OOHanzi packages will be uninstalled.
  2. The packaging system will not prevent you from reinstalling OOHanzi on Hardy after you upgrade from Gutsy but the installation will get stuck. So do not install OOHanzi on Hardy by using the automatic method yet.
  3. It is possible to do a manual installation as documented here.
  4. It is possible to do a semi-manual installation by installing java-unihan-oosupport from the repository and then installing the oounihan and oohanzi extensions manually. The actual steps to perform this are left as an exercise for the reader.

I’m planning to fix this problem before Hardy goes gold but I have a lot of other things to do so I may delay the release for later. If you use OOHanzi and are just burning to move to Hardy, please leave a comment. It will incite me to do this faster.

]]> http://lddubeau.com/avaktavyam/2008/04/17/oohanzi-on-ubuntu-804-hardy-heron/feed 0 OOHanzi 0.3 released http://lddubeau.com/avaktavyam/2008/03/02/oohanzi-03-released http://lddubeau.com/avaktavyam/2008/03/02/oohanzi-03-released#comments Sun, 02 Mar 2008 19:11:29 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/03/02/oohanzi-03-released/

Change Log

  • 20080302:

    • Updated for OOHanzi 0.3: the only new functionality is the addition of an “About…” menu item.

  • 200802??:

    • Added some code to make things a bit more user friendly when a JRE is not properly installed.
    • Modified the way web browsers are launched.
    • Changed the nomenclature of menus and some functions.
    • General fixes to improve stability in Windows.

Status

This documentation deals with version 0.3 of OOHanzi. This software is very much at the Alpha stage of its life-cycle. Expect bugs. Expect nonsensical design decisions. Expect quirks.

Imagine a paper even before it is at the draft stage, when it is still just a bunch of thoughts quickly put together. Or notes taken at a conference. At this stage, OOHanzi is very much the programmatic equivalent of that paper or those notes.

Acknowledgments

My thanks go to Charles Muller for prompting me to release this and for testing and reporting bugs. I was planing to release it for a long time but never got around to it. When he asked to see what this was all about, I had to finally package it for other people.

Support

OOHanzi is hosted on Launchpad. Please use the Launchpad facilities to report bugs and ask questions.

You can keep informed of the latest development by subscribing to either of these RSS feeds:

All of the code is available on Launchpad. If you want to hack the code, either leave a comment on this blog or find my email address on Launchpad and contact me.

Prerequisites

This code has been tested with Open Office 2.3.0. I have used it with older versions of Open Office (2.0.x and higher) but the latest version of the code has not been tested on anything older than 2.3.0.

You need to be able to run Java code on your computer. The extensions have been tested with Java 6 or higher.

Linux: People running Ubuntu 7.4 or 7.10 must install either sun-java6-jre or icedtea-java7-jre. (The latter seems preferable.) Other distributions probably have equivalent packages that can be installed.

Windows:There are many options for Windows. It is possible to download Open Office together with a Java 6 from the Open Office web site. This is the option I used when I installed OO in Windows for testing OOHanzi. I know nothing about the other options.

People running other systems should refer to their system’s documentation.

Automatic Installation

If you use Ubuntu, you can add my PPA archive to your apt sources. Look at the main page of my PPA archive for the specific lines you must add. Then you can issue “apt-get install oohanzi”. Whenever installing or removing extensions it is better to close all of Open Office. The packages will install if Open Office is running and you will get a warning about that but the new extensions won’t be usable unless you restart Open Office.

If you used the manual installation first and want to switch to the automatic system, you should first remove everything you’ve installed manually.

Eventually there will be an automatic installation system for Windows but it may take a while before that is developed.

Manual Installation

  1. If you use the Open Office Quickstarter, please pay attention to the following. If you don’t know what the Quickstarter is, please read page 6 of this document. Note that the OO Quickstarter is installed by default in Windows. Here is the important part: if you use the Quickstarter, then whenever the instructions tell you to restart Open Office, you must also go into the Quickstarter and select “Exit Quickstarter”. If you do not exit the Quickstarter, Open Office will not be unloaded from memory and thus will not restart when you open it again. It will just work from what is already loaded.

  2. You need to get three items:

    • http://lddubeau.com/downloads/java/unihan-lib-[version].jar
    • http://lddubeau.com/downloads/openoffice/extensions/oounihan-[version].oxt
    • http://lddubeau.com/downloads/openoffice/extensions/oohanzi-[version].oxt

    The string “[version]” stands for the version number of the respective packages. Always use the latest version numbers. It is normal if all three files do not have the same version number. Here are links to the directories containing the files above:

  3. Make sure that your Open Office setup is set to find the Java JRE. Go in “Tools->Options”. Get to the “Java” tab (located under “Open Office.org” in the hierarchy on the left). Once you open that tab, it will take a little bit of time but Open Office will search your disk for JREs already installed. After it has found them, it will populate the table labeled “Java runtime environments (JRE) already installed:”. Select the one you want to use (usually you want the latest version), and click “Ok”.

    On Ubuntu systems, Open Office is able to find all properly packaged JREs. (That is, all JREs provided by the Ubuntu repositories.)

    If Open Office is unable to find your JRE, then you need to click “Add…”, find where your JRE is located and add it to the list. Because I run Ubuntu, I’ve never had to do this so I do not know the ins and outs of adding a JRE manually.

    After you select your JRE, you will most likely have to restart Open Office. You will get a dialog that will tell you to do so. If you use the Quickstarter, please also exit the Quickstarter. [NOTE: you can wait until you preform step 4 to restart Open Office.]

  4. You must make unihan-lib-[version].jar available to the Java JRE. Whichever method you use is fine so if you already have your own method to make 3rd party jars available, use your method. Otherwise, do the following.

    Go back into the same Java configuration tab as you did in step 3. This time around you need to click “Class Path…” and then “Add Archive…”. Find the unihan-lib-[version].jar that you saved in step 2 and click “Open”.

    Restart Open Office so that the library will be loaded next time the JRE is run. If you use the Quickstarter, remember to exit the Quickstarter too.

  5. Start Open Office. Go in “Tools->Extension Manager…”.

  6. Click on “Add…”, find oounihan-[version].oxt and click “Open”. Click on “Add…” again, find oohanzi-[version].oxt and click “Open”.

  7. You’re done! You should now have menu item called “OOHanzi” in your menubar. If you do not get that menu item, then something went wrong. Contact me.

[IMPORTANT NOTE:When you use OOHanzi, if you immediately get some horrible message that says that it cannot load a Java class, it means that your java environment is not working properly.]

Automatic Upgrading

If you use my PPA repository then you can use use apt-upgrade to upgrade to the latest version.

Manual Upgrading

When you get a newer version of an oxt file you can just double click on it and Open Office will install it over the old version. However, I have noticed that Open Office does not register menu changes until I restart it. This seems to be a quirk in how Open Office operates.

Upgrading to a new jar requires that you uninstall the older jar and install the new one. Go to the menu item “Tools->Options”. Go to the Java tab. Click “Class Path…”, remove the old archive and add the new one.

Usage

After installation, you have a new menu called “OOHanzi”.

[KNOWN BUG:None of the items in the menu "OOHanzi" are ever grayed out, even when they should not be usable. For instance "Clear Pronunciation" should ideally be grayed out when no text is selected. If no text is selected, there is no point using "Clear Pronunciation" since it works on the current selection. Several other items in "OOHanzi" are the same. Unfortunately, the documentation for writing extensions for OO is terrible. Most of it is in a half-baked state or out of date or does not cover everything needed. There is probably a way to ensure that menu items are active only when they should be active but I do not know how to do this.]

The functions under it are:

Display Unihan Information

This searches the Unihan database for the currently selected character and displays a window with the data found in Unihan. See the Unihan documentation for meaning of each field.

Lookup

This menu contains menu items to perform searches in dictionaries hosted at various web sites. The selected text is looked up at the web site which corresponds to the menu item selected.

DDB is Charles Muller’s Digital Dictionary of Buddhism.

CJKV is Charles Muller’s Chinese Japanese Korean Vietnamese Dictionary.

Etymology is YellowBridge’s Etymology Dictionary.

Fill Rubies Using Unihan

This adds pronunciation to the selected text. The pronunciation is taken from the Unihan database and added as “rubies” to each character of the selected text. See this page if you don’t know the term “ruby” in this context.

The algorithm actually works in 2 steps:

  1. For a given character on which the user wants to add the pronunciation, it first tries to find the same character in the current document. If that character already has its pronunciation in its ruby, then that pronunciation is copied to the current character.
  2. If the search in step 1 fails, then Unihan is used to get the pronunciation. The pronunciation extracted from Unihan is Mandarin.

[FOR FUTURE DEVELOPMENT: Configure OOHanzi to be able to get various pronunciations out of Unihan rather than just Mandarin.]

Fill Rubies Using Documents

This adds pronunciation to the selected text. The pronunciation is taken from any *currently opened Text* document (i.e. Open Office Writer documents). This is like step 1 in “Fix Pronunciation Using Unihan” but the search is made across all currently opened Text documents. If the search fail, Unihan is *not* consulted.

Adjust Rubies

The problem with doing Unihan lookups is that Unihan records all regular pronunciations of a character. I vaguely remember doing a computation showing that there are at most 5 pronunciations for a given character (in Mandarin). So under this item, you find 5 menu items that are used to select which pronunciation to keep. Usage scenario:

  1. 1. You select some text.

  2. 2. You use “Fix Pronunciation Using Unihan”.

    After that is done, the first character has 5 pronunciations in its ruby. You cant to fix it.

  3. You select that character.

  4. You execute “OOHanzi->Adjust Pronunciation->Keep 3rd”.

  5. Now that character only has the 3rd of the 5 pronunciations.

Note that it is always possible to arbitrarily edit the ruby of any character by going in “Format->Asian phonetic guide…”.

Clear Rubies

This removes all the rubies from the selected text.

Preferences

This menu item brings up a dialog that allows the user to specify how “Display Unihan Information” presents information extracted from the Unihan database. It is a good idea to filter that information because Unihan contains a lot of data and some of that data is useful only to some users.

At the top of the dialog there is a checkbox labeled “Filter returned Unihan fields”. If it is unchecked, then OOHanzi does not filter the data provided by Unihan. If it is checked, OOHanzi will include only the fields listed in the “Included fields” list which appears just under the checkbox.

All fields which appear in the “Included fields” list will be displayed by “Display Unihan Information”. All fields which appear in the “Excluded fields” list will not be displayed. Use the two buttons between the two lists to move items from one list to the other.

About…

This item brings up a dialog which tells you which versions of OOHanzi, OOUnihan and the Java Unihan library are in use. This is useful if you want to check what you are running or if you want to produce a bug report.

Other known bugs

In Ubuntu, when running Open Office 2.3.0 the dialog windows are sometimes not sized properly. This is a random bug which I have been able to reproduce with extensions produced by other people so I know it is not a bug in OOHanzi. I’ve also been able to reproduce it with new “virgin” installations of Open Office so I know it is not a bug in my configuration. My best guess it is that this is a bug in Open Office itself. I have reported the bug. As far as I know, this bug does not happen in Windows.

Hacking

Eventually the entire code for everything will be made available on the web. Right now however, only the OOBasic portions are available. To get to them, go into “Tools->Macros->Organize Macros->OpenOffice.org Basic…”. All the OOBasic code for OOHanzi will appear in the hierarchy under “My Macros/OOHanzi”.

Version of the documentation: $Id$

]]> http://lddubeau.com/avaktavyam/2008/03/02/oohanzi-03-released/feed 0 The pain of writing OO extensions http://lddubeau.com/avaktavyam/2008/03/02/the-pain-of-writing-oo-extensions http://lddubeau.com/avaktavyam/2008/03/02/the-pain-of-writing-oo-extensions#comments Sun, 02 Mar 2008 15:46:33 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/03/02/the-pain-of-writing-oo-extensions/ I’ve been working on some Chinese extensions for OO but at every step of the way I have to fight with obscure documentation and really strange design decisions. Here’s the latest example. Want to display an image in a dialog? We’re not talking about anything fancy here but just one single image which remains static. There’s nothing dynamic about this. So can you just put in the relative path in the dlg:src parameter which indicates where the image lives (e.g. dlg:src=”../image.jpg”)? No way! That would be way too simple and would violate the spirit of OO which is “why make things simple when you can make them complicated”. Instead you have to create two additional XML files to tell Open Office where to find the image in your extension and then at run time you have to query Open Office to find where the image really lives and load it into your dialog. Yay! The reason for this is that you do not know ahead of time where your extension is going to reside on disk. You’d think a relative path would be rock solid because it is relative to where your extension is located, but no: that does not work. You have to file extra paperwork with Open Office to declare the existence of the images.

(I searched through the dialog files bundled with Open Office to see if I could find something useful in there but what I found were paths like “file://D:/…”. Ooops, I guess even the Open Office developers are having a hard time keeping their paths portable.)

And this is just the latest in a loooooooooooooooooooong series of grievances. Here’s a new motto: “you don’t know the meaning of bondage-and-discipline programing until you’ve tried to write extensions for Open Office.” Open Office is like a bureaucrat: you can’t do anything without filing multiple forms to announce what you want to do and justify it.

References: here, here and here.

]]> http://lddubeau.com/avaktavyam/2008/03/02/the-pain-of-writing-oo-extensions/feed 0 OOHanzi now packaged for Ubuntu http://lddubeau.com/avaktavyam/2008/02/25/oohanzi-now-packaged-for-ubuntu http://lddubeau.com/avaktavyam/2008/02/25/oohanzi-now-packaged-for-ubuntu#comments Mon, 25 Feb 2008 12:39:47 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/02/25/oohanzi-now-packaged-for-ubuntu/ I’ve packaged all of OOHanzi for Ubuntu. I’m using Launchpad to host them. Follow the link for information about the sources that must be added to your /etc/apt/sources.list to use my repository. It is also possible to just use the web interface to download all 3 packages individually and install them one by one. If you add the repository to your configuration, just installing oohanzi (e.g. apt-get install oohanzi) should pull everything needed. If you install individually you need to install, in order:

  • java-unihan-lib
  • oounihan
  • oohanzi

Or you can issue a single dpkg -i command with all 3 listed. If the installation system complains that it cannot complete the installation, issue “apt-get -f install” after the installation.

People who have already downloaded the files individually and who would like to switch to the Ubuntu packages should first uninstall the old OOHanzi extensions and the unihan java library.

People who want to keep abreast of developments can subscribe to an RSS feed that contains only OOHanzi announcements.

Note for people who want to edit OOHanzi’s OOBasic code in OpenOffice’s IDE: If you use the Ubuntu packages, there is no way to edit the OOBasic code. If you want to install the extension so that you can modify the code as needed, you can install the java-unihan-lib and oounihan Ubuntu packages but you must install the .oxt for oohanzi manually as described in the previous release notes.

]]> http://lddubeau.com/avaktavyam/2008/02/25/oohanzi-now-packaged-for-ubuntu/feed 0 OOHanzi 0.2 released http://lddubeau.com/avaktavyam/2008/02/07/oohanzi-02-released http://lddubeau.com/avaktavyam/2008/02/07/oohanzi-02-released#comments Thu, 07 Feb 2008 15:04:00 +0000 Louis-Dominique http://lddubeau.com/avaktavyam/2008/02/07/oohanzi-02-released/

Change Log

  • Added some code to make things a bit more user friendly when a JRE is not properly installed.
  • Modified the way web browsers are launched.
  • Changed the nomenclature of menus and some functions.
  • General fixes to improve stability in Windows.

Status

This documentation deals with version 0.2 of OOHanzi. This software is very much at the Alpha stage of its life-cycle. Expect bugs. Expect nonsensical design decisions. Expect quirks.

Imagine a paper even before it is at the draft stage, when it is still just a bunch of thoughts quickly put together. Or notes taken at a conference. At this stage, OOHanzi is very much the programmatic equivalent of that paper or those notes.

Acknowledgments

My thanks go to Charles Muller for prompting me to release this and for testing and reporting bugs. I was planing to release it for a long time but never got around to it. When he asked to see what this was all about, I had to finally package it for other people.

Support

OOHanzi is hosted on Launchpad. Please use the Launchpad facilities to report bugs and ask questions.

I will soon put the entirety of the code base on Launchapd.

Prerequisites

This code has been tested with Open Office 2.3.0. I have used it with older versions of Open Office (2.0.x and higher) but the latest version of the code has not been tested on anything older than 2.3.0.

You need to be able to run Java code on your computer. The extensions have been tested with Java 6 or higher.

Linux: People running Ubuntu 7.4 or 7.10 must install either sun-java6-jre or icedtea-java7-jre. (The latter seems preferable.) Other distributions probably have equivalent packages that can be installed.

Windows:There are many options for Windows. It is possible to download Open Office together with a Java 6 from the Open Office web site. This is the option I used when I installed OO in Windows for testing OOHanzi. I know nothing about the other options.

People running other systems should refer to their system’s documentation.

Installation

  1. If you use the Open Office Quickstarter, please pay attention to the following. If you don’t know what the Quickstarter is, please read page 6 of this document. Note that the OO Quickstarter is installed by default in Windows. Here is the important part: if you use the Quickstarter, then whenever the instructions tell you to restart Open Office, you must also go into the Quickstarter and select “Exit Quickstarter”. If you do not exit the Quickstarter, Open Office will not be unloaded from memory and thus will not restart when you open it again. It will just work from what is already loaded.

  2. You need to get three items:

    • http://lddubeau.com/downloads/java/unihan-lib-[version].jar
    • http://lddubeau.com/downloads/openoffice/extensions/oounihan-[version].oxt
    • http://lddubeau.com/downloads/openoffice/extensions/oohanzi-[version].oxt

    The string “[version]” stands for the version number of the respective packages. Always use the latest version numbers. It is normal if all three files do not have the same version number. Here are links to the directories containing the files above:

  3. Make sure that your Open Office setup is set to find the Java JRE. Go in “Tools->Options”. Get to the “Java” tab (located under “Open Office.org” in the hierarchy on the left). Once you open that tab, it will take a little bit of time but Open Office will search your disk for JREs already installed. After it has found them, it will populate the table labeled “Java runtime environments (JRE) already installed:”. Select the one you want to use (usually you want the latest version), and click “Ok”.

    On Ubuntu systems, Open Office is able to find all properly packaged JREs. (That is, all JREs provided by the Ubuntu repositories.)

    If Open Office is unable to find your JRE, then you need to click “Add…”, find where your JRE is located and add it to the list. Because I run Ubuntu, I’ve never had to do this so I do not know the ins and outs of adding a JRE manually.

    After you select your JRE, you will most likely have to restart Open Office. You will get a dialog that will tell you to do so. If you use the Quickstarter, please also exit the Quickstarter. [NOTE: you can wait until you preform step 4 to restart Open Office.]

  4. You must make unihan-lib-[version].jar available to the Java JRE. Whichever method you use is fine so if you already have your own method to make 3rd party jars available, use your method. Otherwise, do the following.

    Go back into the same Java configuration tab as you did in step 3. This time around you need to click “Class Path…” and then “Add Archive…”. Find the unihan-lib-[version].jar that you saved in step 2 and click “Open”.

    Restart Open Office so that the library will be loaded next time the JRE is run. If you use the Quickstarter, remember to exit the Quickstarter too.

  5. Start Open Office. Go in “Tools->Extension Manager…”.

  6. Click on “Add…”, find oounihan-[version].oxt and click “Open”. Click on “Add…” again, find oohanzi-[version].oxt and click “Open”.

  7. You’re done! You should now have menu item called “OOHanzi” in your menubar. If you do not get that menu item, then something went wrong. Contact me.

[IMPORTANT NOTE:When you use OOHanzi, if you immediately get some horrible message that says that it cannot load a Java class, it means that your java environment is not working properly.]

Upgrading

When you get a newer version of an oxt file you can just double click on it and Open Office will install it over the old version. However, I have noticed that Open Office does not register menu changes until I restart it. This seems to be a quirk in how Open Office operates.

Upgrading to a new jar requires that you uninstall the older jar and install the new one. Go to the menu item “Tools->Options”. Go to the Java tab. Click “Class Path…”, remove the old archive and add the new one.

Usage

After installation, you have a new menu called “OOHanzi”.

[KNOWN BUG:None of the items in the menu "OOHanzi" are ever grayed out, even when they should not be usable. For instance "Clear Pronunciation" should ideally be grayed out when no text is selected. If no text is selected, there is no point using "Clear Pronunciation" since it works on the current selection. Several other items in "OOHanzi" are the same. Unfortunately, the documentation for writing extensions for OO is terrible. Most of it is in a half-baked state or out of date or does not cover everything needed. There is probably a way to ensure that menu items are active only when they should be active but I do not know how to do this.]

The functions under it are:

Display Unihan Information

This searches the Unihan database for the currently selected character and displays a window with the data found in Unihan. See the Unihan documentation for meaning of each field.

Lookup

This menu contains menu items to perform searches in dictionaries hosted at various web sites. The selected text is looked up at the web site which corresponds to the menu item selected.

DDB is Charles Muller’s Digital Dictionary of Buddhism.

CJKV is Charles Muller’s Chinese Japanese Korean Vietnamese Dictionary.

Etymology is YellowBridge’s Etymology Dictionary.

Fill Rubies Using Unihan

This adds pronunciation to the selected text. The pronunciation is taken from the Unihan database and added as “rubies” to each character of the selected text. See this page if you don’t know the term “ruby” in this context.

The algorithm actually works in 2 steps:

  1. For a given character on which the user wants to add the pronunciation, it first tries to find the same character in the current document. If that character already has its pronunciation in its ruby, then that pronunciation is copied to the current character.
  2. If the search in step 1 fails, then Unihan is used to get the pronunciation. The pronunciation extracted from Unihan is Mandarin.

[FOR FUTURE DEVELOPMENT: Configure OOHanzi to be able to get various pronunciations out of Unihan rather than just Mandarin.]

Fill Rubies Using Documents

This adds pronunciation to the selected text. The pronunciation is taken from any *currently opened Text* document (i.e. Open Office Writer documents). This is like step 1 in “Fix Pronunciation Using Unihan” but the search is made across all currently opened Text documents. If the search fail, Unihan is *not* consulted.

Adjust Rubies

The problem with doing Unihan lookups is that Unihan records all regular pronunciations of a character. I vaguely remember doing a computation showing that there are at most 5 pronunciations for a given character (in Mandarin). So under this item, you find 5 menu items that are used to select which pronunciation to keep. Usage scenario:

  1. 1. You select some text.

  2. 2. You use “Fix Pronunciation Using Unihan”.

    After that is done, the first character has 5 pronunciations in its ruby. You cant to fix it.

  3. You select that character.

  4. You execute “OOHanzi->Adjust Pronunciation->Keep 3rd”.

  5. Now that character only has the 3rd of the 5 pronunciations.

Note that it is always possible to arbitrarily edit the ruby of any character by going in “Format->Asian phonetic guide…”.

Clear Rubies

This removes all the rubies from the selected text.

Preferences

This menu item brings up a dialog that allows the user to specify how “Display Unihan Information” presents information extracted from the Unihan database. It is a good idea to filter that information because Unihan contains a lot of data and some of that data is useful only to some users.

At the top of the dialog there is a checkbox labeled “Filter returned Unihan fields”. If it is unchecked, then OOHanzi does not filter the data provided by Unihan. If it is checked, OOHanzi will include only the fields listed in the “Included fields” list which appears just under the checkbox.

All fields which appear in the “Included fields” list will be displayed by “Display Unihan Information”. All fields which appear in the “Excluded fields” list will not be displayed. Use the two buttons between the two lists to move items from one list to the other.

Other known bugs

In Ubuntu, when running Open Office 2.3.0 the dialog windows are sometimes not sized properly. This is a random bug which I have been able to reproduce with extensions produced by other people so I know it is not a bug in OOHanzi. I’ve also been able to reproduce it with new “virgin” installations of Open Office so I know it is not a bug in my configuration. My best guess it is that this is a bug in Open Office itself. I have reported the bug. As far as I know, this bug does not happen in Windows.

Hacking

Eventually the entire code for everything will be made available on the web. Right now however, only the OOBasic portions are available. To get to them, go into “Tools->Macros->Organize Macros->OpenOffice.org Basic…”. All the OOBasic code for OOHanzi will appear in the hierarchy under “My Macros/OOHanzi”.

Version of the documentation: $Id: oohanzi-doc.xml 256 2008-02-07 19:36:31Z ldd $

]]> http://lddubeau.com/avaktavyam/2008/02/07/oohanzi-02-released/feed 0