From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 16:18:29 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9926FF1A; Thu, 23 Jan 2014 16:18:29 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 465D71F31; Thu, 23 Jan 2014 16:18:28 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 56CE714D2510; Thu, 23 Jan 2014 17:18:27 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id Vza_dNNShNY5; Thu, 23 Jan 2014 17:18:26 +0100 (CET) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8EE8E14D2436; Thu, 23 Jan 2014 17:18:26 +0100 (CET) Message-ID: <52E140D1.5090809@FreeBSD.org> Date: Thu, 23 Jan 2014 17:18:25 +0100 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Thunderbird/28.0a2 MIME-Version: 1.0 To: Thomas Hoffmann , freebsd-doc@freebsd.org Subject: Re: docs/144515: [handbook] Expand handbook Table of contents 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> <52E13ACC.2020005@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Glen Barber X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 16:18:29 -0000 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