Include or exclude DITA elements

You can create one or more new transformations to adjust the default, where some DITA elements are included in the Collaborative Review feature, but not in the Approvals feature.

Within Collaborative Reviews, the following DITA elements are visible by default, but are not visible within Approvals.

  • required-cleanup

  • draft-comment

To change the default, create a new transformation scenario for Collaborative Reviews, Approvals or both, by modifications such as:

  • Add a new target, based on thedita2xhtmlcr target

  • Add a new preprocessor, based on thedita2xhtmlcr preprocessor

  • Add a new target, based on thedita2xhtmlapproval target

  • Add a new preprocessor, based on thedita2xhtmlapproval preprocessor

Note: The following sample transformation scenario includes required-cleanup and draft-comment in the final Approvals output.

To include or exclude DITA elements:

  1. In preprocessors.xml, copy the dita2xhtmlapproval preprocessor and add it to your client preprocessors.xml file.
  2. Do not rename the copy.
  3. In conductor-ixia-cr.xml, copy the dita2xhtmlapproval target and add it to your conductor-client.xml file.
  4. Rename the copy to something like acme.dita2xhtmlapproval.
  5. Edit the new preprocessor.
    <preprocessor name="dita2xhtmlapproval" class="com.ixiasoft.outputgenerator.preprocessor.AntProcessor" >
    	<parameters>
    		<system>
    			<parameter name="buildfile" value="/conductor-client.xml"/>
    			<parameter name="target" value="acme.dita2xhtmlapproval"/>
    			<parameter name="clean" value="job_postprocess"/>
    			<parameter name="keep.log.files" value="true"/>
    		</system>
    	</parameters>
    </preprocessor
  6. Edit the new target.
    <target name="acme.dita2xhtmlapproval" depends="default_dependencies, dita2xhtmlcr.init, flatten, resolve_container_keyref, extract_LowRes_images">
    	<echostart>acme.dita2xhtmlapproval</echostart>
    
    	<ot_build_add_ditaval_ifpresent/>
    	<ot_build_clean_ot_temp/>
    
    	<ot_build_set_parameter name="transtype" value="xhtml-cr"/>
    	<ot_build_set_parameter name="args.draft" value="yes"/>
    
    	<dita_startcmd_ot_build/>
    
    	...
    
    	<echoend>acme.dita2xhtmlapproval</echoend>
    </target>

    You do not need to create a new output type. The existing Dita2xhtmlapproval output type automatically calls your new preprocessor which in turn calls your new target.

    In addition to setting the args.draft parameter, you can add any other DITA-OT or custom build parameters to your new target, just as you would for any other target.

    Note: Any output type, preprocessor, or target in your client files automatically replaces an output type, preprocessor, or target of the same name in the default copies of the outputtypes.xml, preprocessors.xml, or conductor files.
  7. Restart the Ixiasoft Output Generator service.