On Wed, Sep 10, 2014 at 5:05 AM, Lex Trotman <[email protected]> wrote:
> 1. there can be more than one paragraph inside a list item, so the <p> > is needed then. For consistency and so styling is easier and not > repeated, <p> is output for single paragraphs as well. > This explains the motivation behind the choice to wrap the list item content in a <p> best. It's origins trace back to matching schema requirements from DocBook. I'm surprised to see that the first is plain "<p>" but also some "<p>" > surrounded by "<div class="paragraph">". This is where AsciiDoc shows its DocBook legacy most. The <p> is surrounded by a <div> to accommodate an optional paragraph title (i.e., a formal paragraph). Even when the title is not present, the <div> was still used because it sidestepped the need to create CSS to address the two different cases (formal and informal). That doesn't mean it's necessary, or that using the <div> wrapper doesn't complicate the CSS in other ways...it's just what Stuart choose to do at the time. The <div> around paragraphs is definitely something I'd like consider changing in the future because it really does add a lot of unnecessary CSS hacks to use a CSS framework like Bootstrap and Foundation. Instead, I think the class should be added on the <p> itself and the title <div> placed above it. Something like: <div class="title">Paragraph title</div> <p class="para">Paragraph content</p> The downside is that CSS *still* can't style the previous sibling of an element...so it's harder to match. We could consider keeping the <div> around the title and paragraph in this case...but that still presents some challenges when styling with CSS. Since the HTML for paragraphs is tangential to this discussion, I think it should be handled in a separate request. -Dan -- Dan Allen | http://google.com/profiles/dan.j.allen -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
