Uploaded image for project: 'OFBiz'
  1. OFBiz
  2. OFBIZ-10677

Standalone Asciidoc plugins documents can't render logo correctly in PDF

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: Trunk, Release Branch 17.12
    • Fix Version/s: 17.12.01
    • Component/s: ALL PLUGINS
    • Labels:
      None

      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.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                jacques.le.roux Jacques Le Roux
                Reporter:
                jacques.le.roux Jacques Le Roux
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: