[ofbiz-framework] 02/02: Improved: solve Error messages when generating HTML and PDF file from AsciiDoc files (OFBIZ-11893)

[ho...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

holivier pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/ofbiz-framework.git

commit ee20e6c715e0301eb29b90ca5a0231b3fcc18816
Author: holivier <ho...@apache.org>
AuthorDate: Thu Oct 1 16:25:06 2020 +0200

    Improved: solve Error messages when generating HTML and PDF file from
    AsciiDoc files (OFBIZ-11893)
    
    Add the correct set when use icon, to avoid INFO message
---
 docs/asciidoc/documentation_guidelines.adoc | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/docs/asciidoc/documentation_guidelines.adoc b/docs/asciidoc/documentation_guidelines.adoc
index 8d7b863..1c69c86 100644
--- a/docs/asciidoc/documentation_guidelines.adoc
+++ b/docs/asciidoc/documentation_guidelines.adoc
@@ -563,18 +563,31 @@ The result will be different depending on the rendering (PDF, HTML).
 === Using inline icons
 
 You can also add the `:icons: font` directive to the top of your document, which allows you to use the icons
-from http://fortawesome.github.io/Font-Awesome/icons/ directory via a macro.
+from http://fortawesome.github.io/Font-Awesome/icons/ directory via a macro using any of the following icon sets:
+
+* fa - https://fontawesome.com/v4.7.0/icons (default)
+* fas - https://fontawesome.com/icons?d=gallery&s=solid[Font Awesome - Solid]
+* fab - https://fontawesome.com/icons?d=gallery&s=brands[Font Awesome - Brands]
+* far - https://fontawesome.com/icons?d=gallery&s=regular[Font Awesome - Regular]
+* fi - http://zurb.com/playground/foundation-icon-fonts-3[Foundation Icons]
+* pf - https://paymentfont.com/[Payment font]
+
+The fa icon set is deprecated. Please use one of the other three FontAwesome icon sets. +
+when icon is not available in fa icon set but in an other, it's possible to give the correct set.
+
+The generate Document process generate a INFOS message, if icon is available in an other set and it is not given.
 ----
-icon:comment[] This is a comment icon
-icon:file[] And a file icon
-icon:battery-full[] And a battery icon
+icon:comment[set=far] This is a comment icon
+icon:file[set=far] And a file icon
+icon:battery-full[set=fas] And a battery icon
 ----
 
 .The output looks like the following
 [example]
-icon:comment[] This is a comment icon +
-icon:file[] And a file icon +
-icon:battery-full[] And a battery icon
+icon:comment[set=far] This is a comment icon +
+icon:file[set=far] And a file icon +
+icon:battery-full[set=fas] And a battery icon
+
 
 == How to write a...