Apache » Lenya

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.