Confluence存储格式 - 任何使用锚点和锚点链接宏的人

Question

我正在解析dita xml，我必须生成Confluence Storage Format。

我在使用Anchor macro时遇到困难，而dita格式的外部参照与html本地链接<xref href="#id">title</xref>....<any id="id"...的行为方式相同，汇合缝具有自己独特的合成器。

有人在如何构建正确的锚并正确链接它方面有什么好的例子吗？

Answer 1

anchor宏实际上创建了一个HTML <span>元素，其中包含一个包含页面标题和锚点的ID。

<span id="CONFLUENCEPAGENAME-ANCHORNAME" class="confluence-anchor-link"></span>

因此，如果您的汇总页面代表一个主题，那么应该很容易实现（因为CONFLUENCEPAGENAME等于您的主题标题或密钥或ID或您使用的任何内容）。只需创建一个空的汇合页面，添加一个anchor宏，保存它并检查呈现的HTML。

Answer 2

我终于明白了。

而不是元素上的id，我们插入一个锚链接应该发送给用户，我将它插入标题上方。 <ac:structured-macro ac:name="anchor"><ac:parameter ac:name="">The_Id</ac:parameter></ac:structured-macro>

锚链接就是这样构建的。 <ac:link ac:anchor="The_Id"><ac:plain-text-link-body><[CDATA[text describing the link]]></ac:plain-text></ac:link>

在Confluence 5.7上测试

Answer 3

Saloparenator的答案中有一个小错误。锚链接是：

<ac:link ac:anchor="The_Id">
    <ac:plain-text-link-body>
        <[CDATA[text describing the link]]>
    </ac:plain-text-link-body>
</ac:link>

Answer 4

如果要链接的页面具有TableOfContents-并且您希望从另一个页面2链接到此页面1中的某个部分...

查看第1页，然后单击TableOfContents中的链接，这将带您到同一页上的该部分。

现在从浏览器地址栏中复制此URL（类似于http://confluence/page1#anchor），然后转到您要放置链接的page2。

编辑page2，然后粘贴指向page1的链接。