Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 23 Jan 2014 17:18:25 +0100
From:      Gabor Kovesdan <gabor@FreeBSD.org>
To:        Thomas Hoffmann <trh411@gmail.com>, freebsd-doc@freebsd.org
Cc:        Glen Barber <gjb@freebsd.org>
Subject:   Re: docs/144515: [handbook] Expand handbook Table of contents
Message-ID:  <52E140D1.5090809@FreeBSD.org>
In-Reply-To: <CAB7-odk36PQawmUG=LyDu1wXcnSVqmxtT7n1AkFL4T19rC_=_Q@mail.gmail.com>
References:  <201401221442.s0MEgd2o082802@freefall.freebsd.org>	<52E075F7.7020105@a1poweruser.com>	<20140123020029.GE52955@glenbarber.us>	<52E1053A.8000608@a1poweruser.com>	<834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org>	<CAB7-odngKOODXCtD2NsxzG-8v5y5TFtxe-SRTSUujZ7wesy%2BrA@mail.gmail.com>	<52E13ACC.2020005@FreeBSD.org> <CAB7-odk36PQawmUG=LyDu1wXcnSVqmxtT7n1AkFL4T19rC_=_Q@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2014.01.23. 16:59, Thomas Hoffmann wrote:
> I agree, the TOC is already too long vertically. Adding subsections 
> would exacerbate the problem.
>
> By "horizontal page" I mean taking advantage of the full screen width, 
> for example, by using multi-columns or similar technique. That would 
> get more info on each screen page. Compare the TOC with the 
> x-config.html page ( 
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html), 
> which uses the full page width.
The problem with this is that TOC is a multiple level enumeration by 
nature, which is conventionally listed vertically in order. Using two 
columns may be confusing for people since it is not conventional. And if 
we use 2 columns, what order would it follow? Like this:

1        2
1.1    2.1
1.2    2.2
1.3    2.3

Or this:

1
1.1        1.2
1.3        1.4

And what to do on smaller screens if the two columns do not fit?

I believe that a collapsible tree list would be the best option but that 
requires JavaScript, which we prefer to avoid...

Gabor



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52E140D1.5090809>