From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 16:32:46 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 B4964356; Thu, 23 Jan 2014 16:32:46 +0000 (UTC) Received: from mail-vc0-x22f.google.com (mail-vc0-x22f.google.com [IPv6:2607:f8b0:400c:c03::22f]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2EB5B10CE; Thu, 23 Jan 2014 16:32:46 +0000 (UTC) Received: by mail-vc0-f175.google.com with SMTP id ij19so1177190vcb.20 for ; Thu, 23 Jan 2014 08:32:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=0aBjwRhEr4dNptcCChS6JrCQzGWg1XNfkWUaiUXrNTI=; b=JxQkMbefKgIN3PD/kC9XkK+JSd5EkhgaHJkGX1v1j7zTlJcUl3qHgvQyBlASEUhUJR 6aYMM7V+ancLROmRuqbLLwKxux0zmaXtgQlHQMjaykhbHHtJ4SeMUVJuGHOpTUkr7uzW hWT+pTacU1h+GrjW2tcZJjtXwKFNSKAGSpH6bTGGtY9aXJlgs2m9apXmAQ7jNaMu1+K4 wMYeprZPriwYY9urhMk5UWfjNmGxu+ks1lwt2Ccu20NNBkdQs1dME3L4xtMJerCBPs+W jmWlnnvDWaMtPyzTHhEt8HdbDkQ5iM3UTEI3FG8WYw8mQ8MTbz8RtYsd1FYdVLrYFeeL c2xg== MIME-Version: 1.0 X-Received: by 10.58.161.227 with SMTP id xv3mr4927092veb.31.1390494765323; Thu, 23 Jan 2014 08:32:45 -0800 (PST) Received: by 10.220.168.135 with HTTP; Thu, 23 Jan 2014 08:32:45 -0800 (PST) In-Reply-To: <52E140D1.5090809@FreeBSD.org> 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> <52E140D1.5090809@FreeBSD.org> Date: Thu, 23 Jan 2014 11:32:45 -0500 Message-ID: Subject: Re: docs/144515: [handbook] Expand handbook Table of contents From: Thomas Hoffmann To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: Glen Barber , Gabor Kovesdan 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:32:46 -0000 On Thu, Jan 23, 2014 at 11:18 AM, Gabor Kovesdan wrote: > 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 > Top to bottom, left to right would be the normal "western" approach, no? Personally, I would have no problem with a TOC that only listed the major chapters. If you want the details sections/subsections) you would drill (click) down as required: 1. 6. 2. 7. 3 8. 4. 9. 5. 10. or even 1. 2. 3. 4. 5. 6. etc. It would require less scrolling, but this might be objectionable to many. I understand completely your desire to avoid JS. This may simply be an intractable problem. -Tom