Lists max nesting level?

classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Lists max nesting level?

nagim
Hi,

According to the docs, I can have lists up to five levels of nesting.
However, when writing documentation that required more levels, I discovered that I can have more (sorry for the big image).

Are there any official syntax definitions for such deep lists or this is something that I discovered totally by accident?
I use AsciiDoc with GitBook.

Many thanks!

Cheers,
Imre
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Lists max nesting level?

mojavelinux
Administrator
Yes, it's possible to get more nesting levels by combining unordered and ordered lists (and even description lists). While that's something you can do, it's not really recommended to nest too deeply. Once you get past a half dozen levels of nesting, it's really not easy for the reader to understand what's going on. So it's a usability thing.

-Dan

--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Lists max nesting level?

nagim
Thanks for replying Dan!
While I agree on usability, unfortunately there are cases when we cannot avoid nesting this deep (I tried). I just wanted to know if this is a known feature/option.

Thanks for clarifying this!

Cheers,
Imre
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Lists max nesting level?

mojavelinux
Administrator

On Tue, Dec 13, 2016 at 2:16 PM, nagim [via Asciidoctor :: Discussion] <[hidden email]> wrote:
While I agree on usability, unfortunately there are cases when you cannot avoid nesting this deep (I tried). I just wanted to know if this is a known feature/option.

Yes, when we say "maximum depth", it means per type of list. So if you combine lists, then you can get more levels and that is supported. We might want to emphasize that in the docs. (Free free to suggest a PR).

Cheers,

-Dan


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Lists max nesting level?

nagim
Great, thanks again!

I might look into that PR soon.

Cheers,
Imre
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Lists max nesting level?

mojavelinux
Administrator
Great! I'll be here to help you through it.

-Dan

On Thu, Dec 15, 2016 at 5:47 AM, nagim [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Great, thanks again!

I might look into that PR soon.

Cheers,
Imre


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Lists-max-nesting-level-tp5148p5153.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Loading...