Hi Lex On Oct 8, 5:07 pm, Lex Trotman <[email protected]> wrote: > > I think we can safely assume I knew that since I both included > > examples of it in my posting and explained about how the "+" was > > required in asciidoc for multi-paragraph list items. ;) > > > The "+" is a bit ugly, but the main problem I have with the > > continuaion is that after the "+" line you must unindent. Indentation > > is not optional at that point in the list item: it's forbidden. In > > some places in a list, indentation is allowed, in other places it's > > not. I like the indentation in my source to reflect the structure of > > the document. Asciidoc doesn't allow that in some places. > > Hi Stuart, > > Whilst I don't have a problem with the + and many types of paragraphs > can be indented, I do find it a bit annoying to not be able to indent > literal blocks in the source. > > OTOH I understand that making asciidoc accept block markups that don't > start in column 1 could break old documents, but it could be enabled > by a command line option. > > My use case is similar to Grant's, ie enumerated list of instructions > with a sentence of text and a literal command block. As a matter of > style (actually of human cognitive limitations) any complex > explanations are deferred to later sections using a (for details see > ...). That way users can easily step through the steps, especially > after the first time, or can consult the expansive :-) details at a > click on the link.
AsciiDoc does make a nod in the direction of this sort of usage -- an item paragraph can be followed by a literal paragraph e.g. - Run the foofoo command: foofoo -c x bar.txt The indented literal paragraph is implicitly part of the list item. I'm not dogmatically against indentation, I'm just not motivated to pursue it and I've tried to explain why. But if anyone can come up with a patch that doesn't break the existing syntax then I'd be more than happy to review it for inclusion. Cheers, Stuart > > Cheers > Lex -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
