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

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

Attach filesAttach ScreenshotVotersWatch issueWatchersCreate sub-taskLinkCloneUpdate Comment AuthorReplace String in CommentUpdate Comment VisibilityDelete Comments
    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • Release Branch 17.12, Trunk
    • 17.12.01
    • ALL PLUGINS
    • 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

          This comment will be Viewable by All Users Viewable by All Users
          Cancel

          People

            jleroux Jacques Le Roux
            jleroux Jacques Le Roux
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Slack

                Issue deployment