回声宏

Echo宏是一个非常简单的宏：它打印出任何提供的参数的键和值。例如，在 APT 文件中，您可以编写：

%{echo|param1=value1|param2=value2}

同样，它将用于 xdoc 文件：

<macro name="echo">
  <param name="param1" value="value1"/>
  <param name="param2" value="value2"/>
</macro>

它会输出

  param1 ---> value1
  param2 ---> value2

片段宏

Snippet宏是一个非常有用的宏：它打印出文件或 URL 的内容。例如，在 APT 文件中，您可以编写：

%{snippet|id=myid|url=http://myserver/path/to/file.txt}

在 xdoc 文件中，它将是：

<macro name="snippet">
  <param name="id" value="myid"/>
  <param name="url" value="http://myserver/path/to/file.txt"/>
</macro>

id如果要包含整个文件，则不需要该参数。如果您只想包含文件的一部分，则应添加开始和结束分界符：任何包含字符串“ START”、“ SNIPPET”和“ myid”（片段的 ）的行（通常是注释）都是myid开始id分界符，类似地，“ END SNIPPET myid”表示要包含的片段的结尾。例如：

• Java 文件中的开始和结束片段

  public class MyClass
  {
      // START SNIPPET: myid
      public static void main( String[] args ) throws Exception
      {
          ...
      }
      // END SNIPPET: myid
  }

• XML 文件中的开始和结束片段

  <project>
  ...
    <build>
      <plugins>
  <!-- START SNIPPET: myid -->
        <plugin>
          ...
        </plugin>
  <!-- END SNIPPET: myid -->
      </plugins>
    </build>
  </project>

目录宏

TOC宏打印文档的目录。如果您的文档中有多个部分和子部分，这将很有用。例如，在 APT 文件中，您可以编写：

%{toc|section=2|fromDepth=2|toDepth=3}

这将显示文档中第二部分的目录，包括所有小节（深度 2）和子小节（深度 3）。

请注意，在 Doxia 中，apt 部分标题不是隐式锚点（请参阅APT 格式的增强），因此您需要插入显式锚点才能使链接正常工作！

在 xdoc 文件中，它将是：

<macro name="toc">
  <param name="section" value="2"/>
  <param name="fromDepth" value="0"/>
  <param name="toDepth" value="4"/>
</macro>

从Doxia 1.1.1开始，您还可以指定任何 html 基本属性（即id, class, style, lang,中的任何一个title）作为参数，例如：

%{toc|class=myTOC}

这可用于通过 css 设置 TOC 样式。

SWF 宏

Swf宏在文档中打印 Shockwave Flash 资源。例如，在 APT 文件中，您可以编写：

%{swf|src=swf/myfile.swf|id=MyMovie|width=600|height=200}

在 xdoc 文件中，它将是：

<macro name="swf">
  <param name="src" value="swf/myfile.swf"/>
  <param name="id" value="MyMovie"/>
  <param name="width" value="600"/>
  <param name="height" value="200"/>
</macro>

有关详细信息，请参阅SWF 宏页面。

SSI 宏

从 Doxia 1.7 开始，SSI宏打印服务器端包含。例如，在 APT 文件中，您可以编写：

%{ssi|function=include|file=included-file.html}

在 xdoc 文件中，它将是：

<macro name="ssi">
  <param name="function" value="include"/>
  <param name="file" value="included-file.html"/>
</macro>