On 1 September 2010 18:26, Joshua D. Drake <jd@commandprompt.com> wrote:
> On Wed, 2010-09-01 at 13:04 -0400, Tom Lane wrote:
>> "Joshua D. Drake" <jd@commandprompt.com> writes:
>> > On Wed, 2010-09-01 at 11:29 -0400, Tom Lane wrote:
>> >> As an example, do you think that anyone trying to read one of these
>> >> pages on a cell-phone-sized screen is going to thank you for taking up
>> >> some of his screen with this?
>>
>> > Not anymore than all the other stuff on the screen (like the search box,
>> > header and excess space between the breadcrumb, the title and the fast
>> > forward links).
>>
>> Uh, no, because that stuff is just at the top of the page; it doesn't
>> stay there while you scroll down.
>
> You may have missed the part where I said, it didn't move for me. :D
>
> Anyway, Thom is removing it so it doesn't really matter.
>
> JD
I'm coming round to the idea that if we wanted such a table of
contents, we'd generate it on the page when building the docs rather
than running some ECMAScript. I've already got a basic contents thing
showing on my version of the docs (see
http://pgweb.darkixion.com:8081/docs/9.0/static/functions-xml.html ),
but I'm not happy with it. It looks out of place and there doesn't
seem to be any appropriate place to put the link to show it.
So rather than attempting to do this, do you think we should produce a
table of contents on pages containing 3rd and 4th-level chapter
headings? This would be in the same style as we currently have for
chapter introductions:
http://pgweb.darkixion.com:8081/docs/9.0/static/typeconv.html with the
only difference being that it would show the 3rd and 4th levels as
opposed to the 2nd and 3rd levels currently on chapter start pages.
--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935