2.0 stylesheets and complexity

dita message

Subject: 2.0 stylesheets and complexity

From: Bob Thomas <bob.thomas@tagsmiths.com>

To: dita <dita@lists.oasis-open.org>

Date: Thu, 1 Nov 2018 22:31:27 -0600

Hi,

I've been thinking about the quagmire of complexity that I got into with the 1.3 stylesheet cover pages. My design goal was to be able to create artifacts with the correct filenames, and then to combine those outputs into a .zip archive that contained all of the artifacts in their correct places. This involved processing the information out of the DITA markup and bringing it back into ant through an xmlproperty file. This spun out of control because of the rules for determining the URIs. Paul Knight did a good job of describing how the names areÂderived various nodes in the URIs, but ultimatelyÂit became too complicated to generate reliabilityÂwithout having a deep understanding of the component pieces and when to use them.

Perhaps the xmlproperty file idea would work better in the other direction. Namely, put the URIs and filenames in an xmlpropertyÂfile so that they can be used in ant and then brought into the XSLT stylesheet as transformation parameters. The only information that would be brought in through the xmlpropertyÂfile would be URIs and filenames that vary from version to version. The rest of the cover metadata could be handled with keys.

I have attached a prototypeÂxmlpropertyÂfile and a transform parameter file to show what I have in mind.

Best regards,

Bob

Bob Thomas

+1 720 201 8260

Skype: bob.thomas.colorado

Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype

Time zone: Mountain (GMT-7)

<?xml version="1.0" encoding="UTF-8"?> <parameters> <param name="uris.thisversion.baseuri" expression="${uris.thisversion.baseuri}" if="uris.thisversion.baseuri"/> <param name="uris.thisversion.html" expression="${uris.thisversion.html}" if="uris.thisversion.html"/> <param name="uris.thisversion.pdf" expression="${uris.thisversion.pdf}" if="uris.thisversion.pdf"/> <param name="uris.previousversion.baseuri" expression="${uris.previousversion.baseuri}" if="uris.previousversion.baseuri"/> <param name="uris.previousversion.html" expression="${uris.previousversion.html}" if="uris.previousversion.html"/> <param name="uris.previousversion.pdf" expression="${uris.previousversion.pdf}" if="uris.previousversion.pdf"/> <param name="uris.latestversion.baseuri" expression="${uris.latestversion.baseuri}" if="uris.latestversion.baseuri"/> <param name="uris.latestversion.html" expression="${uris.latestversion.html}" if="uris.latestversion.html"/> <param name="uris.latestversion.pdf" expression="${uris.latestversion.pdf}" if="uris.latestversion.pdf"/> <param name="uris.additionalartifacts.chm" expression="${uris.additionalartifacts.chm}" if="uris.additionalartifacts.chm"/> <param name="uris.additionalartifacts.htmlzip" expression="${uris.additionalartifacts.htmlzip}" if="uris.additionalartifacts.htmlzip"/> <param name="uris.additionalartifacts.grammars" expression="${uris.additionalartifacts.grammars}" if="uris.additionalartifacts.grammars"/> <param name="uris.additionalartifacts.ditasource" expression="${uris.additionalartifacts.ditasource}" if="uris.additionalartifacts.ditasource"/> </parameters>

<?xml version="1.0" encoding="UTF-8"?> <uris> <thisversion> <baseuri>https://docs.oasis-open.org/dita/dita/v2.0/csprd01/</baseuri> <html>dita-v2.0-csprd01.html</html> <pdf>dita-v2.0-csprd01.pdf</pdf> </thisversion> <previousversion> <baseuri>N/A</baseuri> <html>N/A</html> <pdf>N/A</pdf> </previousversion> <latestversion> <baseuri>https://docs.oasis-open.org/dita/dita/v2.0/</baseuri> <html>dita-v2.0.html</html> <pdf>dita-v2.0.pdf</pdf> </latestversion> <additionalartifacts>  <chm>dita-v2.0-chm.zip</chm> <htmlzip>dita-v2.0-html.zip</htmlzip> <grammars>dita-v2.0-grammars.zip</grammars> <ditasource>dita-v2.0-dita.zip</ditasource> </additionalartifacts> </uris>

Follow-Ups:

Re: 2.0 stylesheets and complexity
- From: Bob Thomas <bob.thomas@tagsmiths.com>