Feature request: Support Citation for DocBook

[shahryareiv]

DockBook has citation tag <citation> but Asciidoctor does not support that (yet). Regarding that asciidoctor-bibliography already parse citations it can also add this support. I do not know if Asciidoc -> DocBook is still common for most of users or not, but Asciidoc -> DocBook -> (Xe)Latex is still the most reliable way of creating Latex document from asciidoc and get the Tex family typesetting quality features.

[ronaldtse]

@shahryareiv would you mind elaborating a bit on what you mean by adding the <citation> tag?

Do you mean that when asciidoctor-bibliography is used together with the Docbook processor, our gem can also output citations using the <citation> tags in the Docbook output?

Thanks!

[shahryareiv]

@ronaldtse yes exactly. Both the <citation> tags and also the expansion of bibliographies if one used bibliography::[].

@ronaldtse @mojavelinux I also think it might be better if there would be an agreement on what should be the standard forms of citation, the macro names and arguments in Asciidoc. Then Asciidoctor can translate it, let's say like <citation>key1</citation> or <span class="citation">key1</span> using its templates. Then the expansion of citations and bibliographies would be the job of extensions such as asciidoctor-bibliography.

[paolobrasolin]

I think this might be already feasible, @shahryareiv.

We're already had the need to render citations and bibliographies to RFC (essentially XML) when pairing asciidoctor-bibliography with asciidoctor-rfc.

We managed to do that by

• defining AsciidoctorBibliography::Databases::RFC to import RFC bibliographic databases and
• writing a custom CSL style to render citations and indices (to be used with the passthrough option).

Adapting this to the case of DocBook should be relatively straightforward.