Update Transclusion Page on docbook.org

[tomschr]

Situation

When opening the Transclusion page on docbook.org, clicking the "Transclusion" link points to https://docbook.org/docs/transclusion/transclusion.html. This page is dated 20 April 2011 and describes the old way of doing transclusions.

However, Jirka updated the text on the thread in 09/2014 on the docbook mailinglist. It showed the more recent way of doing transclusion on top of XInclude 1.1.

Proposed Solution

We shouldn't point nor recommend outdated documents. As such, I'd suggest to copy the HTML page from the docbook mailinglist to docbook.org (unless there is an even better way). 😉

Can be done probably in seconds. 😉

[ndw]

Seems sensible to me. I'm traveling today, but I'll try to resolve this over the weekend. Thanks!

[kosek]

Hmm, seems it will take some time to find sources :-(

In the worst case there is internet archive:

http://web.archive.org/web/20150912042246/https://docbook.org/docs/transclusion/2015-01-08/

http://web.archive.org/web/20150911101053/http://docbook.org/docs/transclusion/2015-01-08/transclusion.xml

[kosek]

Aha, mystery solved. For some reason these files are in older SVN repo:

https://sourceforge.net/p/docbook/code/HEAD/tree/trunk/docbook/relaxng/docbook/transclusion/

I don't know why files ended up there. @ndw will you republish from this XML source (or perhaps it will be automatic thanks to CI) or should I do it?

[ndw]

Ok. I've updated docbook.org. The new version doesn't have exactly the same style, but at least it has the right content!

[kosek]

Thanks Norm. I have assigned myself and reopened so I can fix stylesheet -- different style doesn't matter but it would be good to resurrect metadata section with links to previous version. Not high priority.