$unwrap-paragraphs

$unwrap-paragraphs — Attempt to unwrap paragraphs that contain block elements?

Parameter:
{}unwrap-paragraphs
Defined in:
param.xsl
Used in:
main.xsl, param.xsl
Since:
2.0.13

Synopsis

  |$unwrap-paragraphs as xs:string := 'false'

Description

DocBook allows “block elements” (tables, figures, etc.) inside paragraphs or between paragraphs. The question of whether or not a table, figure, etc. is part of a paragraph is an editorial one. If you put the block element in the DocBook para, it will be in the resulting HTML p element.

Except, that’s not valid HTML. HTML deprives you of the editorial choice. If $unwrap-paragraphs is true, the stylesheets will attempt to unwrap block elements inside paragraphs, producing a sequence of paragraphs and blocks.

Note that with this option, a p element identified with an ID attribute is not guaranteed to contain all of the content that the DocBook paragraph contained.