Skip to content

Docbook reader: example and sidebar elements are actually supported #11422

@yanntrividic

Description

@yanntrividic

Hello,

I was going through the code of the Docbook reader, and noticed these two lines:

[ ] example - A formal example, with a title
...
[ ] sidebar - A portion of a document that is isolated from the main
    narrative flow

But when I convert this:

<sidebar><title>Test title.</title>
    <para>
      Dog’s has a curved apostrophe, but dog's does not.
    </para>
    <para>
      An escaped symbol: *star*.
    </para>
</sidebar>
<example><title>Hello</title>
    <para>
      Dog’s has a curved apostrophe, but dog's does not.
    </para>
    <para>
      An escaped symbol: *star*.
    </para>
</example>
<example>
    <para>
      Example without a title.
    </para>
</example>

I get this output:

:::: sidebar
::: title
Test title.
:::

Dog's has a curved apostrophe, but dog\'s does not.

An escaped symbol: \*star\*.
::::

:::: example
::: title
Hello
:::

Dog's has a curved apostrophe, but dog\'s does not.

An escaped symbol: \*star\*.
::::

:::: example
::: title
:::

Example without a title.
::::

Which seems to be what we would expect from sidebar and example elements support. Is there something I am missing?

Also, please note the empty title block. Could it be removed from the output? Is there a reason it is there?

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions