AllLangHelp_swriter.mk | 1 source/text/shared/guide/accessibility.xhp | 10 +-- source/text/swriter/01/accessibility_check.xhp | 82 +++++++++++++++++++++++++ 3 files changed, 89 insertions(+), 4 deletions(-)
New commits: commit e02e75de71eed2d22a4ad4bb18bbfb1f60aa5480 Author: Olivier Hallot <[email protected]> AuthorDate: Mon Sep 6 13:36:47 2021 -0300 Commit: Olivier Hallot <[email protected]> CommitDate: Tue Sep 7 14:02:45 2021 +0200 tdf#144332 Add Help page for Accessibility Check Tool Change-Id: Ifdca4c17a5f2f97d27cd59e65b1855abb2d243f6 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/121731 Tested-by: Jenkins Reviewed-by: Olivier Hallot <[email protected]> diff --git a/AllLangHelp_swriter.mk b/AllLangHelp_swriter.mk index a23f3136e..a92668e64 100644 --- a/AllLangHelp_swriter.mk +++ b/AllLangHelp_swriter.mk @@ -176,6 +176,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,swriter,\ helpcontent2/source/text/swriter/01/06220000 \ helpcontent2/source/text/swriter/01/06990000 \ helpcontent2/source/text/swriter/01/edit_reference_submenu \ + helpcontent2/source/text/swriter/01/accessibility_check \ helpcontent2/source/text/swriter/01/format_object \ helpcontent2/source/text/swriter/01/legacynumbering \ helpcontent2/source/text/swriter/01/mailmerge00 \ diff --git a/source/text/shared/guide/accessibility.xhp b/source/text/shared/guide/accessibility.xhp index 7c9fc5022..248de3bae 100644 --- a/source/text/shared/guide/accessibility.xhp +++ b/source/text/shared/guide/accessibility.xhp @@ -1,6 +1,4 @@ <?xml version="1.0" encoding="UTF-8"?> - - <!-- * This file is part of the LibreOffice project. * @@ -26,7 +24,10 @@ </topic> </meta> <body> - <bookmark xml-lang="en-US" branch="index" id="bm_id3150502"><bookmark_value>accessibility; %PRODUCTNAME features</bookmark_value></bookmark><paragraph id="hd_id3150502" role="heading" level="1" xml-lang="en-US"><variable id="accessibility"><link name="Accessibility in %PRODUCTNAME" href="text/shared/guide/accessibility.xhp">Accessibility in <item type="productname">%PRODUCTNAME</item></link></variable></paragraph> + <bookmark xml-lang="en-US" branch="index" id="bm_id3150502"> +<bookmark_value>accessibility; %PRODUCTNAME features</bookmark_value> +</bookmark> + <h1 id="hd_id3150502"><variable id="accessibility"><link name="Accessibility in %PRODUCTNAME" href="text/shared/guide/accessibility.xhp">Accessibility in <item type="productname">%PRODUCTNAME</item></link></variable></h1> <paragraph xml-lang="en-US" role="paragraph" id="par_id3154894">The following accessibility features are part of <item type="productname">%PRODUCTNAME</item>:</paragraph> <list type="unordered"> <listitem> @@ -43,7 +44,7 @@ <paragraph xml-lang="en-US" role="listitem" id="par_id3145071">The user interface is scalable through your <switchinline select="sys"><caseinline select="UNIX">Window Manager</caseinline><defaultinline>operating system</defaultinline></switchinline> settings. The default font size for dialogs is 12pt, corresponding to a scale of 100%. You can also change the font size for dialogs in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - <item type="productname">%PRODUCTNAME</item> - View</emph>. The zoom factor of a document can be changed in <emph>View - Zoom</emph>, or by double-clicking the zoom factor displayed in the Status Bar.</paragraph> </listitem> </list> - <paragraph role="note" id="par_id3152349" xml-lang="en-US">Please note that accessibility support relies on Java technology for communications with assistive technology tools. This means that the first program startup may take a few seconds longer, because the Java runtime environment has to be started as well.</paragraph> + <note id="par_id3152349">Please note that accessibility support relies on Java technology for communications with assistive technology tools. This means that the first program startup may take a few seconds longer, because the Java runtime environment has to be started as well.</note> <section id="relatedtopics"> <embed href="text/shared/guide/assistive.xhp#assistive"/> <paragraph role="paragraph" id="par_id3149578" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link name="%PRODUCTNAME - View" href="text/shared/optionen/01010800.xhp"><item type="productname">%PRODUCTNAME</item> - View</link></paragraph> @@ -51,6 +52,7 @@ <paragraph role="paragraph" id="par_id3150771" xml-lang="en-US"><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link name="%PRODUCTNAME - Accessibility" href="text/shared/optionen/01013000.xhp"><item type="productname">%PRODUCTNAME</item> - Accessibility</link></paragraph> <embed href="text/shared/guide/keyboard.xhp#keyboard"/> <embed href="text/shared/04/01010000.xhp#common_keys"/> + <embed href="text/swriter/01/accessibility_check.xhp#accessibilitycheckh1"/> </section> </body> </helpdocument> diff --git a/source/text/swriter/01/accessibility_check.xhp b/source/text/swriter/01/accessibility_check.xhp new file mode 100644 index 000000000..e887a02bb --- /dev/null +++ b/source/text/swriter/01/accessibility_check.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="accesibilitycheck" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">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_value>accessibility;check in text document</bookmark_value> + <bookmark_value>PDF/UA;ckeck</bookmark_value> +</bookmark> +<section id="acessibilitycheckheading"> + <bookmark id="bm_id541630940172826" xml-lang="en-US" branch="hid//svx/ui/acessibilitycheckdialog/@@nowidget@@" localize="false"/> + <h1 id="hd_id771630940172827"><variable id="accessibilitycheckh1"><link href="text/swriter/01/accessibility_check.xhp" name="Accessibility Check">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> +</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> +</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_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> +</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> +</listitem> +<listitem> + <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 tables don't include splits or merges, which aren't allowed by the specifications.</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> +</listitem> +<listitem> + <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> +</listitem> +<listitem> + <paragraph id="par_id781630942005022" role="listitem">Check for blinking text, discouraged for the obvious reasons.</paragraph> +</listitem> +<listitem> + <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> +</listitem> +<listitem> + <paragraph id="par_id221630942064725" role="listitem">Check, if text conveys additional meaning with (direct) formatting.</paragraph> +</listitem> +</list> +<section id="relatedtopics"> +<embed href="text/shared/guide/accessibility.xhp#accessibility"/> +</section> +</body> +</helpdocument>
