hany bee wrote:
> We are evaluating xxe to be a major tool for our documentation 
> department, but it must support multiple languages.
> We are planning to write docbooks in at least 3 languages, so the 
> conversion must be able to handle that.
> 
> I don't know how the professional version can handle this thing, but I'm 
> trying the free version here.

You can test what follows with free Standard Edition.



> Looking at the directory
>  $XXE_HOME/config/docbook/xsl/common
> I see a bunch of files that can handle conversion in multiple languages. 
> That looks cool, but how can I them?

Very easily. Select root element and add it attribute lang with a value 
such as "fr", then convert your document.





> Say, I have a DocBook book, and convert it to html. The english version 
> is ok, converting in other languages
> still uses the english words. How can make XXE to use another language, 
> say french, so that
> "Chapter" becomes "Chapitre"?

XXE currently cannot translate the name of element and attributes. For 
example, docbook element "set" cannot appear as "ensemble" in the *GUI* 
(attribute editor, element chooser, node path bar, etc).

XXE can be configured to display "Chapitre" instead of "Chapter" in the 
*document view*.

That is, the CSS style sheet can be modified to generate localized 
content, just like the XSLT style sheet supports localized generated 
content.

This can be done using the xpath() CSS pseudo-function. See 
http://www.xmlmind.com/xmleditor/_distrib/docs/csssupport/ch05s33.html

For example, in $XXE_HOME/config/docbook/css/docbook1.imp, replace:

---
chapter > title:before {
     content: "Chapter " counter(n-, decimal) ": ";
}
---

by:

---
chapter > title:before {
  content:
   xpath("if(/*/@lang='fr', 'Chapitre', /*/@lang='de', 'Kapitel', 
'Chapter')")
   counter(n-, decimal) ": ";
}
---


> Is there any easy way thru the UI?

Yes, using modified DocBook CSS style sheets, you'll have to select root 
element and add attribute lang with a value such as "fr" and then, 
you'll have to use Select|Redraw (Ctrl-L) to refresh the document view.

A macro command can be used to automate all this.




> Is there anyway to try out the conversion to pdf in the free version?

Yes,

* download and install RenderX XEP *Trial Edition* (http://www.renderx.com/)

* then download and install the XEP plug-in for XXE. See 
http://www.xmlmind.com/xmleditor/plugins.shtml and see also 
http://www.xmlmind.com/xmleditor/xep_install.html

Note that by doing this, you meanly evaluate the quality of expensive, 
commercial, RenderX XEP and not the quality of free, OpenSource, FOP 
which is the alternate way to generate PDF in XXE.


Reply via email to