Как включить вывод 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? или это пока невозможно?
Рекомендации:
- Ссылка на синтаксис Markdown DITA Я проверил эту страницу для проверки синтаксиса.
- shortdesc Я также проверил это и попытался написать "shortdesc" на ditamap.
- Цель кратких описаний Мой ожидаемый результат - что-то вроде этой страницы.
- Скачать ссылку DITA-OT DITA-OT.
1 ответ
Ссылка на файл уценки, например, на карте DITA:
<topicref href="input.md" format="mdita" />
Похоже, что это улучшение, которое рассматривает каждый абзац как shortdesc. Но у вашего файла Markdown есть атрибут, который определяет его как задачу DITA:
# title {.task}
и это больше не работает должным образом с форматом "mdita", возможно, потому, что стандарт LightWeight DITA не дает возможности заявить, что определенный файл Markdown должен быть преобразован в задачу DITA. Я постараюсь связаться с Ярно Эловирта, который создал конвертер Markdown to DITA, посмотрим, что он скажет по этому поводу.