使用 Confluence 4.0 在用户宏中添加 Wiki 标记

Question

使用 Confluence 4.0 时，如何在用户宏（或在用户宏编辑器中完成的生成动态输出的其他内容）中使用 wiki 标记。 在 Confluence 3.5.3 中，我有一个包含以下内容的宏，我想迁移它：

{info:title=Table of content}
{toc}
{info}

Answer 1

好的，我知道如何解决这个问题。你必须编写 XHTML，下面显示了上面的示例在 XHTML 中的样子：

## @noparams
<ac:macro ac:name="info">
    <ac:parameter ac:name="title">Table of content</ac:parameter>
    <ac:rich-text-body>
        <ac:macro ac:name="toc" />
    </ac:rich-text-body>
</ac:macro>

我发现的另一个肮脏的方法是使用转换标记（将来可能会过时）：

## @noparams
<ac:macro ac:name="unmigrated-inline-wiki-markup">
    <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
    <ac:plain-text-body><![CDATA[
        {info}Here you can write wiki markup the old way, until Atlassian removes this transition markup (unmigrated-inline-wiki-markup){info}
    ]]></ac:plain-text-body>
</ac:macro>

Answer 2

要获取需要为宏编写的 XHTML，请按照下列步骤操作： 使用

1. 所需的宏创建一个新页面并保存它。
2. 如果您是 Confluence 管理员或在开发模式下运行，请打开“工具”>“Confluence 管理员”。 查看存储格式页面。
3. 该页面现在将以新的存储格式显示原始输出。

如果您无权访问查看存储格式选项，则解决方法是：

1. 打开页面“信息”（“工具”>“信息”），记下中的 pageId=网址。
2. 打开一个新的浏览器窗口并输入以下 URL，替换 confluence root 和 page id 变量。

http://{your-confluence-root}/plugins/viewstorage/viewpagestorage.action?pageId={your-page-id}

参考文献：
Confluence 4.0 编辑器常见问题解答

Answer 3

您应该在用户宏中将 wiki 标记动态渲染为 xhtml！这是一些代码：

## @noparams
#set($globalHelper = $action.getHelper())
#set($renderedhtml = $globalHelper.renderConfluenceMacro("{info}test{info}"))
$renderedhtml