docbook-apps

Good morning (well, in this locale anyway),

I set out to implement DocBook Transclusion in the DocBook xslTNG
Stylesheets the other day and discovered that a previous attempt to
implement it was already in place.

It appears to have been an attempt to implement the previous draft of
DocBook Transclusion, not the most recent[1], and I don’t believe it
works.

If you’re using DocBook Transclusion with the DocBook xslTNG Stylesheets
and you think it’s doing something useful, please let me know.

I plan to revamp it completely in the next release. I’d be worried about
doing a backwards incompatible change except, as I said, I don’t think
the current implementation does anything remotely useful.

Be seeing you,
norm

[1] https://docbook.org/docs/transclusion/transclusion.html

--
Norman Tovey-Walsh <ndw@nwalsh.com>
https://nwalsh.com/

> Do not seek to follow in the footsteps of men of old; seek what they
> sought.--Matsuo Basho

from your [1] https://docbook.org/docs/transclusion/transclusion.html
https://docbook.org/docs/transclusion-requirements/ is 404 Norm?

Should it be the 2010 version?
https://docbook.org/docs/transclusion-requirements/transclusion-requirements.html

regards

On Tue, 11 May 2021 at 10:16, Norm Tovey-Walsh <ndw@nwalsh.com> wrote:
>
> Good morning (well, in this locale anyway),
>
> I set out to implement DocBook Transclusion in the DocBook xslTNG
> Stylesheets the other day and discovered that a previous attempt to
> implement it was already in place.
>
> It appears to have been an attempt to implement the previous draft of
> DocBook Transclusion, not the most recent[1], and I don’t believe it
> works.
>
> If you’re using DocBook Transclusion with the DocBook xslTNG Stylesheets
> and you think it’s doing something useful, please let me know.
>
> I plan to revamp it completely in the next release. I’d be worried about
> doing a backwards incompatible change except, as I said, I don’t think
> the current implementation does anything remotely useful.
>
> Be seeing you,
> norm
>
> [1] https://docbook.org/docs/transclusion/transclusion.html
>
> --
> Norman Tovey-Walsh <ndw@nwalsh.com>
> https://nwalsh.com/
>
> > Do not seek to follow in the footsteps of men of old; seek what they
> > sought.--Matsuo Basho



--
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.

Dave Pawson <dave.pawson@gmail.com> writes:

> from your [1] https://docbook.org/docs/transclusion/transclusion.html
> https://docbook.org/docs/transclusion-requirements/ is 404 Norm?
>
> Should it be the 2010 version?
> https://docbook.org/docs/transclusion-requirements/transclusion-requirements.html

I think so. Both those documents need another cleanup and formatting
pass. I’ll try to get to that.

Be seeing you,
norm

--
Norman Tovey-Walsh <ndw@nwalsh.com>
https://nwalsh.com/

> Time makes more converts than reason.--Tom Paine

And (for some), in either requirement or defn, add a defn of
transclusion please.

transclusion is the inclusion of part or all of an electronic document
into one or more other documents by hypertext reference. Transclusion
is usually performed when the referencing document is displayed, and
is normally automatic and transparent to the end user.[1] The result
of transclusion is a single integrated document made of parts
assembled dynamically from separate sources, possibly stored on
different computers in disparate places.

src: Wikipedia

On Tue, 11 May 2021 at 11:05, Norm Tovey-Walsh <ndw@nwalsh.com> wrote:
>
> Dave Pawson <dave.pawson@gmail.com> writes:
>
> > from your [1] https://docbook.org/docs/transclusion/transclusion.html
> > https://docbook.org/docs/transclusion-requirements/ is 404 Norm?
> >
> > Should it be the 2010 version?
> > https://docbook.org/docs/transclusion-requirements/transclusion-requirements.html
>
> I think so. Both those documents need another cleanup and formatting
> pass. I’ll try to get to that.
>
> Be seeing you,
> norm
>
> --
> Norman Tovey-Walsh <ndw@nwalsh.com>
> https://nwalsh.com/
>
> > Time makes more converts than reason.--Tom Paine



--
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.

Dave Pawson <dave.pawson@gmail.com> writes:
> And (for some), in either requirement or defn, add a defn of
> transclusion please.

Yup.

On 11.5.2021 11:16, Norm Tovey-Walsh wrote:
> It appears to have been an attempt to implement the previous draft of
> DocBook Transclusion, not the most recent[1], and I don’t believe it
> works.

Yep, it seems that the XSLT code wasn't updated to the latest
translusions draft that is based on XInclude 1.1. As a namespace changed
between drafts the most recent XSLT code isn't doing anything. But XSLT
transformation at the end of DocBook Transclusion document should be
doing right thing so using it as an almost drop-in replacement could do
the trick.

> I plan to revamp it completely in the next release. I’d be worried about
> doing a backwards incompatible change except, as I said, I don’t think
> the current implementation does anything remotely useful.

I have one customer who uses original proposal with DocBook 4.3 and XSLT
1.0 stylesheets -- they will not be affected by any change for
foreseable future ;-)

--
------------------------------------------------------------------
Jirka Kosek e-mail: jirka@kosek.cz http://xmlguru.cz
------------------------------------------------------------------
Professional XML and Web consulting and training services
DocBook/DITA customization, custom XSLT/XSL-FO document processing
------------------------------------------------------------------
Bringing you XML Prague conference http://xmlprague.cz
------------------------------------------------------------------