Path: blob/main/documentation/content/en/books/accessibility/development/_index.po
18099 views
# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2026-02-22 15:58+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <[email protected]>\n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: YAML Front Matter: description #: documentation/content/en/books/accessibility/development/_index.adoc:1 #, no-wrap msgid "Resources for developers" msgstr "" #. type: YAML Front Matter: part #: documentation/content/en/books/accessibility/development/_index.adoc:1 #, no-wrap msgid "Part II. Vision" msgstr "" #. type: YAML Front Matter: title #: documentation/content/en/books/accessibility/development/_index.adoc:1 #, no-wrap msgid "Chapter 6. Development" msgstr "" #. type: Title = #: documentation/content/en/books/accessibility/development/_index.adoc:14 #, no-wrap msgid "Development" msgstr "" #. type: Title == #: documentation/content/en/books/accessibility/development/_index.adoc:52 #, no-wrap msgid "Introduction" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:55 msgid "" "This chapter provides resources for developers seeking to make their " "programs accessible, test accessibility, and improve the accessibility of " "their software." msgstr "" #. type: Title == #: documentation/content/en/books/accessibility/development/_index.adoc:57 #, no-wrap msgid "Colors" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:61 msgid "" "Do not assume that users can distinguish all (or even any of) the colors " "used in your program. While official statistics on the prevalence of color " "blindness are lacking, it is estimated that approximately 5% of the " "population is affected by some form of it, whether partial or total." msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:63 #, no-wrap msgid "Colors Guidelines" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:68 msgid "" "Avoid using color as the sole means of conveying information. If color must " "be used, provide a straightforward and well-documented method for " "configuring color settings. Where possible, ensure support for the " "`$NO_COLOR` environment variable to accommodate user preferences." msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:70 #, no-wrap msgid "Colors Checker" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:74 msgid "" "The package:graphics/kontrast[] package provides the Kontrast GUI utility to " "check if the color combinations are distinct enough to be readable and " "accessible. To install:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:78 #, no-wrap msgid "# pkg install kontrast\n" msgstr "" #. type: Title == #: documentation/content/en/books/accessibility/development/_index.adoc:81 #, no-wrap msgid "Command Line Interface" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:85 msgid "" "The CLI is generally considered accessible by a screen reader. However, it " "is important to understand some concepts, follow best practices, and avoid " "certain mistakes to ensure an accessible UI." msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:89 msgid "" "Dahlke, Karl. _Command Line Programs for the Blind_. Available at: " "http://www.eklhad.net/philosophy.html. This article discusses the concept " "of presenting information in one dimension and addresses the accessibility " "challenges inherent in programs designed exclusively for sighted users." msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:96 msgid "" "Sampath, H., Merrick, A., & Macvean, A. (2021). Accessibility of Command " "Line Interfaces. In Proceedings of the CHI Conference on Human Factors in " "Computing Systems (CHI '21). ACM. Available at: " "https://dl.acm.org/doi/fullHtml/10.1145/3411764.3445544. This paper " "presents guidelines and common pitfalls to avoid when designing command-line " "interfaces that are accessible to screen reader users." msgstr "" #. type: Title == #: documentation/content/en/books/accessibility/development/_index.adoc:98 #, no-wrap msgid "Libraries" msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:101 #, no-wrap msgid "Gnome" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:105 msgid "" "AT-SPI (Assistive Technology Service Provider Interface), " "package:accessibility/at-spi2-core[], is a framework that establishes a " "communication channel between applications and assistive technologies. To " "install, execute:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:109 #, no-wrap msgid "# pkg install at-spi2-core\n" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:116 msgid "" "AT-SPI offers a wide range of features. For more information, refer to the " "following resources: " "https://gitlab.gnome.org/GNOME/at-spi2-core/-/blob/main/README.md[README], " "https://gnome.pages.gitlab.gnome.org/at-spi2-core/atk/[Atk wiki], " "https://gnome.pages.gitlab.gnome.org/at-spi2-core/libatspi/[AT SPI Wiki], " "and https://wiki.gnome.org/Accessibility[GNOME Accessibility Team Wiki]." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/accessibility/development/_index.adoc:120 msgid "" "Some wrappers are available: package:accessibility/rubygem-atk[] (Ruby), " "package:accessibility/py-atspi[] (Python), and package:accessibility/atkmm[] " "(C++)." msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:123 #, no-wrap msgid "QT" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:129 msgid "" "package:accessibility/libqaccessibilityclient[] establishes a communication " "channel between applications and assistive technologies. In particular, it " "provides a bridge between applications built with Qt and the AT-SPI " "framework crossref:development[devel-at-spi,previously described]. For full " "documentation, refer to the " "https://api.kde.org/libqaccessibilityclient/html/index.html[API Reference] " "and the https://github.com/KDE/libqaccessibilityclient[official " "repository]. To install:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:133 #, no-wrap msgid "# pkg install libqaccessibilityclient\n" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:138 msgid "" "Libraries package:accessibility/qt5-speech[] and " "package:accessibility/qt6-speech[] provide access to a Text-To-Speech " "functionality (specifically to package:accessibility/speech-dispatcher[]). " "Documentation is available at " "https://doc.qt.io/archives/qt-5.15/qtspeech-index.html and " "https://doc.qt.io/qt-6/qttexttospeech-index.html. To install, run:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:143 #, no-wrap msgid "" "# pkg install qt5-speech\n" "# pkg install qt6-speech\n" msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:145 #, no-wrap msgid "Speech Synthesis" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:149 msgid "" "package:accessibility/speech-dispatcher[] provides a simple, high level, and " "device independent layer for access to Speech Synthesizers. To install, " "run:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:153 #, no-wrap msgid "# pkg install speech-dispatcher\n" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:156 msgid "" "For detailed documentation, refer to the official Speech Dispatcher website: " "https://freebsoft.org/speechd." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/accessibility/development/_index.adoc:160 msgid "" "A Python wrapper for the library is provided by the " "package:accessibility/py-speech-dispatcher[]." msgstr "" #. type: Title === #: documentation/content/en/books/accessibility/development/_index.adoc:163 #, no-wrap msgid "Liblouis" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:167 msgid "" "package:devel/liblouis[] provides an API for translating many languages to " "and from Braille. To install, execute:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:171 #, no-wrap msgid "# pkg install liblouis\n" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:174 msgid "" "The library provides many features, " "https://liblouis.io/documentation/[documented on the liblouis project " "website]." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/accessibility/development/_index.adoc:178 msgid "" "Liblouis provides also a Python API, " "https://liblouis.io/documentation/liblouis.html#Python-bindings[Python " "bindings]." msgstr "" #. type: Title == #: documentation/content/en/books/accessibility/development/_index.adoc:181 #, no-wrap msgid "Tools" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:185 msgid "" "package:accessibility/accerciser[] provides an accessibility inspection tool " "for applications developed for the " "extref:{handbook}desktop/#gnome-environment[GNOME] desktop environment. To " "install it, run:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/accessibility/development/_index.adoc:189 #, no-wrap msgid "# pkg install accerciser\n" msgstr "" #. type: Plain text #: documentation/content/en/books/accessibility/development/_index.adoc:193 msgid "" "For detailed usage and features, refer to man:accerciser[1]. Additional " "documentation is available in the " "https://gitlab.gnome.org/GNOME/accerciser/-/blob/master/README.md[REAMDE.md] " "and the " "https://help.gnome.org/users/accerciser/stable/index.html.en[Accerciser User " "Guide]." msgstr ""