Я недавно сталкивался с DITA и с ним дурачился, чтобы оценить, будет ли он применим для наших внутренних потребностей в документации. Я пытаюсь понять (и научиться), как правильно структурировать документ. Моя первоначальная настройка примерно такая:
MainMap.ditamap:
<map>
<mapref href="submap-1.ditamap"/>
</map>
подкарта-1.ditamap:
<map>
<topichead navtitle="Topic Title 1">
<topicref href="topic1.dita"/>
<topicref href="topic2.dita"/>
</topichead>
</map>
Когда я конвертирую это в HTML, я получаю список следующих html:
- toc.html
- mainmap.html
- topic1.html
- topic2.html
toc.html выглядит так:
Содержание
Итак, одну вещь, которую я не понимаю здесь, это то, что «Название темы 1» также является ссылкой, и она связана с mainmap.html, который просто содержит заголовок, что делает его абсолютно бесполезным. Я ожидаю (или хочу :)), что «Название темы 1» не будет ссылкой или, если это так, будет ссылкой на страницу с оглавлением для подкарты.
- Возможно ли содержание для субкарт?
- Должен ли я структурировать подкарты по-другому, чтобы заголовок темы был более полезным? Вместо использования themehead, используйте topicref для topictitle.dita с кратким содержанием и списком, похожим на TOC?
- Было бы немного громоздко вести этот список. Есть ли способ сделать это автоматически?
- Конвертировать главную карту как страницу с несколькими HTML, но подкарту как страницу с одним HTML? Это возможно?
Кстати, я пробую ознакомительную версию XMLMind XML Editor - Professional Edition. Предложение в редакторе с точки зрения лучшей функциональности / юзабилити / возможности покупки также приветствуется. :)
Спасибо за помощь!