Add support for AsciiDoctor extensions

[wessven]

I propose adding a feature which automatically detects which AsciiDoctor extensions are installed, and (if they make sense in the context of Hugo) enable them.

My motivation for this is that I want to use asciidoctor-bibtex. This extension allows BibTeX files to be used from within an AsciiDoc file, and to render citations and bibliographies. But this change will also be effective for other extensions, such as asciidoctor-diagram.

I am busy working on a solution for this and would be able to submit a pull request soonish.

Related to #3330 and #2996.

[wessven]

WIP result attached. asciidoctor-bibtex fails when a page does not contain a bibliography, so it can't be enabled for every page. Will add logic to only enable an extension if certain criteria in the document is met.

[wessven]

Submitted PR #5692

[mojavelinux]

What this really comes down to is allowing control over the -r flag of the asciidoctor command. I wouldn't limit the acceptable values to a fixed set since the catalog of extensions is open ended.

[wessven]

Sorry for the slow reply. Busy planning a wedding and things are a bit crazy.

I agree with you. I was hoping that this would be a simple fix (I have never developed in Go before), but then I couldn't figure out how to access elements specified within the document. I.e. how to get the value which must be passed to the -r parameter. Matters are further complicated by the fact that the extension in which I am interested (asciidoctor-bibtex) fails the document conversion if the extension is specified, but not used within the source document. So it cannot be "on by default".

[mojavelinux]

how to get the value which must be passed to the -r parameter

I would imagine it would come from the Hugo configuration object.

[wessven]

Great, thanks for the tip. I'll have a look at this when I next have a chance.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. The resources of the Hugo team are limited, and so we are asking for your help.
If this is a bug and you can still reproduce this error on the master branch, please reply with all of the information you have about it in order to keep the issue open.
If this is a feature request, and you feel that it is still relevant and valuable, please tell us why.
This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.

[mojavelinux]

How can this issue be marked as stale when there's an open PR that's never been addressed?

[stale]

This issue has been automatically marked as stale because it has not had recent activity. The resources of the Hugo team are limited, and so we are asking for your help.
If this is a bug and you can still reproduce this error on the master branch, please reply with all of the information you have about it in order to keep the issue open.
If this is a feature request, and you feel that it is still relevant and valuable, please tell us why.
This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.

[celtic-coder]

PR #5692 is still open.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. The resources of the Hugo team are limited, and so we are asking for your help.
If this is a bug and you can still reproduce this error on the master branch, please reply with all of the information you have about it in order to keep the issue open.
If this is a feature request, and you feel that it is still relevant and valuable, please tell us why.
This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.

[celtic-coder]

What is the status of PR #5692?

[snipem]

@celtic-coder Seems to be stale. There is newer one with ongoing discussion: #6561

[celtic-coder]

Hi @snipem,
Yes, I have been keeping an eye on that one as well. Thanks for the heads up! 🙂

Kind Regards,
Liam

[stale]

This issue has been automatically marked as stale because it has not had recent activity. The resources of the Hugo team are limited, and so we are asking for your help.
If this is a bug and you can still reproduce this error on the master branch, please reply with all of the information you have about it in order to keep the issue open.
If this is a feature request, and you feel that it is still relevant and valuable, please tell us why.
This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.

[github-actions]

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.