2015-05-01 5 views
2

Я организую локализованную документацию для внутреннего использования на нескольких языках.Локализация в DITA

В основном аргумент делится на темы, сгруппированные по ditamap.

Допустим, это структура:

  1. описание (тема)
  2. история (тема)
  3. проблемы (темы)

Затем каждая тема имеет заголовок и текст.

<topic id="topic_gbq_tdy_wr"> 
    <title>Title in specific language</title> 
    <body> 
    <p>lot of text here....</p> 
    </body> 
</topic> 

Во всех случаях Заголовок представляет собой статический ярлык, который должен быть изменен во время сборки с помощью инструментов, с локализованным значением.

В идеале, если у меня есть продукт A, у меня бы были productA_it.dita и productA_en.dita, оба из них с правильной локализацией. И так далее для продукта B, у него будут такие же темы, но локализованные названия.

Как я могу это достичь?

ответ

0

Я не уверен, если я правильно понимаю, чего вы пытаетесь достичь. Я полагаю, вы используете DITA-OT. Если вы преобразуете свои карты или темы, DITA-OT вводит текст, определенный в локализованных XML-файлах. Вы можете добавить или изменить текст, как описано here.

Если вам нравятся стандартные текстовые фразы, вы можете хранить их ключи (один файл на каждый язык) и обменивать эти файлы, когда вам это нужно.

myMap.ditamap

Карта с Струнный файл.

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> 
<map> 
    <title>Title of Your Map</title> 

    <!-- Reference to a Topic --> 
    <topicref href="myTopic.dita"/> 

    <!-- Your Key Files --> 
    <topicref keys="myStrings" href="myStringsEN.dita" processing-role="resource-only"/> 
    <!--<topicref keys="myStrings" href="myStringsDE.dita" processing-role="resource-only"/>--> 
</map> 

myStringsEN.dita

Ваш Строка файл. Он содержит ph элементов, на которые можно ссылаться во многих элементах, например title или p.

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> 
<topic id="myStrings"> 
    <title>My Strings EN</title> 
    <body> 
    <p> 
     <ph id="myFristString">HELLO</ph> 
     <ph id="mySecondString">WORLD</ph> 
    </p> 
    </body> 
</topic> 

myTopic.dita

Ваш Тема файл, содержащий ссылки ph с conkeyref атрибутами.

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> 
<topic id="myTopic"> 
    <title>My Topic</title> 
    <body> 
    <p><ph conkeyref="myStrings/myFristString"/></p> 
    <p><ph conkeyref="myStrings/mySecondString"/></p> 
    </body> 
</topic> 

Надежда, что помогает ...