OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: 2.0 stylesheets and complexity


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 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"?>
  <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"/>
<?xml version="1.0" encoding="UTF-8"?>
    <!--<baseuri>[use /uris/thisversion/baseuri]</baseuri>-->

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]