public inbox for [email protected]help / color / mirror / Atom feed
how to modify the navfooter 5+ messages / 4 participants [nested] [flat]
* how to modify the navfooter @ 2018-08-07 22:21 Richard Swagerman <[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:27 Tom Lane <[email protected]> parent: Richard Swagerman <[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:45 Jonathan S. Katz <[email protected]> parent: 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-14 21:56 Richard Swagerman <[email protected]> parent: Jonathan S. Katz <[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-14 22:08 Peter Eisentraut <[email protected]> parent: Richard Swagerman <[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