Skip to content

IBM Equal Access Accessibility Checker contains tools to automate accessibility checking from a browser or in a continuous development/build environment

License

Notifications You must be signed in to change notification settings

IBMa/equal-access

Folders and files

NameName
Last commit message
Last commit date

Latest commit

dd35095 · Oct 25, 2023
Sep 21, 2023
Oct 25, 2023
Oct 19, 2023
Oct 20, 2023
Oct 19, 2023
Sep 26, 2023
May 23, 2023
Sep 19, 2023
Oct 18, 2023
Oct 12, 2023
Apr 27, 2020
May 1, 2023
Jan 12, 2022
Apr 2, 2020
Apr 2, 2020
Apr 2, 2020
Jan 4, 2023
Apr 2, 2020
Apr 2, 2020
Jun 22, 2023
Dec 2, 2022
Jun 21, 2023
Apr 7, 2022

Repository files navigation

equal-access

This Git repository hosts tools and supporting components that are part of the IBM Equal Access Toolkit.

Overview

This README covers topics for users who want to find the deployed tools as well as topics for developers who want to better understand the various components and build the tools.

The wiki contains overview information, links to videos, and other resources.

Usage

The tools have been deployed to the various stores and NPM so they can be easily downloaded and installed:

Requirements

Clone Repository

$ git clone --branch=master https://github.com/IBMa/equal-access.git
$ cd equal-access

or with SSH

$ git clone --branch=master [email protected]:IBMa/equal-access.git
$ cd equal-access

Install dependencies

Under the equal-access directory

npm install

Now you can select the tool you want to build and follow the tool's README instructions located in its sub-directory.

What's in this repository?

Please review the README of the selected tool for more information specific to that tool

Tools

Components

Build

Build all the tools and components from the root directory or build each individual tool separately.

Build all the tools from root directory

cd to equal-access if you are not already in the root directory, then run:

$ npm install
$ npm run build

All the following libraries or tools are built by running the above commands

  • In the equal-access/accessibility-checker-engine/dist directory
    • ace-debug.js: uncompressed javascript to be used in a browser environment for development
    • ace.js: compressed javascript to be used in a browser environment for production
    • ace-node-debug.js: uncompressed javascript library to be used in a NodeJS environment for development
    • ace-node.js: compressed javascript library to be used in a NodeJS environment for production
  • In the equal-access/accessibility-checker/package directory
    • java script source that can be installed or deployed as npm package that works with an HTML parsing engines such as Selenium, Puppeteer, Playwright, or Zombie to allow developers to perform integrated accessibility testing within a continuous integration pipeline such as Travis CI. Please view more details.
  • In the equal-access/karma-accessibility-checker/package directory
    • javascript source that can be used as a Karma plugin, see more details.

Build each individual tool separately

Please check the README for each individual tool for its build instructions:

Feedback and reporting bugs

If you think you've found a bug, have questions or suggestions, open a GitHub Issue. If you are an IBM employee, feel free to ask questions in the IBM internal Slack channel #accessibility-at-ibm.

License

IBM Equal Access Toolkit is released under the Apache-2.0 license