RE: [docbook-apps] Error when creating CHM with japanese content

["David Cramer \(Tech Pubs\)" <dcramer at motive dot com>]

I think typically you would pass in those params from your build system or pass in just the language and set the other params based on that (as you suggested, with an xsl:choose). Something like this, assuming you've set l10n.gentext.language from the command line:

<xsl:param name="htmlhelp.encoding">
<xsl:choose>
  <xsl:when test="substring($l10n.gentext.language,1,2) = 'ja'">Shift_JIS</xsl:when>
  <xsl:otherwise>window-1252</xsl:otherwise>
</xsl:choose>
</xsl:param>

You could instead base the test on the value of a lang attribute in the doc. 

One thing to keep in mind about creating Japanese chms. It is possible to create them on non-japanese versions of Windows if you load the asian font packs, but the search won't work unless you create it on a Japanese version of the OS. Be sure to test that. 

Another challenge is sorting your index. You have to use the .hhk file [1] for your index (rather than the index entries embedded in the html files) and you must have your tranlator transliterate index terms into Furigana (i.e. Katakana or Hiragana) in sortas attributes on the primary, secondary, and tertiary elements. Even then, IIRC, there are some limitations the .hhk files that the xsls currently produce--I know duplicate terms are not collapsed and I'm not sure if it currently sorts them. 

David

[1] http://docbook.sourceforge.net/release/xsl/current/doc/html/htmlhelp.use.hhk.html

> -----Original Message-----
> From: Kenneth Johansson [mailto:ke-joh@sectra.se]
> Sent: Wednesday, August 18, 2004 9:08 AM
> To: 'Jirka Kosek'
> Cc: 'DOCBOOK-APPS'
> Subject: RE: [docbook-apps] Error when creating CHM with japanese
> content
> 
> 
> Hi,
> 
> Thanks for the help. It worked fine when I installed the 
> East-Asian language
> pack for Windows XP, and added the following parameters:
> 
>   <xsl:param name="htmlhelp.encoding" select="'Shift_JIS'"/>
>   <xsl:param name="default.encoding" select="'Shift_JIS'"/>
>   <xsl:param name="chunker.output.encoding" select="'Shift_JIS'"/>
> 
> Since we have 10 different languages and Japanese needs a 
> different encoding
> how do I go about to customize my parameters to switch from 
> "window-1252" to
> "Shift_JIS" when building the Japanese files? Should I use xsl:if or
> xsl:choose to switch parameters or load another xsl-file with proper
> parameters, e.g. something like this(without know enough xsl):
> 
>         <xsl:choose>
>           <xsl:when test="string($lang-attr) = ''jp">
>             <xsl:import href="../../htmlhelp/jp.xsl"/>
>           </xsl:when>
>           <xsl:otherwise>
>             <xsl:import href="../../htmlhelp/common_lang.xsl"/>
>           </xsl:otherwise>
>         </xsl:choose>
> 
> Any ideas?
> 
> /Kenneth
> 
> --------------------------------------------------------
> Kenneth Johansson	Technical Documentation Manager
> Sectra Imtec AB
> Teknikringen 20		E-mail: ke-joh AT sectra DOT se
> SE-583 30 Linköping	Phone:	+46 13 23 52 00
> SWEDEN			Web:	http://www.sectra.se
> 
> > -----Original Message-----
> > From: Jirka Kosek [mailto:jirka@kosek.cz]
> > Sent: den 16 augusti 2004 16:43
> > To: Kenneth Johansson
> > Cc: 'DOCBOOK-APPS'
> > Subject: Re: [docbook-apps] Error when creating CHM with
> > japanese content
> >
> > Kenneth Johansson wrote:
> >
> > > I get a strange error when I'm building japanese CHM using
> > a makefile.
> > > The XSL-step works fine but HTMLHelp Workshop hangs during
> > compilation
> > > of keyword ("Keyword processing...") I think.
> > >
> > > Any ideas?
> >
> > AFAIK Japanese help can be generated only on Japanese
> > Windows. This might be source of your problems.
> >
> > 					Jirka
> >
> > --
> > ------------------------------------------------------------------
> >    Jirka Kosek     e-mail: jirka@kosek.cz     http://www.kosek.cz
> > ------------------------------------------------------------------
> >    Profesionální ¹kolení a poradenství v oblasti technologií XML.
> >       Podívejte se na ná¹ novì spu¹tìný web http://DocBook.cz
> > ------------------------------------------------------------------
> >
> 
> 
>