The Boston Diaries

The ongoing saga of a programmer who doesn't live in Boston, nor does he even like Boston, but yet named his weblog/journal “The Boston Diaries.”

Go figure.

Thursday, October 23, 2003

Localization through Internationalization (or l10n via i18n)

I just now cleaned up the last bit of code that required me to maintain multiple copies of mod_blog, depending upon the user. The problem revolved around the month of December and how I feel about it.

Last year around this time I added the following to mod_blog:

if (day.tm_mon == 11)
{
  char dayname[BUFSIZ];

  strftime(dayname,BUFSIZ,"%A",&day);
  fprintf(
           fpout,
           "%s, Debtember %02d, %d",
           dayname,
           day.tm_mday,
           day.tm_year + 1900
         );
  return;
}

If you look closely, you'll notice that I render a date like “Wednesday, December 04, 2002” as “Wednesday, Debtember 04, 2002” as a personal protest to the extreme messages of mass consumerism consumption we are bombarded with during that month.

Although the other user (Hi, Mark!) didn't like that feature, so it was a simple matter of making that code conditional and I did it at compile time, not run time (as a matter of personal preference on my part) but in retrospect, it would have been easier to make it a runtime option, but one that I was relunctant to do since it was so specific.

But over the year it meant I had to compile the program twice—once for me, once for Mark (there was another aspect that was different between my version and Mark's that was amplified when Gregory decided to use mod_blog but that aspect as since been fixed) which gets to be a pain. And yet I still resisted making this a runtime decision.

I could have made this a general feature, the ability to specify alternative names for months, but then why stop there? Why not the days of the week? But what galls me is that adding such features mean I have to forego using strftime() to format the dates (well, not that there aren't problems with the routines in time.h already) and duplicate pretty much what I'm already using.

It was today when I figured out a solution. It may not be the best solution but it does mean I can rip out the above code, meaning I only have to compile once, and I can still use strftime() to format the date, and I can have Debtember, and Mark (and Gregory) can have December.

Locales.

Like I said, it may not be the best of solutions, but it does work.

ANSI-C has the concept of a “locale” which specifies such details of output as the currency symbol, decimal point, number group separators as well as the names of the weekdays and months. Usually this defaults to the C or POSIX locale (which is another word for US hegemony on the computing world) but it can be changed with setlocale()—all that remains is to figure out how to create a new locale for my own use.

There isn't much information about doing this, but I was able to munge my way through. Under Linux (at least Gentoo and RedHat from what I can tell), it meant creating a file under /usr/share/i18n/locales (I created one called en_SPC for ENglish, SPC variant with “Debtember”) and then doing localedef -i en_SPC en_SPC to actually add it to the system.

So I did have to add an option to the configuration file, but now it specifies the locale to use, which, generally speaking, is a better hack than what I had before.

Obligatory Picture

[It's the most wonderful time of the year!]

Obligatory Links

Obligatory Miscellaneous

You have my permission to link freely to any entry here. Go ahead, I won't bite. I promise.

The dates are the permanent links to that day's entries (or entry, if there is only one entry). The titles are the permanent links to that entry only. The format for the links are simple: Start with the base link for this site: http://boston.conman.org/, then add the date you are interested in, say 2000/08/01, so that would make the final URL:

http://boston.conman.org/2000/08/01

You can also specify the entire month by leaving off the day portion. You can even select an arbitrary portion of time.

You may also note subtle shading of the links and that's intentional: the “closer” the link is (relative to the page) the “brighter” it appears. It's an experiment in using color shading to denote the distance a link is from here. If you don't notice it, don't worry; it's not all that important.

It is assumed that every brand name, slogan, corporate name, symbol, design element, et cetera mentioned in these pages is a protected and/or trademarked entity, the sole property of its owner(s), and acknowledgement of this status is implied.

Copyright © 1999-2019 by Sean Conner. All Rights Reserved.