search

openSUSE / suse-xsl

DocBook XSL Stylesheets for SUSE branding
Other
11 stars 10 forks source link

AsciiDoc: Support for [%hardbreaks] appears to be missing/broken #431

Closed ghost closed 2 years ago

ghost commented 3 years ago

The AsciiDoctor site says that hard line breaks are supported via [%hardbreaks], https://docs.asciidoctor.org/asciidoc/latest/blocks/hard-line-breaks/.

The SUSE Distribution Migration System documentation was previously using this, see the raw version of https://github.com/SUSE/suse-migration-services/blob/79e63caa/doc/adoc/user_guide.adoc (the most recent document uses a bulleted list). However, when built with DAPS, all the supposedly hard-broken content came out on the same line, like so: sdsm-hardbreaks

This happens in HTML, PDF and EPUB.

I am not 100% sure whether this should go here (because it might be an AsciiDoctor XML export issue) or should go into suse-xsl (because the stylesheets might be ignoring a tag by AsciiDoctor). Have not investigated more.

(via @schaefi)

fsundermeyer commented 3 years ago

Since there is no such thing as a linebreak in Docbook, asciidoctor is inserting a PI <?asciidoc-br?>.

Since the suse-xsl stylesheets have no support for this PI, so they are ignored. Transferring issue to suse-xsl.

ghost commented 2 years ago

Fixed via 886b9dc