[
https://issues.apache.org/jira/browse/FOP-3294?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Juhani Laiho updated FOP-3294:
------------------------------
Description:
See _Limitations _section on the _Accessibility _documentation page:
https://xmlgraphics.apache.org/fop/2.11/accessibility.html#limitations
bq. The natural language can currently only be specified at the page-sequence
level. The document language is derived from the language of the first
page-sequence. It is currently not possible to override the language inside the
content below the page-sequence level.
This limitation has been in the documentation since at least FOP 1.0 as far as
I can tell:
https://xmlgraphics.apache.org/fop/1.0/accessibility.html
As far as I can tell this limitation has been addressed already in 2012 in the
commit below?
https://github.com/apache/xmlgraphics-fop/commit/d9d2ec28c23c9dc69dd87c1060ea506ad08beca8
Now you can specify the natural language in a block or a character.
There's two test identical FO files about this in the repo:
fop-core\src\test\resources\org\apache\fop\accessibility\fo\language.fo
fop\test\pdf\accessibility\language.fo
Should this limitation be removed from the documentation as obsolete?
12 Feb 2026 additional information:
I generated a PDF from test file language.fo using FOP 2.11:
fop.bat -a -fo language.fo -pdf language-fo.pdf
...and checked the accessibility tags using Acrobat Pro 25.001.21184.0 (Menu >
View > Show/Hide > Side panels > Accessibility tags). It seems that specifying
the language below page-sequence level works on the block level. See screenshot
FOP-3294_language_fo_AcrobatProBlockLangFrFop2-11.png: the parts within red
rectangles on the right all have fr-FR set as their language in Properties.
Also checked the Span of the fo:character F in the last paragraph and it has
the value fr for Language in Properties, so specifying language for
fo:character apparently works as well.
was:
See _Limitations _section on the _Accessibility _documentation page:
https://xmlgraphics.apache.org/fop/2.11/accessibility.html#limitations
bq. The natural language can currently only be specified at the page-sequence
level. The document language is derived from the language of the first
page-sequence. It is currently not possible to override the language inside the
content below the page-sequence level.
This limitation has been in the documentation since at least FOP 1.0 as far as
I can tell:
https://xmlgraphics.apache.org/fop/1.0/accessibility.html
As far as I can tell this limitation has been addressed already in 2012 in the
commit below?
https://github.com/apache/xmlgraphics-fop/commit/d9d2ec28c23c9dc69dd87c1060ea506ad08beca8
Now you can specify the natural language in a block or a character.
There's two test identical FO files about this in the repo:
fop-core\src\test\resources\org\apache\fop\accessibility\fo\language.fo
fop\test\pdf\accessibility\language.fo
Should this limitation be removed from the documentation as obsolete?
> Accessibility limitation regarding specifying language below page-sequence
> level possibly obsolete
> --------------------------------------------------------------------------------------------------
>
> Key: FOP-3294
> URL: https://issues.apache.org/jira/browse/FOP-3294
> Project: FOP
> Issue Type: Bug
> Components: documentation
> Affects Versions: 2.11
> Reporter: Juhani Laiho
> Priority: Minor
> Attachments: FOP-3294_language_fo_AcrobatProBlockLangFrFop2-11.png
>
>
> See _Limitations _section on the _Accessibility _documentation page:
> https://xmlgraphics.apache.org/fop/2.11/accessibility.html#limitations
> bq. The natural language can currently only be specified at the page-sequence
> level. The document language is derived from the language of the first
> page-sequence. It is currently not possible to override the language inside
> the content below the page-sequence level.
> This limitation has been in the documentation since at least FOP 1.0 as far
> as I can tell:
> https://xmlgraphics.apache.org/fop/1.0/accessibility.html
> As far as I can tell this limitation has been addressed already in 2012 in
> the commit below?
> https://github.com/apache/xmlgraphics-fop/commit/d9d2ec28c23c9dc69dd87c1060ea506ad08beca8
> Now you can specify the natural language in a block or a character.
> There's two test identical FO files about this in the repo:
> fop-core\src\test\resources\org\apache\fop\accessibility\fo\language.fo
> fop\test\pdf\accessibility\language.fo
> Should this limitation be removed from the documentation as obsolete?
> 12 Feb 2026 additional information:
> I generated a PDF from test file language.fo using FOP 2.11:
> fop.bat -a -fo language.fo -pdf language-fo.pdf
> ...and checked the accessibility tags using Acrobat Pro 25.001.21184.0 (Menu
> > View > Show/Hide > Side panels > Accessibility tags). It seems that
> specifying the language below page-sequence level works on the block level.
> See screenshot FOP-3294_language_fo_AcrobatProBlockLangFrFop2-11.png: the
> parts within red rectangles on the right all have fr-FR set as their language
> in Properties.
> Also checked the Span of the fo:character F in the last paragraph and it has
> the value fr for Language in Properties, so specifying language for
> fo:character apparently works as well.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)