Re: [docbook-apps] localizing Webhelp

[David Cramer <david@thingbag.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 07/12/2012 07:58 PM, Jeff Powanda wrote:
> I’m considering switching from Eclipse Help to Webhelp, but
> wondered about Webhelp localization. We’re localizing our
> documentation to French, German, and possibly other languages soon.
> Eclipse Help has language packs for those languages. Does Webhelp
> also run in those languages?

Hi Jeff,
Stemming for English, French, and German is supported and Asian
languages (CJK) are supported via an n-gram tokenizer borrowed from
Lucene.

To support client-side, JavaScript based search, there are two parts:
at build time an indexer (a java program) generates JavaScript files
that pre-index the content. Then at runtime, a client-side stemmer
stems the terms that the user puts in the search box. Of course, it
will support search in any language without stemming.

Currently the Java stemmer supports more languages [1] than we have
client-side stemmers for, but we provide docs if you would like to
implement new stemmers using the Porter algorithm [2].

Btw., when I say "we" I should say "Kasun" since he did all this as
part of his Google Summer of Code project two years ago.

The search in Eclipse help, which uses Lucene, will be much richer
than what Webhelp can provide with its client-side search, but webhelp
is also much lighter.

However, one of our current Google Summer of Code students plans to
create a webhelp-as-war output that uses Lucene to do the search. If
running an application server is an option, then this light webapp
would provide a much better search than is possible with javascript.
Of course, Arun still has to write all the code for that :-)

David

[1]
http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/content/ch02s04.html

[2]
http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/content/ch03s02s01.html

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJP/6IeAAoJEMHeSXG7afUhf90IAJ8Lu820jObp5FwPFMVfQ05O
zwzdrJiVEJ7ztGhrGkmd2gA9yhMAf7jFG2rjWWi8lsfDNRSsDXsNA6bSkrdA0cx8
QDYA/YVyILfLK6vigrRml+mZm/JuGREmNbsOJnaV/XaVvHVIeDC5JsyRfXfaBwIQ
Uzu2V7G8V7pUX3IV0DHDB5zmbLDfFyJlbeRRBR7d9JWDRqq1NOXSTZTnHTTdbRCG
46GmVGlNCffoss3Iy8tTXjOL34A+KdgLrq0VMlb6jvBFfpmMk472WQhheyvCjJ4v
ncc+/+SJ8NZnp2+RYk2mKEI21Rb/vRGeZyC+ugdIBwrUVhAeHuZIjP363oIa5Fo=
=VCpp
-----END PGP SIGNATURE-----