Как включить вывод shortdesc на DITA markdownn с помощью открытого инструментария DITA? - PullRequest
Новая
       28

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

0 голосов
/ 01 мая 2018

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

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

"LwDITA-совместимые документы (MDITA) первый абзац рассматривается как короткий элемент. В общих документах по уценке все пункты появляются внутри элемента 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 Ответ

0 голосов
/ 03 мая 2018

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

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

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

  # title {.task}

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

...