Как включить вывод shortdesc на DITA markdownn с открытым инструментарием DITA?

Я хочу преобразовать содержимое DITA в стиле уценки в вывод в стиле HTML5 с помощью DITA OT 3.0.3.

Я проверил страницу синтаксиса, и я понимаю, что 1-й абзац будет кратким.

"Совместимые с LwDITA документы (MDITA) первый абзац рассматривается как элемент shortdesc. В общих документах Markdown все абзацы появляются внутри элемента body".

Вот моя выполненная команда.

dita --input=sequence.ditamap --format html5

И ниже приведены мои примеры файлов.

sequence.ditamap:

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

<map>
  <title>Working in the garage</title>
  <topicref href="input.md" format="markdown" />
</map>

input.md:

# title {.task}

Some Description

1. steps1

    step1 content

2. steps2

    step2 content

This is step result.

Он создаст index.html и input.html в каталоге out. Я надеюсь, что ссылка на input.html в index.html содержит всплывающий текст, но это не так.

Я ожидаю, что при наведении курсора появится надпись "Some Description". Что со мной не так?

Я также пробовал в других случаях:

Tri # 1 input.md:

Some Description(new)

# title {.task}

    Some Description

Сказано [filter] Content is not allowed in prolog.

Попробуйте #2 sequence.ditamap:

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

<map>
  <title>Working in the garage</title>
  <topicref href="input.md" format="markdown">
    <topicmeta>
        <shortdesc>Some Description(2nd new)</shortdesc>
    </topicmeta>
</topicref>
</map>

В этом случае ошибки нет, но это краткое описание не отображается на выходе.

Вот часть вывода input.html.

<head>
:
:
<meta name="DC.Type" content="task">
<meta name="DC.Format" content="HTML5">
<meta name="DC.Identifier" content="title">
<link rel="stylesheet" type="text/css" href="commonltr.css">
<title>title</title></head>
<body id="title">
:
:
    <h1 class="title topictitle1" id="ariaid-title1">title </h1>
    <div class="body taskbody">
    <section class="section context"></section>
    <ol class="ol steps">
    </ol>
    <section class="section result"></section></div>
:
:
</body>

Итак, как я могу включить генерировать шортдеск для вывода HTML5? или это пока невозможно?

Рекомендации:

1 ответ

Ссылка на файл уценки, например, на карте DITA:

           <topicref href="input.md" format="mdita" />

Похоже, что это улучшение, которое рассматривает каждый абзац как shortdesc. Но у вашего файла Markdown есть атрибут, который определяет его как задачу DITA:

  # title {.task}

и это больше не работает должным образом с форматом "mdita", возможно, потому, что стандарт LightWeight DITA не дает возможности заявить, что определенный файл Markdown должен быть преобразован в задачу DITA. Я постараюсь связаться с Ярно Эловирта, который создал конвертер Markdown to DITA, посмотрим, что он скажет по этому поводу.

Другие вопросы по тегам