source/text/swriter/00/00000406.xhp | 10 +++++
source/text/swriter/01/accessibility_check.xhp | 46 +++++++++++++------------
2 files changed, 34 insertions(+), 22 deletions(-)
New commits:
commit 126c955770bfbf8cbc60d77068b3a8b9db6a0aa0
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Fri Sep 29 17:43:10 2023 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Sat Sep 30 12:23:25 2023 +0200
Update A11y check Help page
Change-Id: Id4cb2142bc53e48287bd6202388d3a5e228b0c7d
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/157412
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/swriter/00/00000406.xhp
b/source/text/swriter/00/00000406.xhp
index 751de7efa9..bc8cd2ebf0 100644
--- a/source/text/swriter/00/00000406.xhp
+++ b/source/text/swriter/00/00000406.xhp
@@ -30,6 +30,16 @@
<h1 id="hd_id3154279">Tools Menu</h1>
<paragraph id="par_id3150710" role="paragraph" xml-lang="en-US"><variable
id="silbentrennung">Choose <emph>Tools - Language -
Hyphenation</emph></variable></paragraph>
+<section id="accessibilitycheck">
+ <embed href="text/shared/00/00000004.xhp#from_menu_bar"/>
+ <paragraph role="paragraph" id="par_id311630940367510">Choose
<menuitem>Tools - Accessibility Check</menuitem>.</paragraph>
+ <paragraph role="paragraph" id="par_id521630941308319">Select <menuitem>File
- Export as PDF - General - Universal Accessibility (PDF/UA)</menuitem> and
click <emph>OK</emph>.</paragraph>
+ <embed href="text/shared/00/00000004.xhp#from_keyboard"/>
+ <paragraph role="paragraph" id="par_id61696013981895"><switchinline
select="sys"><caseinline
select="MAC"><keycode>Option</keycode></caseinline><defaultinline><keycode>Alt</keycode></defaultinline></switchinline><keycode>
+ 8</keycode></paragraph>
+ <embed href="text/shared/00/00000004.xhp#from_sidebar"/>
+ <paragraph role="paragraph" id="par_id101696013926218">Open the
<menuitem>Accessibility Check</menuitem> panel.</paragraph>
+</section>
+
<section id="wordcount1">
<embed href="text/shared/00/00000004.xhp#from_menu_bar"/>
<paragraph id="par_idN105A1" role="paragraph" xml-lang="en-US"><variable
id="wordcount">Choose <emph>Tools - Word Count</emph></variable></paragraph>
diff --git a/source/text/swriter/01/accessibility_check.xhp
b/source/text/swriter/01/accessibility_check.xhp
index dc646fd669..b643db53f1 100644
--- a/source/text/swriter/01/accessibility_check.xhp
+++ b/source/text/swriter/01/accessibility_check.xhp
@@ -11,69 +11,71 @@
<meta>
<topic id="accessibilitycheck" indexer="include" status="PUBLISH">
- <title id="tit" xml-lang="en-US">Accessibility Check</title>
+ <title id="tit">Accessibility Check</title>
<filename>/text/swriter/01/accessibility_check.xhp</filename>
</topic>
</meta>
<body>
-<bookmark xml-lang="en-US" branch="index" id="bm_id551630942369429">
+<bookmark branch="index" id="bm_id551630942369429">
<bookmark_value>accessibility;check in text document</bookmark_value>
<bookmark_value>PDF/UA;check</bookmark_value>
</bookmark>
-<bookmark id="bm_id541630940172937" xml-lang="en-US"
branch="hid/svx/ui/accessibilitycheckdialog/dialogButtons" localize="false"/>
-<bookmark id="bm_id541630940172826" xml-lang="en-US"
branch="hid/svx/ui/accessibilitycheckdialog/@@nowidget@@" localize="false"/>
+<bookmark branch="hid/.uno:SidebarDeck.A11yCheckDeck" id="bm_id91696013704838"
localize="false"/>
+<bookmark id="bm_id541630940172937"
branch="hid/svx/ui/accessibilitycheckdialog/dialogButtons" localize="false"/>
+<bookmark id="bm_id541630940172826"
branch="hid/svx/ui/accessibilitycheckdialog/@@nowidget@@" localize="false"/>
<section id="accessibilitycheckheading">
<h1 id="hd_id771630940172827"><variable id="accessibilitycheckh1"><link
href="text/swriter/01/accessibility_check.xhp">Accessibility
Check</link></variable></h1>
- <paragraph id="par_id951630940172830" role="paragraph"
xml-lang="en-US">Review common accessibility problems in the document, and
support for PDF/UA specifications in the PDF export dialog.</paragraph>
+ <paragraph id="par_id951630940172830" role="paragraph">Review common
accessibility problems in the document, and support for PDF/UA specifications
in the PDF export dialog.</paragraph>
</section>
+
<section id="howtoget">
-<paragraph role="paragraph" id="par_id311630940367510">Choose <menuitem>Tools
- Accessibility Check</menuitem>.</paragraph>
-<paragraph role="paragraph" id="par_id521630941308319">Select <menuitem>File -
Export as PDF - General - Universal Accessibility (PDF/UA)</menuitem> and click
<emph>OK</emph>.</paragraph>
+ <embed href="text/swriter/00/00000406.xhp#accessibilitycheck"/>
</section>
<paragraph role="paragraph" id="par_id901630941406987">The Accessibility Check
tool traverses the document structure and gather all possible accessibility
issues. The check can be run manually through the menu or it will be triggered
after PDF export dialog, when the PDF/UA support is enabled.</paragraph>
-<h2 id="hd_id271630943848307">The Accessibility Check dialog</h2>
-<paragraph role="paragraph" id="par_id681630943858371">The Accessibility Check
dialog shows a list of all issues found in the text document.</paragraph>
-<h3 id="hd_id841630943833924">Go to Issue</h3>
-<paragraph role="paragraph" id="par_id41630943863594">Click the button to jump
to the page and select the object or issue that requires attention for
accessibility.</paragraph>
+<h2 id="hd_id271630943848307">The Accessibility Check Panel on Sidebar</h2>
+<paragraph role="paragraph" id="par_id681630943858371">The Accessibility Check
panel on sidebar shows a list of all issues found in the text
document.</paragraph>
+<paragraph role="paragraph" id="par_id611696018066788">Links are provided to
navigate to the issue immediately. Double click the link to jump and select the
object with the accessibility issue.</paragraph>
+<h3 id="hd_id841630943833924">Fix button</h3>
+<paragraph role="paragraph" id="par_id41630943863594">Click the Fix button to
jump to the issue and provide commands to fix it.</paragraph>
<h2 id="hd_id121630943721145">Common accessibility checks</h2>
<paragraph role="paragraph" id="par_id31630941412046">The checks that are
currently implemented are:</paragraph>
<list type="unordered">
<listitem>
- <paragraph id="par_id191630941836904" role="listitem">Check that the
document title is set.</paragraph>
+ <paragraph id="par_id191630941836904" role="listitem">Check that the
document title is set.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id1001630941860410" role="listitem">Check that the
document language is set, or that all styles that are in use, have the language
set.</paragraph>
+ <paragraph id="par_id1001630941860410" role="listitem">Check that the
document language is set, or that all styles that are in use, have the language
set.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id1001630941880414" role="listitem">Check all images,
graphics, OLE objects for the alt (or title in some objects) text.</paragraph>
+ <paragraph id="par_id1001630941880414" role="listitem">Check all images,
graphics, OLE objects for the alt (or title in some objects) text.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id491630941907745" role="listitem">Check that tables
do not include split or merged cells, which could be disorienting for users
with visual impairments.</paragraph>
+ <paragraph id="par_id491630941907745" role="listitem">Check that tables do
not include split or merged cells, which could be disorienting for users with
visual impairments.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id901630941949974" role="listitem">Check for
fake/manual numbering (not using integrated numbering). For example writing
"1." "2." "3." at the beginning of the paragraphs.</paragraph>
+ <paragraph id="par_id901630941949974" role="listitem">Check for
fake/manual numbering (not using integrated numbering). For example writing
"1." "2." "3." at the beginning of the paragraphs.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id981630941970321" role="listitem">Check that
hyperlink text is not a hyperlink itself - hyperlink should be
described.</paragraph>
+ <paragraph id="par_id981630941970321" role="listitem">Check that hyperlink
text is not a hyperlink itself - hyperlink should be described.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id421630941989099" role="listitem">Check for the
contrast between text and the background. The algorithm is described in the
WCAG specification.</paragraph>
+ <paragraph id="par_id421630941989099" role="listitem">Check for the
contrast between text and the background. The algorithm is described in the
WCAG specification.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id781630942005022" role="listitem">Check for blinking
text, which can be problematic for people with cognitive disabilities or
photosensitive epilepsy.</paragraph>
+ <paragraph id="par_id781630942005022" role="listitem">Check for blinking
text, which can be problematic for people with cognitive disabilities or
photosensitive epilepsy.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id651630942022847" role="listitem">Check for footnotes
and endnotes, which should be avoided.</paragraph>
+ <paragraph id="par_id651630942022847" role="listitem">Check for footnotes
and endnotes, which should be avoided.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id531630942039864" role="listitem">Check for heading
order. Order of the headings must increase incrementally with no skips (for
example Heading 1 to Heading 3, skipping Heading 2).</paragraph>
+ <paragraph id="par_id531630942039864" role="listitem">Check for heading
order. Order of the headings must increase incrementally with no skips (for
example Heading 1 to Heading 3, skipping Heading 2).</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id221630942064725" role="listitem">Check, if text
conveys additional meaning with (direct) formatting.</paragraph>
+ <paragraph id="par_id221630942064725" role="listitem">Check, if text
conveys additional meaning with (direct) formatting.</paragraph>
</listitem>
</list>
<section id="relatedtopics">
