Asciidoc: attributes in functions rendered as a blank line

[anarthal]

It looks like there is a rendering issue with attributes in the asciidoc generator. They seem to be added to the resulting asciidoc, but when rendered to HTML, they are replaced by blank lines.

For instance:

namespace boost::mysql {

template <class T>
[[nodiscard]] int f();

}  // namespace boost::mysql

Generates the following asciidoc:

[#boost-mysql-f]
= xref:boost.adoc[boost]::xref:boost/mysql.adoc[mysql]::f
:relfileprefix: ../../
:mrdocs:


== Synopsis


Declared in `<https://github.com/boostorg/mysql/blob/master/include/boost/repro.hpp#L4[boost/repro.hpp]>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class T>
[[nodiscard]]
int
f();
----



[.small]#Created with https://www.mrdocs.com[MrDocs]#

Which renders as:

[alandefreitas]

Attributes look fine in the tests (see test-files/golden-tests/metadata/attributes_1.html). It might be an issue with the version because MrDocs is moving very fast. Depending on how you're running it, you could create a script to update/reinstall MrDocs and run it every once in a while.

In any case, I've included another test with the specific case:

// issue #851

template <class T>
[[nodiscard]] int f();

Reference

Global namespace

Functions

Name
f

f

Synopsis

Declared in <attributes-2.cpp>

template<class T>
[[nodiscard]]
int
f();

Created with MrDocs

[anarthal]

I've updated to 375d913 and this seems to still happen. Can you please point me to the package.json with the Antora and asciidoctor versions you use in your test suite?

[alandefreitas]

There's no Antora and asciidoc in the test suite. You can see the fixtures in test-files/golden-tests.

In this case, test-files/golden-tests/metadata/attributes*. There you can see what MrDocs generates.

But I think in this case we have to investigate the relationship between the asciidoc it generates and Antora.

Does [[xxxx]] have some special meaning in Antora (meaning we also have to escape [ and ]) or is the HTML Antora generates is correct (meaning there's something we need to fix in the UI bundle)?

[alandefreitas]

Oh... Just had another look at it. The issue is Antora interprets that as an anchor. I'll fix that soon.

[anarthal]

Well I did post the generated asciidoc :)

[anarthal]

Gotcha. Thanks.

[alandefreitas]

Well I did post the generated asciidoc :)

Yes. The word "rendered" is what was ambiguous. There are many rendering steps to be confused about. I thought you meant the attribute just wasn't in the adoc file. Not that it wasn't correctly escaped and being converted to an anchor.