[DOCS] Docbook 5.x

[Peter Eisentraut]

We maintain two css files: docs.css (for online, complex) and
stylesheet.css (local, simple). Why do we need stylesheet.css?

So you can read the documentation locally without referencing online files.

[Alexander Law]

Hello Peter,

Thanks for improvements!
I checked outputs (with the attached script) and found that there is
small difference with the improved patch.
For example, look at xtypes.html:

- <link rel="home" href="index.html" title="PostgreSQL 9.6beta1
Documentation" /><link rel="up" href="extend.html"
title="Chapter 35. Extending SQL" /><link rel="prev" href="xaggr.html"
title="35.10. User-defined Aggregates" /><link rel="next"
href="xoper.html" title="35.12. User-defined Operators" /><link
rel="copyright" href="legalnotice.html" title="Legal Notice" /></head>

+ <link rel="prev" href="xaggr.html" title="35.10. User-defined
Aggregates" /><link rel="next" href="xoper.html"
title="35.12. User-defined Operators" /></head>

It caused by <xsl:template name="html.head">.
Leaving aside the question whether the links "home", "up" and
"copyright" are needed, maybe it's better to split the commit to two?
First to speed up the conversion while making sure that the output is
the same, and the second to change the html.head output format.

Best regards,
Alexander

Done (previous patch cleaned).
This patch optimizes XSL transformations contained in docbook-xsl
(1.78.1).

I have looked through this patch, and it's awesome. I have tweaked it
a bit more along the lines you guys have started, and now the build
time is pretty much the same as with DSSSL. Attached is my final
patch, which I plan to commit as soon as the new branch opens.
(I only have Alexander Lakhin as credit right now. Please let me know
if anyone else contributed.)

[Peter Eisentraut]

Post by Alexander Law
It caused by <xsl:template name="html.head">.
Leaving aside the question whether the links "home", "up" and
"copyright" are needed, maybe it's better to split the commit to two?
First to speed up the conversion while making sure that the output is
the same, and the second to change the html.head output format.

I did that intentionally, but I agree that it might be better to split
this off into a separate commit.

[Alexander Law]

Hello Peter,

In that case can we postpone the second commit until step 3 in your plan
of migration to XML is done?
I mean "- Port all DSSSL customizations to XSLT. Manually evaluate
output for quality. ";
If we will not change contents/formatting until migration to xslt is
done, we can ensure that output is the same by automatic means.
(See my letter:
https://www.postgresql.org/message-id/56337365.2080104%40postgrespro.ru)

Best regards,
Alexander

Post by Peter Eisentraut

Post by Alexander Law
It caused by <xsl:template name="html.head">.
Leaving aside the question whether the links "home", "up" and
"copyright" are needed, maybe it's better to split the commit to two?
First to speed up the conversion while making sure that the output is
the same, and the second to change the html.head output format.

I did that intentionally, but I agree that it might be better to split
this off into a separate commit.

[Peter Eisentraut]

Post by Alexander Law
In that case can we postpone the second commit until step 3 in your plan
of migration to XML is done?
I mean "- Port all DSSSL customizations to XSLT. Manually evaluate
output for quality. ";

It is part of the performance work.