The DefaultFilePublisher Task
The DefaultFilePublisher is a task that copies XML source files from the authoring directory to another location, usually the live directory. It needs the following parameters:
- publication-id: the publication identifier
- authoring-path: the authoring path
- tree-authoring-path: the location of the tree.xml file
- live-path: the live path
- tree-live-path: the location of the tree.xml file
- sources: a comma-separated list of files to publish
All paths are relative to the publication directory. Usually, the path information is read from the [publication-directory]/config/publishing/publisher.xconf file:
<publication> <authoring> <documents href="content/authoring"/> <tree href="content/authoring/tree.xml"/> </authoring> <live> <documents href="content/live"/> <tree href="content/live/tree.xml"/> </live> ... </publication>
You can override the paths in the task configuration file tasks.xconf, e. g. to use several publishers to publish into different directories:
<tasks> <task id="publish-test" class="org.apache.lenya.cms.publishing.DefaultFilePublisher"> <label>Publish</label> <parameter name="live-path" value="content/live-test"/> <parameter name="tree-live-path" value="content/live-test/tree.xml"/> </task> <task id="publish-real" class="org.apache.lenya.cms.publishing.DefaultFilePublisher"> <label>Publish</label> <parameter name="live-path" value="content/live"/> <parameter name="tree-live-path" value="content/live/tree.xml"/> </task> </tasks>
The remaining parameters, publication-id and sources, are passed to the task as request parameters.