Question

我想用DITA OT 3.0.3将我的降价风格的DITA内容转换为HTML5风格的输出。

我检查了语法页面，我理解为第1段将是shortdesc。

＆＃34; LwDITA兼容文档（MDITA）第一段被视为一个短片元素。在通用Markdown文档中的所有段落出现在body元素内。＆＃34;

这是我执行的命令。

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.

它会在out目录下生成index.html和input.html。我希望index.html上的input.html链接有悬停文本，但它没有。

我的期望是悬停文字显示＆＃34;一些描述＆＃34;。我有什么问题？

在其他情况下我也尝试过：

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输出的shortdesc？或者到目前为止不可能吗？

参考文献：

Markdown DITA syntax reference我检查了此页面以进行语法检查。
shortdesc我也检查过这个并尝试编写＆＃34; shortdesc＆＃34;在ditamap。
Purpose of short descriptions我的预期输出有点像这个页面。
Download DITA-OT DITA-OT下载链接。

Answer 1

从DITA Map：

引用这样的markdown文件

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

似乎可以实现将每个段落视为shortdesc的改进。但是你的Markdown文件有一个属性，可以将其标识为DITA任务：

  # title {.task}

这不再适用于＆＃34; mdita＆＃34;格式，可能是因为LightWeight DITA标准没有提供声明某个Markdown文件应该转换为DITA任务的可能性。我将尝试与创建Markdown DITA转换器的Jarno Elovirta取得联系，看看他对此有何看法。

如何使用DITA开放工具包在DITA markdownn上启用shortdesc输出？

1 个答案: