Thread: how to modify the navfooter
Where is the content of the navfooter established?
I would like to make some modifications to this footer, but I am unable to figure out where the source that generates it.
I am building the documentation following the instructions from "Building The Documentation" in Appendix J, currently on 9.6.
I am using the command:
make STYLE=website html
I can see the generated navfooter div section in the output html. I must be missing something, because I cannot find a file in the git branch that includes the class named "navfooter" or or any other words like "Navigation footer", "Next", or "Prev".
I have limited understanding of stylesheets (whether dsl or xsl), but I am hoping that I can make the small modifications needed for our use.
I am also curious about the docFooter div section that appears in the publicly published PostgreSQL documentation pages. It does not appear when I build the docs.
Is there a reason that the copyright does not appear on each page when I do the doc build?
Is there some way to get it included when I do the doc build?
What file is used that contains the format (style?) info for that generated html div section?
I would appreciate any assistance from those in the community that understand something about these footers.
...Rick Swagerman
Richard Swagerman <rswagerman@salesforce.com> writes:
> Where is the content of the navfooter established?
> I would like to make some modifications to this footer, but I am unable to
> figure out where the source that generates it.
It's not in the XML doc sources, for sure. I believe our website wraps
the HTML generated from the XML in some other stuff, but I don't know any
details. If nobody pops up here and answers your question in a reasonable
amount of time, try over at pgsql-www.
regards, tom lane
On Aug 7, 2018, at 6:21 PM, Richard Swagerman <rswagerman@salesforce.com> wrote:Where is the content of the navfooter established?I would like to make some modifications to this footer, but I am unable to figure out where the source that generates it.I am building the documentation following the instructions from "Building The Documentation" in Appendix J, currently on 9.6.I am using the command:make STYLE=website htmlI can see the generated navfooter div section in the output html. I must be missing something, because I cannot find a file in the git branch that includes the class named "navfooter" or or any other words like "Navigation footer", "Next", or "Prev".I have limited understanding of stylesheets (whether dsl or xsl), but I am hoping that I can make the small modifications needed for our use.
I’m not as familiar with the doc builds but it looks like this is available
in the “stylesheet.xsl” file.
I am also curious about the docFooter div section that appears in the publicly published PostgreSQL documentation pages. It does not appear when I build the docs.Is there a reason that the copyright does not appear on each page when I do the doc build?Is there some way to get it included when I do the doc build?What file is used that contains the format (style?) info for that generated html div section?
That is in the pgweb[1] project, i.e. this file[2]. My understanding
is that probably will not be included in the doc build, as there is
content in it that is specific to the website :-)
Attachment
Thank you Tom and Jonathan for your responses.
I am now looking at the stylesheet.xsl from after 9.6, and I do see these lines in the file:
<div class="navheader">
<xsl:if test="$row1 or $row2">
<table width="100%" summary="Navigation header">
The generated html files clearly have a div tag and a table tag that match this. So I can understand what generates the header.
What baffles me is that the generated html files also include these tags at the bottom of each file:
<div class="navfooter"><hr />
<table width="100%" summary="Navigation footer">
I do not see anything in stylesheet.xsl that looks anything like this.
Does anyone know where the "magic incantations" are that generate this navfooter?
...Rick Swagerman
On Tue, Aug 7, 2018 at 6:45 PM, Jonathan S. Katz <jkatz@postgresql.org> wrote:
On Aug 7, 2018, at 6:21 PM, Richard Swagerman <rswagerman@salesforce.com> wrote:Where is the content of the navfooter established?I would like to make some modifications to this footer, but I am unable to figure out where the source that generates it.I am building the documentation following the instructions from "Building The Documentation" in Appendix J, currently on 9.6.I am using the command:make STYLE=website htmlI can see the generated navfooter div section in the output html. I must be missing something, because I cannot find a file in the git branch that includes the class named "navfooter" or or any other words like "Navigation footer", "Next", or "Prev".I have limited understanding of stylesheets (whether dsl or xsl), but I am hoping that I can make the small modifications needed for our use.I’m not as familiar with the doc builds but it looks like this is availablein the “stylesheet.xsl” file.I am also curious about the docFooter div section that appears in the publicly published PostgreSQL documentation pages. It does not appear when I build the docs.Is there a reason that the copyright does not appear on each page when I do the doc build?Is there some way to get it included when I do the doc build?What file is used that contains the format (style?) info for that generated html div section?That is in the pgweb[1] project, i.e. this file[2]. My understandingis that probably will not be included in the doc build, as there iscontent in it that is specific to the website :-)[2] https://git.postgresql.org/gitweb/?p=pgweb.git;a= blob;f=templates/docs/ docspage.html;
On 14/08/2018 23:56, Richard Swagerman wrote: > What baffles me is that the generated html files also include these tags > at the bottom of each file: > <div class="navfooter"><hr /> > <table width="100%" summary="Navigation footer"> > I do not see anything in stylesheet.xsl that looks anything like this. > Does anyone know where the "magic incantations" are that generate this > navfooter? This comes from the DocBook XSL stylesheets. The stuff in stylesheet.xsl and similar is just a customization layer on top of those. -- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services