24.08.2015 Views

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Author</strong> for DITA | 119Figure 70: WebHelp Search with Stemming EnabledRules applied during search:• keywords are separated by the space character. An expression like spray painting counts as two separate keywords:spray and painting;• do not use quotes to perform exact search for multiple-word expressions. An expression like "spray painting", returnsno results in our case, because it searches for two separate words: "spray and painting" (note the quote signs attachedto each word);• indexterm and keywords DITA elements are an effective way to increase the ranking of a page. For example, contentinside keywords elements weighs twice as much as content inside a H1 HTML element;• words composed by merging two or more words with colon (":"), minus ("-"), underline ("_"), or dot (".") characters,count as a single word.How to Localize WebHelp OutputStatic labels used in the WebHelp output are kept in translation files in the DITA-OT/xsl/common folder. This folderis found either in the <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> installation folder, or elsewhere if you are using a different DITA-OTdistribution. Translation files have the strings-lang1-lang2.xml name format, where lang1 and lang2 are ISO languagecodes. For example, the US English text is kept in the strings-en-us.xml file.Follow these steps to localize the interface of the WebHelp output (for simplicity sake, let us suppose you want to localizethe WebHelp interface into Canadian French.):1. Look for the strings-fr-ca.xml file. If it does not exist, create one starting from strings-en-us.xml.2. Translate the labels with the following names: Content, Search, Keywords, Search no results, Output generated by,Next topic, Previous topic, and Parent topic. Labels are stored in <strong>XML</strong> elements that have the following format:Caption.3. Edit the DITA Map WebHelp transformation scenario and set the args.default.language parameter to the code ofthe language you want to localize the interface into (in our case, it is fr-ca).4. Run the transformation scenario to produce the WebHelp output.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!