Change 12716
Initial checkin of infrastructure to process DocBook XML into WebHelp
format.
The purpose of this change is to lay the groundwork that will allow all
published Perforce documentation to be converted to HTML (and
eventually PDF and other formats) in a consistent manner, independent
of tools, and eventually allow for automated documentation builds.
The latest versions of DocBook (1.78.1), Saxon (6.5.5), Xalan-J (2.7.1),
and XSLTHL (2.1.0) are included, as well as generic customization
capability and per-guide customizations. More work needs to be done
to the customization layers to fully support their use from an XML
authoring tool, such as oXygen, which will appear in a future change.
Note: This change only includes configuration to build WebHelp for the
P4SAG. Further work is required before the infrastructure can be
applied to other guides.
WARNING: For anyone using oXygen to produce WebHelp, there is
a known incompatibility: <imagedata> tags in oXygen are verified
for file existence, and the HTML is subsequently patched to resolve
to the output directory. The non-oXygen WebHelp generation does
not include the patch operation, so images are broken. The
<imagedata> can be updated to indicate the relative path in the
output directory, but then the oXygen transformation will fail. This
will be fixed in a future change.
format.
The purpose of this change is to lay the groundwork that will allow all
published Perforce documentation to be converted to HTML (and
eventually PDF and other formats) in a consistent manner, independent
of tools, and eventually allow for automated documentation builds.
The latest versions of DocBook (1.78.1), Saxon (6.5.5), Xalan-J (2.7.1),
and XSLTHL (2.1.0) are included, as well as generic customization
capability and per-guide customizations. More work needs to be done
to the customization layers to fully support their use from an XML
authoring tool, such as oXygen, which will appear in a future change.
Note: This change only includes configuration to build WebHelp for the
P4SAG. Further work is required before the infrastructure can be
applied to other guides.
WARNING: For anyone using oXygen to produce WebHelp, there is
a known incompatibility: <imagedata> tags in oXygen are verified
for file existence, and the HTML is subsequently patched to resolve
to the output directory. The non-oXygen WebHelp generation does
not include the patch operation, so images are broken. The
<imagedata> can be updated to indicate the relative path in the
output directory, but then the oXygen transformation will fail. This
will be fixed in a future change.
Snip (> 1,000 files)
Tip: Use n and p to cycle through the changes.