On Thu, Feb 02, 2012 at 07:34:23PM EST, Lex Trotman wrote: > On Fri, Feb 3, 2012 at 10:57 AM, Chris Jones <[email protected]> wrote:
> > I am writing an FAQ and found that some of the answers are a little > > on the long side and would best be split into 2-3 paragraphs. [..] > You can't combine two list types in the same paragraph. > > To achieve your result use multi paragraph numbered lists. You have > to manually attach the extra paragraphs to the list item: > > . Question one > + > blah de blah blahblah de blah blahblah de blah blahblah de blah > blahblah de blah blah > + > blab de blab blabblab de blab blabblab de blab blabblab de blab > blabblab de blab blab > > . Question 2 > + > foo de foo foo > foo de foo foo > foo de foo foo > foo de foo foo > foo de foo foo > + > lorem ipsum etc etc lorem ipsum etc etc lorem ipsum etc etc lorem > ipsum etc etc lorem ipsum etc etc > > This gives the result you described, including indenting. Thanks, where I am concerned, this is an absolute life changer..! The output looks great out of the box, both in PDF's and xhtml. This is a format I find extremely useful when I want to structure content.. let's say ‘informally’ -- as opposed to a more formal section.. sub-section.. paragraph approach. I was unable to find a description of this technique in the User Guide.. Maybe it would be worth a note or a warning.. along the lines of your ‘you can't combine two list types in the same paragraph’... but if you want a list with multi-paragraph entries, here's how you can do it’. After all it's a User Guide, not a Reference manual. Just my 2¢, naturally... > PS just a hint, as became apparent with the Asciidoc FAQ, the question > numbers for FAQs should be fixed, so references to FAQ #55 will always > remain correct. Good point.. but what if the FAQ reaches a size where it needs a major overhaul..? I mean.. FAQ #55 becomes FAQ #3.12 - e.g... Backward compatibility also has its drawbacks.. For the record, I wrote ‘FAQ’.. but I really meant ‘FAQ-style’.. it's not a document meant for publishing .. not to be referenced anywhere, not even locally on my PC. But all the same, I'm glad you mentioned it.. and assuming the source of the FAQ is written in asciidoc, I would be quite interested in taking a look at it. Can I access it anywhere? Thanks, CJ -- 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.
