Skip to content
** Codeland Workshop **
HTML CSS JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
js
styles
README.md
blog.html
contact.html
index.html

README.md

Web Accessibility Workshop: The Building Blocks

Purpose

This repo has been developed as part of an in-person web accessibility workshop. This is the hands-on portion, developed to help teach the building blocks of web accessibility through the completion of mini-exercises. Each exercise exposes a new method for improving the usability of the demo site provided in this repo.

The demo site is not accessible in many ways. Through the completion of mini-exercises, workshop participants improve the accessibility of the demo site and work to debug issues and find solutions for common accessibility problems. The presentation slides provide more context, detailing the mini-exercises to be completed with code samples as guidance and additional resources for self-exploration.

Presentation Slides

Presentation slides are available at https://docs.google.com/presentation/d/1WToCHudhUgJsmPq0N11Nm0wDAYmAHkce50n812dD810.

Dependencies

All required files are included in the repo. This project utilizes jQuery, HTML5, and CSS.

Suggested Tooling/System Requirements

MAMP/LAMP (our server):

VoiceOver/NVDA/Orca (our screen reader):

A text editor of your choosing:

Installation Steps/Guides

MAMP (Mac) Installation Steps

Step 1

Go to MAMP download page at mamp.info/en/downloads. Select the "MAMP & MAMP PRO" version you want to download (Mac version circled in red).

MAMP download page highlighting the Mac download button

Step 2

Once the download is complete, double-click the installer .pkg file to start the installation process.

MAMP install screen highlighting continue button

Step 3 (optional)

If you haven't already, download or clone this project repo (option to download zip file circled in red).

Browser highlighting project github URL and download zip button

Step 4 (optional)

If you downloaded the project as a zip file, unzip it.

Screenshot pointing to project zip file

Step 5

Open MAMP application. On Mac, the application will be located inside a MAMP directory within the Applications directory.

Screenshot pointing to MAMP installation

Step 6

Once MAMP is open, select the MAMP tab from the menu options and then select Preferences. This will open the Preferences window.

From the Preferences window, select the Web Server tab. From there, click on the "Select" button and locate the unzipped project folder. Select the project folder, click the "Select" button and then confirm your selection using the "Ok" button.

Step 7

Once you're back on the main MAMP screen, select the "Start Servers" button. This will launch a new browser window pointing to localhost:8888/. If the browser window doesn't automatically open, use any browser and enter the URL localhost:8888/ to view the project.

MAMP (Windows) Installation Steps

Step-by-Step instructions available at https://documentation.mamp.info/en/MAMP-Windows/Installation/.

LAMP Installation Steps

We're using AAMPS on Linux for this setup. An installation guide is available at http://www.ampps.com/LAMP. There's also a wiki available at https://ampps.com/wiki/Installing_AMPPS_on_Linux.

VoiceOver

VoiceOver comes preinstalled on Mac. To activate VoiceOver:

  • Open System Preferences,
  • Select Accessibility,
  • Select VoiceOver from the menu on the left (under Vision),
  • Select "Enable VoiceOver"

Check out the WebAIM "Using VoiceOver to Evaluate Web Accessibility" guide available at https://webaim.org/articles/voiceover for tips on using VoiceOver.

NVDA

A "Getting and Setting up NVDA guide" is available at https://www.nvaccess.org/files/nvda/documentation/userGuide.html?#GettingAndSettingUpNVDA.

Check out the WebAIM "Using NVDA to Evaluate Web Accessibility" guide available at https://webaim.org/articles/nvda/.

Orca

Orca provides a "Getting Started" guide at https://help.gnome.org/users/orca/stable/index.html.en.

You can’t perform that action at this time.