You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ofbiz.apache.org by "Jacques Le Roux (JIRA)" <ji...@apache.org> on 2018/11/28 09:08:00 UTC
[jira] [Updated] (OFBIZ-10677) Standalone Asciidoc plugins
documents can't render logo correctly in PDF
[ 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)