search

docbook / docbook.org

Sources for http://docbook.org/
11 stars 7 forks source link

Update Transclusion Page on docbook.org #40

Open tomschr opened 4 years ago

tomschr commented 4 years ago

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). :wink:

Can be done probably in seconds. :wink:

ndw commented 4 years ago

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

kosek commented 4 years ago

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 commented 4 years ago

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 commented 4 years ago

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 commented 4 years ago

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.