Michael Smith [Mon, 16 Jul 2007 16:14:36 +0000 (16:14 +0000)]
Don't prepend "template." to IDs for embedded doc for PIs. (cause
of this was a copy/paste error -- the template for processing
embedded PI documentation began life as a copy of the template for
processing embeded doc for templates)
Michael Smith [Sat, 14 Jul 2007 19:58:59 +0000 (19:58 +0000)]
Changed handling of reference auto-labeling such that reference
(when it appears at the component level) is now affected by the
label.from.part param, just as preface, chapter, and appendix.
Michael Smith [Thu, 12 Jul 2007 03:14:49 +0000 (03:14 +0000)]
Adjusted xsl2jref to copy over any attributes on source
doc:reference instances (primarily embedded doc for params) and to
also copy any PIs that are children of doc:reference.
That ensures that any id/xml:id attributes get copied over -- so
that they can be used when use.id.as.filename is on -- and that
any dbhtml@dir and dbhtml@filename PIs can be used for moving
files into the correct subdirs and are output with right names.
Michael Smith [Thu, 12 Jul 2007 03:09:21 +0000 (03:09 +0000)]
Updated stylesheet customization layers used for doc build,
including disabling extensions during doc build to prevent "Failed
to load image page.png" error messages.
Added code for generating id attributes on callouts in HTML and FO output.
These patches enable cross-references to callouts placed by area coordinates.
It works for graphic, unicode and text callouts.
Part of fix for bug #1675513 (xref to area broken).
Michael Smith [Wed, 11 Jul 2007 01:54:53 +0000 (01:54 +0000)]
Pass noent option to xmllint so that it doesn't do whatever stupid
stuff with named entities that it seems to be trying to do for
god knows what reason.
Michael Smith [Sun, 8 Jul 2007 20:29:54 +0000 (20:29 +0000)]
Set updated ignore properties and adjusted for fact that shared
makefile now expects a "PARAMBASE" value to be specified (to
indicate base filename for the type of content being built: either
PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
redundancy in the lib build, and just have it use the same
makefile "infrastructure" as the param builds for all the
param.xsl files. The reason for that is, lib use the same *.xweb
system for embedding documentation that the builds for the various
output formats use (as opposed to the jrefentry-based system that
used for building the template and PI docs in common etc.
Michael Smith [Fri, 6 Jul 2007 16:23:33 +0000 (16:23 +0000)]
Added an FO_BUILDER make variable, set to saxon by default.
Because xsltproc performance seems to go waaay south on large
files, so let's build the FO output for the docs using saxon
instead (which is much much quicker on this file)
Michael Smith [Thu, 5 Jul 2007 15:13:03 +0000 (15:13 +0000)]
Completing adding all doc for HTML PIs. Added "see also" sections
with links to related global params, plus links to DocBook XSL: TCG
Also tried out adding some additional doc to param doc for the
textinsert.extension param that back-references the PI
documentation, plus added some TCG links there too.
Michael Smith [Wed, 4 Jul 2007 12:46:32 +0000 (12:46 +0000)]
Add x-ref links from embedded PI doc to sections in Bob's book.
Also, moved dbhtml-dir template to chunk-common.xsl file, because
it doesn't really belong in the PI file.
Michael Smith [Wed, 4 Jul 2007 11:41:04 +0000 (11:41 +0000)]
Consolidated all PIs for HTML table stuff into wrapper templates
in the "master" pi list (html/pi.xsl) and added embedded doc for
all of them. May have made some flubs in copying over, so this
change may break some table handling.
Michael Smith [Wed, 4 Jul 2007 10:17:17 +0000 (10:17 +0000)]
Consolidated all PIs for HTML synopsis and verbatim stuff into
wrapper templates in the "master" pi list (html/pi.xsl) and added
embedded doc for all of them. May have made some flubs in copying
over, so this change may break some synopsis and verbatim
handling. Note: Also added refsee@role=params instances so that we
can link to the corresponding global params (if any) for each PI.
Michael Smith [Wed, 4 Jul 2007 08:41:53 +0000 (08:41 +0000)]
Consolidated all PIs for qandaset into wrapper templates in one
place (html/pi.xsl) and added embedded doc for all of them. May
have made some flubs in copying over, so this change may break
some qandaset handling.
Michael Smith [Wed, 4 Jul 2007 06:06:53 +0000 (06:06 +0000)]
Consolidated all PIs for graphics and lists into wrapper templates
in one place (html/pi.xsl) and added embedded doc for all of them.
May have made some flubs in copying over, so this change may break
some graphics and list handling.
Michael Smith [Wed, 4 Jul 2007 01:30:15 +0000 (01:30 +0000)]
Made the following changed in the mode="hyphenate.verbatim" template:
- <xsl:apply-templates select="node()|@*" mode="hyphenate.verbatim"/>
+ <xsl:copy-of select="@*"/>
+ <xsl:apply-templates mode="hyphenate.verbatim"/>
...because as was it caused xsltproc to raise a fatal "Attribute
nodes must be added before any child nodes to an element." (though
not saxon)
Michael Smith [Tue, 3 Jul 2007 11:48:38 +0000 (11:48 +0000)]
Consolidated processing of all FO PIs into wrapper templates in
one place (the fo/pi.xsl file) and added embedded documentation
for all of them. This makes it possible to now include generated
documentation for the PIs in the output docs. Next stop: HTML PIs,
then on to the common ones...
This touched a lot of files and it is likely that I made some
mistakes in moving the PI processing over. Meaning that some PIs
might quit working or not work as expected after this change. So
it will need to tested. Which is why we do dot-zero releases...