Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On Fri, 01 Apr 2011 12:47:12 +0200, Georg Brandl wrote: > Am 01.04.2011 01:12, schrieb R. David Murray: > > On Fri, 01 Apr 2011 08:29:29 +1000, Nick Coghlan wrote: > >> On Fri, Apr 1, 2011 at 2:34 AM, R. David Murray > >> wro= > >> te: > >> > I agree with this point. =A0The sidebar list of questions is effectively > >> > useless. > >> > >> Indeed. If it's simple, I'd actually be inclined to reduce the depth > >> of the sidebar in this case to only show the categories and not the > >> individual questions. > > > > I believe that requires editing the sphinx page template and adding > > a special case of some sort. > > Use > > :tocdepth: x > > at the top of the rst file. Ah, nice. -- R. David Murray http://www.bitdance.com ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
Am 01.04.2011 01:12, schrieb R. David Murray: > On Fri, 01 Apr 2011 08:29:29 +1000, Nick Coghlan wrote: >> On Fri, Apr 1, 2011 at 2:34 AM, R. David Murray wro= >> te: >> > I agree with this point. =A0The sidebar list of questions is effectively >> > useless. >> >> Indeed. If it's simple, I'd actually be inclined to reduce the depth >> of the sidebar in this case to only show the categories and not the >> individual questions. > > I believe that requires editing the sphinx page template and adding > a special case of some sort. Use :tocdepth: x at the top of the rst file. Georg ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On Fri, 01 Apr 2011 08:29:29 +1000, Nick Coghlan wrote: > On Fri, Apr 1, 2011 at 2:34 AM, R. David Murray wro= > te: > > I agree with this point. =A0The sidebar list of questions is effectively > > useless. > > Indeed. If it's simple, I'd actually be inclined to reduce the depth > of the sidebar in this case to only show the categories and not the > individual questions. I believe that requires editing the sphinx page template and adding a special case of some sort. -- R. David Murray http://www.bitdance.com ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On Fri, Apr 1, 2011 at 2:34 AM, R. David Murray wrote: > I agree with this point. The sidebar list of questions is effectively > useless. Indeed. If it's simple, I'd actually be inclined to reduce the depth of the sidebar in this case to only show the categories and not the individual questions. Cheers, Nick. -- Nick Coghlan | ncogh...@gmail.com | Brisbane, Australia ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On Thu, 31 Mar 2011 18:47:39 +0300, Ezio Melotti wrote: > On 30/03/2011 23.20, Antoine Pitrou wrote: > > On Tue, 29 Mar 2011 21:00:22 +0200 > > ezio.melotti wrote: > >> http://hg.python.org/devguide/rev/f722956afeac > >> changeset: 405:f722956afeac > >> user:Ezio Melotti > >> date:Tue Mar 29 22:00:13 2011 +0300 > >> summary: > >>Add a table of contents to the FAQ. > > Could it be collapsed by default? > > I don't think there's an easy way to collapse it by default. > In most of the cases I anyway check the FAQ for something specific. > Having a list at the top provides an overview of the questions and also > an easy way to locate and jump to the right answer. > > > It's quite long, and redundant with the sidebar. > > The list is indeed redundant, but the sidebar is not really usable here. I agree with this point. The sidebar list of questions is effectively useless. Most FAQ lists start with the long list of questions. I don't see why this one should be different :) -- R. David Murray http://www.bitdance.com ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On 30/03/2011 23.20, Antoine Pitrou wrote: On Tue, 29 Mar 2011 21:00:22 +0200 ezio.melotti wrote: http://hg.python.org/devguide/rev/f722956afeac changeset: 405:f722956afeac user:Ezio Melotti date:Tue Mar 29 22:00:13 2011 +0300 summary: Add a table of contents to the FAQ. Could it be collapsed by default? I don't think there's an easy way to collapse it by default. In most of the cases I anyway check the FAQ for something specific. Having a list at the top provides an overview of the questions and also an easy way to locate and jump to the right answer. It's quite long, and redundant with the sidebar. The list is indeed redundant, but the sidebar is not really usable here. Best Regards, Ezio Melotti thanks Antoine. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] devguide: Add a table of contents to the FAQ.
On Tue, 29 Mar 2011 21:00:22 +0200 ezio.melotti wrote: > http://hg.python.org/devguide/rev/f722956afeac > changeset: 405:f722956afeac > user:Ezio Melotti > date:Tue Mar 29 22:00:13 2011 +0300 > summary: > Add a table of contents to the FAQ. Could it be collapsed by default? It's quite long, and redundant with the sidebar. thanks Antoine. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com