Asciidoctor :: Discussion

Lists max nesting level?

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

6 messages Options

nagim

Lists max nesting level?

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

mojavelinux

Re: Lists max nesting level?

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

nagim

Re: Lists max nesting level?

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

mojavelinux

Re: Lists max nesting level?

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

nagim

Re: Lists max nesting level?

Great, thanks again!

I might look into that PR soon.

Cheers,
Imre

mojavelinux

Re: Lists max nesting level?

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