Confluence 4.0 用户宏中的 Wiki 标记答案

【问题标题】：Wiki markup in user macro with Confluence 4.0Confluence 4.0 用户宏中的 Wiki 标记
【发布时间】：2011-11-20 22:53:00
【问题描述】：

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

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

【问题讨论】：

标签： macros confluence

【解决方案1】：

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

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

【讨论】：

【解决方案2】：

要获取您需要为宏编写的 XHTML，请执行以下步骤：

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

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

打开页面信息（工具>信息），注意URL中的pageId=。
打开一个新的浏览器窗口并输入以下 URL，替换 confluence 根和页面 id 变量。

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

参考资料：
Confluence 4.0 Editor FAQ

【讨论】：

【解决方案3】：

好的，我找到了解决方法。您必须编写 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>

【讨论】：

我可以理解，他们必须更改标记的持久性，以使他们新的完全所见即所得模式正常工作 - 但从用户宏中删除 wikimarkup 是没有意义的。