Нормализованный DITA: разделить темы на отдельные файлы?

Я следую документации DITA Open-Toolkit 3.5 для создания нормализованных DITA из облегченного ввода/уценки.

Как я могу разделить вывод, чтобы получить один файл для каждой темы? Вот моя входная уценка (test.md):

# My Document

This is my document

# Header One

This is some text.

- One
- Two
- Three

# Header Two

This is some text for the Topic called 'Header Two'.
Another bit of text here.

- Item 1
- Item 2
- Item 3

И мой файл карты (map.dita):

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
  <topicref href="test.md" format="markdown"/>
</map>

И команда, которую я использую:

$ dita --input=map.dita --format=dita

И дита версия:

$ dita -version
DITA-OT version 3.5.3

В руководстве рассказывается о плагинах, но я не уверен, нужно ли их специально писать на java или можно ли этого добиться с помощью XSLT? (или конфиг и т.д.)


person monojohnny    schedule 11.09.2020    source источник


Ответы (1)


Плагин нормализации DITA находится в DITA-OT/plugins/org.dita.normalize и имеет таблицу стилей XSLT, которая генерирует тему DITA org.dita.normalize/xsl/normalize.xsl. Может быть, вы можете изменить эту таблицу стилей XSLT и использовать xsl:result-document для создания отдельных файлов для внутренних разделов. Я также сделал это видео около 2 лет назад для DITA Open Toolkit Day, в котором подробно рассказывается, как можно реализовать плагин DITA OT, возможно, вам будет полезно узнать, что такое плагин в целом и что он может делать: https://www.oxygenxml.com/events/2018/dita-ot_day.html#step_by_step_implementation_of_a_DITA

person Radu Coravu    schedule 15.09.2020