[ 
https://issues.apache.org/jira/browse/OFBIZ-10677?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Jacques Le Roux updated OFBIZ-10677:
------------------------------------
    Description: 
Asciidoc plugins documents should be standalone as described in [Documentation 
guidelines|https://svn.apache.org/repos/asf/ofbiz/ofbiz-framework/trunk/docs/asciidoc/documentation_guidelines.adoc].

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 
{code}
:imagesdir: ./images
{code}
and 
{code}
ifdef::backend-pdf[]
:title-logo-image: ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache 
OFBiz Logo, pdfwidth=4.25in, align=center]
:source-highlighter: rouge 
endif::[] 
{code}
in the same file. 
You then get 
{code}
[] | ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache OFBiz Logo, 
pdfwidth=4.25in, align=center]
{code}
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.

  was:
Asciidoc plugins documents should be standalone as described in [Documentation 
guidelines|https://svn.apache.org/repos/asf/ofbiz/ofbiz-framework/trunk/docs/asciidoc/documentation_guidelines.adoc].

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 
{code}
:imagesdir: ./images
{code}
and 
{code}
ifdef::backend-pdf[]
:title-logo-image: ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache 
OFBiz Logo, pdfwidth=4.25in, align=center]
:source-highlighter: rouge 
endif::[] 
{code}
in the same file. 
You then get 
{code}
[] | ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache OFBiz Logo, 
pdfwidth=4.25in, align=center]
{code}
instead of the logo in the 1st page of the 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.


> Standalone Asciidoc plugins documents can't render logo correctly in PDF
> ------------------------------------------------------------------------
>
>                 Key: OFBIZ-10677
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-10677
>             Project: OFBiz
>          Issue Type: Bug
>          Components: ALL PLUGINS
>    Affects Versions: Trunk, Release Branch 17.12
>            Reporter: Jacques Le Roux
>            Priority: Minor
>
> Asciidoc plugins documents should be standalone as described in 
> [Documentation 
> guidelines|https://svn.apache.org/repos/asf/ofbiz/ofbiz-framework/trunk/docs/asciidoc/documentation_guidelines.adoc].
> 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 
> {code}
> :imagesdir: ./images
> {code}
> and 
> {code}
> ifdef::backend-pdf[]
> :title-logo-image: ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache 
> OFBiz Logo, pdfwidth=4.25in, align=center]
> :source-highlighter: rouge 
> endif::[] 
> {code}
> in the same file. 
> You then get 
> {code}
> [] | ../../../../../docs/asciidoc/images/OFBiz-Logo.svg[Apache OFBiz Logo, 
> pdfwidth=4.25in, align=center]
> {code}
> 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.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to