public inbox for [email protected]
help / color / mirror / Atom feedhow to modify the navfooter
5+ messages / 4 participants
[nested] [flat]
* how to modify the navfooter
@ 2018-08-07 22:21 Richard Swagerman <[email protected]>
2018-08-07 22:27 ` Re: how to modify the navfooter Tom Lane <[email protected]>
2018-08-07 22:45 ` Re: how to modify the navfooter Jonathan S. Katz <[email protected]>
0 siblings, 2 replies; 5+ messages in thread
From: Richard Swagerman @ 2018-08-07 22:21 UTC (permalink / raw)
To: [email protected]
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
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: how to modify the navfooter
2018-08-07 22:21 how to modify the navfooter Richard Swagerman <[email protected]>
@ 2018-08-07 22:27 ` Tom Lane <[email protected]>
1 sibling, 0 replies; 5+ messages in thread
From: Tom Lane @ 2018-08-07 22:27 UTC (permalink / raw)
To: Richard Swagerman <[email protected]>; +Cc: [email protected]
Richard Swagerman <[email protected]> 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
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: how to modify the navfooter
2018-08-07 22:21 how to modify the navfooter Richard Swagerman <[email protected]>
@ 2018-08-07 22:45 ` Jonathan S. Katz <[email protected]>
2018-08-14 21:56 ` Re: how to modify the navfooter Richard Swagerman <[email protected]>
1 sibling, 1 reply; 5+ messages in thread
From: Jonathan S. Katz @ 2018-08-07 22:45 UTC (permalink / raw)
To: Richard Swagerman <[email protected]>; +Cc: [email protected]
> On Aug 7, 2018, at 6:21 PM, Richard Swagerman <[email protected]> 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 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’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 :-)
[1] https://git.postgresql.org/gitweb/?p=pgweb.git;a=summary <https://git.postgresql.org/gitweb/?p=pgweb.git;a=summary;[2] https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=templates/docs/docspage.html; <https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=templates/docs/docspage.html;h=3c5535b43a6f6...;
Attachments:
[application/pgp-signature] signature.asc (833B, 3-signature.asc)
download
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: how to modify the navfooter
2018-08-07 22:21 how to modify the navfooter Richard Swagerman <[email protected]>
2018-08-07 22:45 ` Re: how to modify the navfooter Jonathan S. Katz <[email protected]>
@ 2018-08-14 21:56 ` Richard Swagerman <[email protected]>
2018-08-14 22:08 ` Re: how to modify the navfooter Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Richard Swagerman @ 2018-08-14 21:56 UTC (permalink / raw)
To: [email protected]
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 <[email protected]>
wrote:
>
> On Aug 7, 2018, at 6:21 PM, Richard Swagerman <[email protected]>
> 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 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’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 :-)
>
> [1] https://git.postgresql.org/gitweb/?p=pgweb.git;a=summary
> [2] https://git.postgresql.org/gitweb/?p=pgweb.git;a=
> blob;f=templates/docs/docspage.html;
> <https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=templates/docs/docspage.html;h=3c5535b43a6f6...;
>
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: how to modify the navfooter
2018-08-07 22:21 how to modify the navfooter Richard Swagerman <[email protected]>
2018-08-07 22:45 ` Re: how to modify the navfooter Jonathan S. Katz <[email protected]>
2018-08-14 21:56 ` Re: how to modify the navfooter Richard Swagerman <[email protected]>
@ 2018-08-14 22:08 ` Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 5+ messages in thread
From: Peter Eisentraut @ 2018-08-14 22:08 UTC (permalink / raw)
To: Richard Swagerman <[email protected]>; [email protected]
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
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2018-08-14 22:08 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-08-07 22:21 how to modify the navfooter Richard Swagerman <[email protected]>
2018-08-07 22:27 ` Tom Lane <[email protected]>
2018-08-07 22:45 ` Jonathan S. Katz <[email protected]>
2018-08-14 21:56 ` Richard Swagerman <[email protected]>
2018-08-14 22:08 ` Peter Eisentraut <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox