...
|version | |no|
h4.Directory support
from version {{5.0-rc4}} the tag {{attachment}} support also the file inclusion from directory
*Example*
{code:xml}
<!-- include all png files from myfolder -->
<attachment
name="*.png"
uri="myfolder"
comment="file from myfolder"
contentType="image/png"
version="1"/>
<!-- include all files from myfolder -->
<attachment
uri="myfolder"
comment="file from myfolder"
version="1"/>
{code}
h3.label
bq. The content of label's tag is the label's value
h3.generated
bq. This tag has been added from version *5.0-rc3* and allows to choose where put the *built-in generated pages* Currently only *plugin.goals* is supported therefore such tag is useful when we are dealing with *Maven Plugin Documentation*
||Attribute||Description ||mandatory ||
|ref |built-in generated pages Id. Currently only *plugin.goals* is supported |yes |
h4.Usage example
{quote}
{code:xml}
<home uri="index.confluence">
<child name="Summary" uri="summary.confluence"/>
<child name="Goals" uri="goals.confluence">
<generated ref="plugin.goals"/>
</child>
<child name="PluginsSummary" uri="plugins-summary.confluence"/>
</home>
{code}
{quote}
h2.Example
The example below is the [site.xml|https://raw.githubusercontent.com/bsorrentino/maven-confluence-plugin/master/maven-confluence-reporting-plugin/src/site/confluence/site.xml|] used by plugin to document itself
{code:xml}
<?xml version="1.0" encoding="UTF-8"?>
<bsc:site
xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
xmlns:bsc='https://github.com/bsorrentino/maven-confluence-plugin'
xsi:schemaLocation='https://github.com/bsorrentino/maven-confluence-plugin https://raw.githubusercontent.com/bsorrentino/maven-confluence-plugin/master/schemas/site-schema-5.0.xsd'>
<home uri="codehaus-home.confluence">
<child name="Usage" uri="usage.confluence">
<attachment name="gitlog-sample02.png" uri="../resources/images/gitlog-sample02.png" comment="gitlog to jira sample" contentType="image/png" version="1"></attachment>
</child>
</home>
<label>maven</label>
<label>confluence</label>
<label>documentation</label>
</bsc:site>
{code}
----
h2.Note:
h3.The *URI* format
The *uri* attribute could refer to
* *File* resource
bq. We can refer to file in *absolute* way using *file* scheme (e.g. {{file:///Documents/page.confluence}}) or in *relative* way not using any scheme. In that case the path will be resolved starting from *site home*
* *Classpath* resource
bq. We can refer to resource using *classpath* schema. (e.g. {{classpath:page.confluence}})
* Network resource
bq. We can refer to resource using *http* scheme. (e.g. {{http://www.thesite.com/page.confluence}})
E-mail
