[OFBIZ-10677] Standalone Asciidoc plugins documents can't render logo correctly in PDF

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: Release Branch 17.12, Trunk
• Fix Version/s: 17.12.01
• Component/s: ALL PLUGINS
• Assignee: Jacques Le Roux
• Reporter: Jacques Le Roux
• Created: 28/Nov/18 09:07
• Updated: 23/Aug/20 15:51
• Resolved: 07/Dec/18 09:34

Description

Asciidoc plugins documents should be standalone as described in Documentation guidelines.

When rendering in PDF we should use the docs/asciidoc/images/OFBiz-Logo.svg file to avoid duplication. For a reason, maybe related to https://github.com/asciidoctor/asciidoctor-epub3/issues/22, it seems there is a conflict between declaring

:imagesdir: ./images

and

ifdef::backend-pdf[]
:title-logo-image: ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache OFBiz Logo, pdfwidth=4.25in, align=center]
:source-highlighter: rouge 
endif::[] 

in the same file.
You then get

[] | ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache OFBiz Logo, pdfwidth=4.25in, align=center]

instead of the logo in the 1st page of the PDF document.

So it seems it's not an OFBiz bug but rather a Asciidoctor issue. Not sure yet, so I create this Jira more as a reminder.

For now I'll not put logos in plugins standalone files.

Issue Links

• breaks: OFBIZ-10658 Plugins Asciidoc documentation must be standalone