mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-09-12 22:37:52 +02:00
The stylesheets used for the HTML documentation rendered on postgresql.org have shifted, and no longer matched what was expected by "make STYLE=website html" builds performed locally. Local doc builds did not reflect other aspects of the website, including font and margins. This patch updates the references to use the current set of stylesheets that are used by the documentation on postgresql.org. This also wraps the documentation preview in a HTML container so it can keep the content within similar margins to those found on the website. The documentation on building the docs is updated to reflect this change, and to let the documentation builder know that an external network connection is required to properly preview documentation built with "make STYLE=website html" (which was true prior to this patch too, but not mentioned). Author: Jonathan Katz Reported-By: Tom Lane Discussion: https://postgr.es/m/1375.1581446233@sss.pgh.pa.us
180 lines
7.2 KiB
XML
180 lines
7.2 KiB
XML
<?xml version='1.0'?>
|
|
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version='1.0'
|
|
xmlns="http://www.w3.org/TR/xhtml1/transitional"
|
|
exclude-result-prefixes="#default">
|
|
|
|
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/>
|
|
<xsl:include href="stylesheet-common.xsl" />
|
|
<xsl:include href="stylesheet-html-common.xsl" />
|
|
<xsl:include href="stylesheet-speedup-xhtml.xsl" />
|
|
|
|
|
|
<!-- Parameters -->
|
|
<xsl:param name="base.dir" select="'html/'"></xsl:param>
|
|
<xsl:param name="use.id.as.filename" select="'1'"></xsl:param>
|
|
<xsl:param name="generate.legalnotice.link" select="1"></xsl:param>
|
|
<xsl:param name="chunk.first.sections" select="1"/>
|
|
<xsl:param name="chunk.quietly" select="1"></xsl:param>
|
|
<xsl:param name="admon.style"></xsl:param> <!-- handled by CSS stylesheet -->
|
|
|
|
<xsl:param name="website.stylesheet" select="0"/>
|
|
|
|
<xsl:param name="html.stylesheet">
|
|
<xsl:choose>
|
|
<xsl:when test="$website.stylesheet = 0">stylesheet.css</xsl:when>
|
|
<xsl:otherwise>
|
|
https://www.postgresql.org/media/css/fontawesome.css
|
|
https://www.postgresql.org/media/css/bootstrap.min.css
|
|
https://www.postgresql.org/media/css/main.css
|
|
https://www.postgresql.org/media/css/normalize.css
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:param>
|
|
|
|
|
|
<!-- strip directory name from image filerefs -->
|
|
<xsl:template match="imagedata/@fileref">
|
|
<xsl:value-of select="substring-after(., '/')"/>
|
|
</xsl:template>
|
|
|
|
|
|
<!--
|
|
Customization of header
|
|
- add Up and Home links
|
|
- add tool tips to links
|
|
|
|
(overrides html/chunk-common.xsl)
|
|
-->
|
|
<xsl:template name="header.navigation">
|
|
<xsl:param name="prev" select="/foo"/>
|
|
<xsl:param name="next" select="/foo"/>
|
|
<xsl:param name="nav.context"/>
|
|
|
|
<xsl:variable name="home" select="/*[1]"/>
|
|
<xsl:variable name="up" select="parent::*"/>
|
|
|
|
<xsl:variable name="row1" select="$navig.showtitles != 0"/>
|
|
<xsl:variable name="row2" select="count($prev) > 0
|
|
or (count($up) > 0
|
|
and generate-id($up) != generate-id($home)
|
|
and $navig.showtitles != 0)
|
|
or count($next) > 0"/>
|
|
|
|
<xsl:if test="$suppress.navigation = '0' and $suppress.header.navigation = '0'">
|
|
<div class="navheader">
|
|
<xsl:if test="$row1 or $row2">
|
|
<table width="100%" summary="Navigation header">
|
|
<xsl:if test="$row1">
|
|
<tr>
|
|
<th colspan="5" align="center">
|
|
<xsl:apply-templates select="." mode="object.title.markup"/>
|
|
</th>
|
|
</tr>
|
|
</xsl:if>
|
|
|
|
<xsl:if test="$row2">
|
|
<tr>
|
|
<td width="10%" align="{$direction.align.start}">
|
|
<xsl:if test="count($prev)>0">
|
|
<a accesskey="p">
|
|
<xsl:attribute name="href">
|
|
<xsl:call-template name="href.target">
|
|
<xsl:with-param name="object" select="$prev"/>
|
|
</xsl:call-template>
|
|
</xsl:attribute>
|
|
<xsl:attribute name="title">
|
|
<xsl:apply-templates select="$prev" mode="object.title.markup"/>
|
|
</xsl:attribute>
|
|
<xsl:call-template name="navig.content">
|
|
<xsl:with-param name="direction" select="'prev'"/>
|
|
</xsl:call-template>
|
|
</a>
|
|
</xsl:if>
|
|
<xsl:text> </xsl:text>
|
|
</td>
|
|
<td width="10%" align="{$direction.align.start}">
|
|
<xsl:choose>
|
|
<xsl:when test="count($up)>0
|
|
and generate-id($up) != generate-id($home)">
|
|
<a accesskey="u">
|
|
<xsl:attribute name="href">
|
|
<xsl:call-template name="href.target">
|
|
<xsl:with-param name="object" select="$up"/>
|
|
</xsl:call-template>
|
|
</xsl:attribute>
|
|
<xsl:attribute name="title">
|
|
<xsl:apply-templates select="$up" mode="object.title.markup"/>
|
|
</xsl:attribute>
|
|
<xsl:call-template name="navig.content">
|
|
<xsl:with-param name="direction" select="'up'"/>
|
|
</xsl:call-template>
|
|
</a>
|
|
</xsl:when>
|
|
<xsl:otherwise> </xsl:otherwise>
|
|
</xsl:choose>
|
|
</td>
|
|
<th width="60%" align="center">
|
|
<xsl:choose>
|
|
<xsl:when test="count($up) > 0
|
|
and generate-id($up) != generate-id($home)
|
|
and $navig.showtitles != 0">
|
|
<xsl:apply-templates select="$up" mode="object.title.markup"/>
|
|
</xsl:when>
|
|
<xsl:otherwise> </xsl:otherwise>
|
|
</xsl:choose>
|
|
</th>
|
|
<td width="10%" align="{$direction.align.end}">
|
|
<xsl:choose>
|
|
<xsl:when test="$home != . or $nav.context = 'toc'">
|
|
<a accesskey="h">
|
|
<xsl:attribute name="href">
|
|
<xsl:call-template name="href.target">
|
|
<xsl:with-param name="object" select="$home"/>
|
|
</xsl:call-template>
|
|
</xsl:attribute>
|
|
<xsl:attribute name="title">
|
|
<xsl:apply-templates select="$home" mode="object.title.markup"/>
|
|
</xsl:attribute>
|
|
<xsl:call-template name="navig.content">
|
|
<xsl:with-param name="direction" select="'home'"/>
|
|
</xsl:call-template>
|
|
</a>
|
|
<xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'">
|
|
<xsl:text> | </xsl:text>
|
|
</xsl:if>
|
|
</xsl:when>
|
|
<xsl:otherwise> </xsl:otherwise>
|
|
</xsl:choose>
|
|
</td>
|
|
<td width="10%" align="{$direction.align.end}">
|
|
<xsl:text> </xsl:text>
|
|
<xsl:if test="count($next)>0">
|
|
<a accesskey="n">
|
|
<xsl:attribute name="href">
|
|
<xsl:call-template name="href.target">
|
|
<xsl:with-param name="object" select="$next"/>
|
|
</xsl:call-template>
|
|
</xsl:attribute>
|
|
<xsl:attribute name="title">
|
|
<xsl:apply-templates select="$next" mode="object.title.markup"/>
|
|
</xsl:attribute>
|
|
<xsl:call-template name="navig.content">
|
|
<xsl:with-param name="direction" select="'next'"/>
|
|
</xsl:call-template>
|
|
</a>
|
|
</xsl:if>
|
|
</td>
|
|
</tr>
|
|
</xsl:if>
|
|
</table>
|
|
</xsl:if>
|
|
<xsl:if test="$header.rule != 0">
|
|
<hr/>
|
|
</xsl:if>
|
|
</div>
|
|
</xsl:if>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|