[
https://issues.apache.org/jira/browse/OFBIZ-12035?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Olivier Heintz closed OFBIZ-12035.
----------------------------------
Fix Version/s: Trunk
Resolution: Fixed
All seem to works correctly, on *nix directory in doc/images is created at the
beginning and removed at the end.
There are still warning message when pdf is generated, but these are wrong
because all images are present in html and pdf. I will post an issue in
ascidoctor project for that.
> asciidoc Image directory convention for plugins and components
> --------------------------------------------------------------
>
> Key: OFBIZ-12035
> URL: https://issues.apache.org/jira/browse/OFBIZ-12035
> Project: OFBiz
> Issue Type: Improvement
> Components: birt
> Affects Versions: Trunk
> Reporter: Olivier Heintz
> Assignee: Olivier Heintz
> Priority: Major
> Labels: Documentation
> Fix For: Trunk
>
> Attachments:
> framework_0001-Improved-change-asciidoc-Image-directory-convention-.patch,
> framework_0001-Improved-change-asciidoc-Image-directory-convention-.patch,
> plugins_0001-Improved-change-asciidoc-Image-directory-convention-.patch
>
>
> Plugins documentation (in asciidoc) can be generated with one document per
> plugins (in [https://ci.apache.org/projects/ofbiz/site/trunk/pluginsdoc/]
> directory) or include in the general
> [user-manual|https://ci.apache.org/projects/ofbiz/site/trunk/ofbizdoc/html5/user-manual.html#_apache_ofbiz_plugins]
> or
> [developer-manual|https://ci.apache.org/projects/ofbiz/site/trunk/ofbizdoc/html5/developer-manual.html#_apache_ofbiz_plugins_for_developer]
> Currently, image usage not works in the two case, because image path is
> relative to the root document.
> To solve the problem, I propose to put image(s) relative to a component in
> the src/docs/asciidoc/images/${component.name} of the component and modifying
> gradle generateDocumentation task to copy the subdirectory in the general
> docs/asciidoc/images/ directory before generation and remove it after.
> Currently only birt is concern but it's better to have schema and other image
> in documentation, so in future all components should be concerned.
>
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
