| | 617 | <h2><a name="XincludeFilter"></a>XincludeFilter</h2> |
|---|
| | 618 | <p> |
|---|
| | 619 | The <em>XincludeFilter</em> processes a stream for Xinclude tags, and processes the inclusions. |
|---|
| | 620 | This is useful for processing modular XML files. DocBook book files are one example of |
|---|
| | 621 | modular XML files. Usage example: |
|---|
| | 622 | <pre> |
|---|
| | 623 | <!-- |
|---|
| | 624 | Render a DocBook book file called manual.xml, which |
|---|
| | 625 | contains Xinclude tags to include individual book sections. |
|---|
| | 626 | --> |
|---|
| | 627 | <copy todir="${manual.dest.dir}"> |
|---|
| | 628 | <filterchain> |
|---|
| | 629 | <xincludefilter basedir="${manual.src.dir}" /> |
|---|
| | 630 | <xsltfilter style="${manual.src.dir}/html.xsl"> |
|---|
| | 631 | <param name="base.dir" expression="${manual.dest.dir}/" /> |
|---|
| | 632 | </xsltfilter> |
|---|
| | 633 | </filterchain> |
|---|
| | 634 | <fileset dir="${manual.src.dir}"> |
|---|
| | 635 | <include name="manual.xml" /> |
|---|
| | 636 | </fileset> |
|---|
| | 637 | </copy> |
|---|
| | 638 | </pre> |
|---|
| | 639 | <h3>Attributes</h3> |
|---|
| | 640 | <table> |
|---|
| | 641 | <caption> |
|---|
| | 642 | Attributes for the <em><xincludefilter></em> tag |
|---|
| | 643 | </caption> |
|---|
| | 644 | <thead> |
|---|
| | 645 | <tr> |
|---|
| | 646 | <th>Name</th> |
|---|
| | 647 | <th>Type</th> |
|---|
| | 648 | <th>Description</th> |
|---|
| | 649 | <th>Default</th> |
|---|
| | 650 | <th>Required</th> |
|---|
| | 651 | </tr> |
|---|
| | 652 | </thead> |
|---|
| | 653 | <tbody> |
|---|
| | 654 | <tr> |
|---|
| | 655 | <td>basedir</td> |
|---|
| | 656 | <td>String</td> |
|---|
| | 657 | <td> |
|---|
| | 658 | The working directory from which to |
|---|
| | 659 | process the Xincludes. Relative pathnames |
|---|
| | 660 | in the include tags are based on this |
|---|
| | 661 | location. |
|---|
| | 662 | </td> |
|---|
| | 663 | <td>Project basedir</td> |
|---|
| | 664 | <td>No</td> |
|---|
| | 665 | </tr> |
|---|
| | 666 | </tbody> |
|---|
| | 667 | </table> |
|---|
| | 668 | |
|---|
| | 669 | |
|---|