Added modifications so that the new callout.icon.size parameter is taken into account. This
parameter is used for FO output (where SVG now is the default graphics format for callouts).
Michael Smith [Thu, 19 Jul 2007 07:17:45 +0000 (07:17 +0000)]
Fixed a bug that caused broken links in some TOCs.
This change affects the code for generating links in HTML output.
It adds a new optional "toc.context" parameter to the href.target
template, and based on the value of that parameter, handles
link-generation in TOCs differently under a certain condition.
The gory details:
The code now checks to see if the output dir of any file being
linked to in a particular TOC is different from the output dir
the TOC is written to. If it is different, we do not call the
trim.common.uri.paths[1] template.
The reason is that, given the following case:
1. we are chunking into separate dirs
2. output for the TOC is written to current dir, but the file
being linked to is written to some subdir "foo".
For that case, links to that file in that TOC did not show
the correct path - they omitted the "foo".
The cause of that problem was that the trim.common.uri.paths
template was being called under all conditions. But it's
apparent that we don't want to call trim.common.uri.paths in
the case where a linked file is being written to a different
directory than the TOC that contains the link, because doing
so will cause a necessary (not redundant) directory-name
part of the link to get inadvertently trimmed, resulting in
a broken link to that file.
Thus, the conditional check was added to catch this case and to
handle it differently
[1] The purpose of the trim.common.uri.paths template is to
prevent cases where, if we didn't call it, we end up with
unnecessary, redundant directory names getting output; for
example, "foo/foo/refname.html".
Michael Smith [Tue, 17 Jul 2007 16:14:37 +0000 (16:14 +0000)]
Changed handling of titles for note, warning, caution, important,
tip admonitions: We now output and HTML h3 head only if
admon.textlabel is non-zero or if the admonition actually contains
a title; otherwise, we don't output an h3 head at all.
(Previously, we were outputting an empty h3 if the admon.textlabel
was zero and if the admonition had no title.)
Michael Smith [Tue, 17 Jul 2007 15:10:25 +0000 (15:10 +0000)]
Removed obsoleted lrefentry, clrefentry, and jrefhtml stylesheets.
All HTML output is now generated using the reference.xsl
stylesheet (and the build now converts jref content to standard
DocBook content before generating HTML).
Michael Smith [Tue, 17 Jul 2007 15:06:54 +0000 (15:06 +0000)]
Removed cldocbook.xsl and ldocbook.xsl litprog convenience copies
from the releasetools build; they are not used by the docbook-xsl
build, so no point in keeping them.
Michael Smith [Tue, 17 Jul 2007 14:16:02 +0000 (14:16 +0000)]
Make the reference.xsl stylesheet (which is used for building the
HTML output of the docs) import the DocBook-element and
docbook-xsl-param auto-hyperlinking stylesheets (which are already
used for adding hyperlinks in the release notes). This makes the
auto-hyperlinking consistent between the systems used for the
release-notes build and for the reference docs.
Michael Smith [Tue, 17 Jul 2007 14:11:59 +0000 (14:11 +0000)]
Don't output prolog in xsl2jref output (no doctype, not public ID,
no system ID). Because otherwise we end up with the output tree
getting populated with implied attributes some of which are no
longer valid in DocBook 5.
Michael Smith [Tue, 17 Jul 2007 05:46:29 +0000 (05:46 +0000)]
Add another build kludge, this one to work around the fact that
xsltproc does schoolmarmish pedantic checking of xml:id values and
doesn't provide any option for preventing it from doing so.
Michael Smith [Tue, 17 Jul 2007 05:44:04 +0000 (05:44 +0000)]
Ignore another build-generated kludge. Yeah, I know it's
ridiculous. If you can come up with a prettier way of doing it,
all of my riches will be yours.
Michael Smith [Tue, 17 Jul 2007 05:07:10 +0000 (05:07 +0000)]
Adding yet another hack to workaround the fact that the DocBook 5
grammar requires @xml:id instead of @id, and xsltproc actually
takes xml:id seriously and checks that it's really a NCName.
Michael Smith [Tue, 17 Jul 2007 03:08:06 +0000 (03:08 +0000)]
Add support for appendix instances containing src:fragref
descendants. This makes it possible to use this grammar to
validate *.xweb instances in the docbook-xsl source.
Michael Smith [Mon, 16 Jul 2007 16:45:33 +0000 (16:45 +0000)]
Reverted addition of tag@role=html markup. It's no longer
necessary, because the doc build now has a smarter way of
distinguishing between DocBook elements marked up with the tag
element, and non-DocBook elements marked up with such.
Michael Smith [Mon, 16 Jul 2007 16:21:00 +0000 (16:21 +0000)]
Added the doc-baseuri param to the stylesheet used for
automatically adding hyperlinks in generated doc for stylesheet
params and in release-notes output.
For output of the param doc, doc-baseuri is set to "../" (relative
path so links point to local files).
For release-note output, doc-baseuri is set to the http: url for
the current version of the docbook-xsl docs (instead of to local
files); reason being that when installed from a downstream
package, the release notes can't point to local files because the
release notes are often installed in a separate place for the docs.
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.