Thanks so much for posting this. I believe your summary is
accurate.
OASIS essentially wants arbitrary line break control in the
title. I'm not sure how to accomplish this without using markup
hacks. Alternatively, we could integrate the DITA for Publishers
formatting domain (which provides a specialized <br>
element type) or create a simple domain that integrates a
<br> specialization. Or continue to insert a linebreak in
the PDF (cringe).
Hi, folks.
We had to make some last minute changes to the HTML and PDF
for the committee note. Alan and I worked on this, and I want
to make sure that we capture what we had to do so that we can
make changes to the style sheets.
Here's what I can remember; Alan, can you add to this also?
These are the items that are related to the style sheets:
- PDF: Modify footers to change the file name. Remove the
stage name from above the copyright notice. (Major kudos to
Alan for working magic in Adobe Acrobat, even so far as to
install a Microsoft font on his system.
- PDF: Change the title to "Committee Note Draft 01 / Public
Review Draft 01". From Paul Knight:"The only tricky part is
that on the main front page subtitle, the string breaks
(line break) after the "/", while in the Citation format,
there is no break, just a space.
From an editorial perspective, OASIS requested the following
changes:
<from OASIS>
(c) Please use "N/A" instead of the words "Not applicable"
in "Previous version", to match OASIS style.
(d) (not a template issue) - the phrase "(this document)"
wasn't appropriate in the list of "Related work"
(e) incorrect file name in page footers (PDF only) - it
was set as "dita-LwDITA-lwdita-v1.0-cn01" instead of the
actual file name - "LwDITA-v1.0-cn01" (Note it will be
"cnprd01" for the Public Review)
(f) in PDF footers - The stage name should not be placed
above the copyright notice. (For the PR stage, it may not
even fit - ""Committee Note Draft 01 / Public Review Draft
01").
(g) missing "OASIS" before "Committee Note 01" in Citation
format. (Note that "OASIS" should appear in the "Citation
format"*, but is NOT added in the top subtitle.
</from OASIS>
Things that are probably a DITA-OT issue:
<from OASIS>
We also noted some strange issues with the HTML code
(visible in text editor), which we modified (so they are not
in the published version):
- the following three tags are each repeated about 109
times in the <head>:
<meta name="prodname" content="" />
<meta name="version" content="LwDITA" />
<meta name="DC.Creator" content="OASIS DITA Technical
Committee" />
Maybe something in your machinery is inserting these tags
each time the files are edited - ??
- several (7 or 8) of the Front Matter links have double
hyperlinks - like:
<a class="xref no-italics" href=""http://docs.oasis-open" moz-do-not-send="true">http://docs.oasis-open.
org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.html"
target="_blank">
<a href=""http://docs.oasis-open"
moz-do-not-send="true">http://docs.oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.html"
target="_blank">
<span class="keyword">
http://docs.
oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.html</span></a></a>
(Authoritative)
Also, due to the <title> tag, the display in a
browser window tab shows the document name as
"Specification URIs".
<title>Specification URIs</title>
(changed to <title>Lightweight DITA: An
Introduction</title>)
<from OASIS>
I simply modified the HTML manually.
--
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)