MorganaXProc-IIIee supports step p:xsl-formatter based on Apache FOP 2.x. (Tested with 2.6 and 2.8). An implementation supported by Antenna House Formatter is in the final round of testing. To use p:xsl-formatter, Apache FOP must be on the classpath. Please mind, that not only fop.jar is needed, but also the JAR-files distributed in FOP's "lib"-folder.

In addition to options parameters and content-type, MorganaXProc-IIIee defines two additional options named "mox:strict-parameter-evaluation" and "mox:strict-key-handling" in MorganaXProc's namespace "http://www.xml-project.com/morganaxproc". Both options are xs:booleans and are set to false by default.

If "mox:strict-parameter-evaluation" is set to true, MorganaXProc-III will raise an error if the value supplied with a key does not match the expected type. If it is set to false (default) the value is ignored.

If "mox:strict-key-handling" is set to true, MorganaXProc-IIIee will raise an error is the key is not supported. If the option is set to false (default) the key/value is simply ignored.

The default value for p:xsl-formatter's option content-type is "application/pdf". For compatibility reasons, "application/vnd-areatree+xml" can be used to request area tree output.

In option parameters the following key/values are supported:

MorganaXProc-IIIee supports p:css-formatter based on WeasyPrint (currently version 64.1).

t.b.d.

This step converts the image (on port source) to an image (on port result) using the option content-type to indicate the output format.

   |<p:declare-step type="mox:convert-image" xmlns:mox="http://www.xml-project.com/morganaxproc">
   |   <p:input port="source" content-types="any" sequence="false" />
   |   <p:output port="result" content-types="any" sequence="false" />
   |   <p:option name="content-type" as="xs:string?" />
   |   <p:option name="height" as="xs:positiveInteger?" />
   |   <p:option name="width" as="xs:positiveInteger?" />
   |   <p:option name="resolution" as="xs:positiveInteger?" />
   |   <p:option name="parameters" as="map(xs:QName, item()*)?" />
   |   <p:option name="fail-on-warning" as="xs:boolean" select="false()" />
   |</p:declare-step>

The step is based on Apache Commons Imaging. Please see documentation for supported image formats. You can also convert PDF-documents to images based on Apache PDFBox®. Alternatively there is a plugin support to convert with Aspose.Imaging for Java. This software has to be purchased separately and has to be put on the classpath. To make MorganaXProc-IIIee use this connector, add

  |<image-processor>com.xml_project.morganaxproc3.aspose_imaging.AsposeImagingProcessor</image-processor>

to your configuration file or as command line settings.

This step identifies properties of the image presented on port source and returns them on port result.

  |<p:declare-step type="mox:profile-image" xmlns:mox="http://www.xml-project.com/morganaxproc">
  |   <p:input port="source" content-types="any" sequence="false" />
  |   <p:output port="result" content-types="xml json" sequence="false" />
  |   <p:option name="create-xml-result" as="xs:boolean" select="true()" />
  |</p:declare-step>

The value of option create-xml-result controls whether the result document is an XML-document (default) or a JSON-document.

This step lines in with the text-steps defined in XProc 3.1's standard library. It takes the lines in the text document on port source and wraps each line with an XML element. The element's name can be choosen using option wrapper. Additionally the element can take an attribute whose value reflects the line number in the source document. To turn this off, set option number to false(). By default the attribute is named "no". With option attribute-name one can control the used attribute-name.

  |<p:declare-step type="mox:text-wrap-lines" xmlns:mox="http://www.xml-project.com/morganaxproc">
  |   <p:input port="source" content-types="text" sequence="false" />
  |   <p:output port="result" content-types="xml" sequence="true" />
  |   <p:option name="wrapper" as="xs:QName" select="'line'" />
  |   <p:option name="number" as="xs:boolean" select="true()" />
  |   <p:option name="attribute-name" as="xs:QName" select="'no'" />
  |</p:declare-step>

This function evaluates a dynamically created XPath expression. If the context is not empty, the node is taken as context item, otherwise the context item is absent. The XPath expression may use variables. The values for the variables can be provided via map variables".

  |declare function mox:evaluate-xpath(xpath as xs:string, 
  |  context as node()?, 
  |  variables as map(xs:string, xs:item()) as xs:item() external;

The function mox:get-connector-info provides information about a used connector.

  |declare function mox:get-connector-info(connectorname as xs:string) 
  |  as map(xs:string, xs:string) external;

For the parameter "xslt-connector" it will return information about the used XSLT processor including information about the used licence. If the connection name is not recognized or if no information can be obtained, an empty map will be returned. If it is recognized, the keys and values of the resulting map depend on the underlying XSLT processor and many vary from version to version.

Tests whether the provided item is a well-formed document.

  |declare function mox:is-well-formed-document(par as item()) 
  |  as xs:boolean external;

Returns true, if the parameter is a well-formed XML document, i.e. has exactly one document node, preceded and/or followed by comments, PIs and empty text nodes.

This function returns a map of all known system properties with their respective values. If no value is set for a property, an empty string ("") is returned. The list of system properties contains all required keys (as specified for XProc 3.1) as well as keys reflecting the current configuration of MorganaXProc-III. This includes the used XSLT-Connector (mox:xslt-connector()) etc.

  |declare function mox:system-properties() 
  |  as map(xs:QName,item()*) external;