docs: changelog, release notes and feature documentation #508

Author: fugerit79

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- fj-doc-mod-fop, make accessibility and keep empty tags parameters configurable <https://github.com/fugerit-org/fj-doc/issues/508>
+
 ## [8.16.2] - 2025-09-12
 
 ### Changed

fj-doc-guide/src/main/docs/asciidoc/chapters/00_2_release_notes.adoc

@@ -3,6 +3,21 @@
 
 Whereas the link:https://github.com/fugerit-org/fj-doc/blob/main/CHANGELOG.md[CHANGELOG] is a detailed list of modifications to project, the release notes just refer to the most important changes.
 
+[#doc-release-notes-unreleased]
+==== Unreleased
+
+- fj-doc-mod-fop, make accessibility and keep empty tags parameters configurable  link:https://github.com/fugerit-org/fj-doc/issues/508[#508]
+
+[#doc-release-notes-8-16-2]
+==== Version 8.16.2 [2025-09-12]
+
+- fj-doc-maven-plugin, updated all flavours version link:https://github.com/fugerit-org/fj-doc/issues/498[#498]
+
+[#doc-release-notes-8-16-1]
+==== Version 8.16.1 [2025-09-01]
+
+- fj-doc-maven-plugin, updated all flavours version link:https://github.com/fugerit-org/fj-doc/issues/494[#494]
+
 [#doc-release-notes-8-16-0]
 ==== Version 8.16.0 [2025-08-22]
 

fj-doc-guide/src/main/docs/asciidoc/chapters/06_2_mod-fop.adoc

@@ -66,12 +66,14 @@ For this DocHandler it is possible to customize some attributes, for instance :
 | *pdf-ua-mode* anchor:doc-handler-mod-fop-pdf-config-pdf-ua-mode[]  | _string_  |  | If present, will set pdf-ua-mode, possible values are : _PDF/UA-1_. link:https://github.com/fugerit-org/fj-doc/issues/52[Partially compatible with pdf-a-mode].
 | *fop-pool-min* anchor:doc-handler-mod-fop-pdf-config-fop-pool-min[]  | _int_  | 0 | If present, it will create a fo user agent pool, this is the minimum size of the pool.
 | *fop-pool-max* anchor:doc-handler-mod-fop-pdf-config-fop-pool-max[]  | _int_  | 0 | If present, it will create a fo user agent pool, this is the maximum size fo the pool.
-| *accessibility* anchor:doc-handler-mod-fop-pdf-config-accessibility[]  | _bool_  | true | fopUserAgent.setAccessibility($value);
-| *keep-empty-tags* anchor:doc-handler-mod-fop-pdf-config-keep-empty-tags[]  | _bool_  | false | fopUserAgent.setKeepEmptyTags($value);
+| *accessibility* anchor:doc-handler-mod-fop-pdf-config-accessibility[]  | _bool_  | true | fopUserAgent.setAccessibility($value); (since 8.16.3)
+| *keep-empty-tags* anchor:doc-handler-mod-fop-pdf-config-keep-empty-tags[]  | _bool_  | false | fopUserAgent.setKeepEmptyTags($value); (since 8.16.3)
 |========================================================================================================================================
 
 NOTE: If *pdf-a-mode* is set, there will be a strict validation of the PDF (i.e. it will be checked if the font are all embedded and the images should comply to link:https://www.adobe.com/uk/acrobat/resources/document-files/pdf-types/pdf-a.html[PDF/A standard]).
 
+TIP: Setting accessibility to 'false' will produce a smaller but less accessible PDF.
+
 [#doc-handler-mod-fop-pdf-config-pdf-a]
 ==== PDF/A DocHandler
 

fj-doc-guide/src/main/docs/asciidoc/chapters/07_008-reducing-fj-doc-mod-fop-pdf-size.adoc

@@ -0,0 +1,33 @@
+
+[#doc-faq-reducing-fj-doc-mod-fop-pdf-size]
+=== Reducing fj-doc-mod-fop PDF size
+
+Module fj-doc-mod-fop is based on link:https://xmlgraphics.apache.org/fop/[Apache FOP].
+
+Sometimes this module can produce relatively big size PF.
+
+Here are some tips to reduce the size.
+
+==== Accessibility
+
+By default, fop user agent has the accessibility flag active.
+
+Since Venus version 8.16.3 it is possible to use the new handler :
+
+[source,java]
+----
+org.fugerit.java.doc.mod.fop.PdfFopTypeNoAccessibilityHandler
+----
+
+Which as the accessibility flag set to 'false' by default.
+
+Alternatively, it is possible to use a new configuration option :
+
+[source,xml]
+----
+<docHandler id="pdf-fop-config" info="pdf" type="org.fugerit.java.doc.mod.fop.PdfFopTypeHandler">
+    <docHandlerCustomConfig charset="UTF-8" accessibility='false'/>
+</docHandler>
+----
+
+Refer to xref:#doc-handler-mod-fop-pdf-config-accessibility[PDF/FO DocHandler] documentation for further info.