Skip to content

Introduction to building accessible websites with Drupal.

License

Notifications You must be signed in to change notification settings

mediacurrent/a11y-training

Repository files navigation

Introduction to Web Accessibility

A hands-on training workshop by Mediacurrent

We have put together a training environment that will help you with the hands-on part of this course. The training environment is made of a Drupal website which includes basic functionality and elements for testing accessibility.

Requirements

This project requires the following tools to be installed:

  • Docker: You can install Docker in your Mac, Windows, or Linux environment.
  • DDev: This will help us automate the process of building a drupal website.

Build your environment

Building your training environment requires mimimal interaction with a command line tool like terminal on a mac, or power shell on windows.

  1. Open your command line tool and change to a directory where you want to setup your environment (i.e. cd /Sites or cd /Documents, etc.)

  2. Clone this repo by typing

    git clone git@github.com:mediacurrent/a11y-training.git

    This will download all the files from the repository and will create a new folder called a11y-training.

  3. Change into the new directory created by the repo and start DDEV

    cd a11y-training

    ddev start

    This will install your drupal website and enable all required modules. This process could take a few minutes.

  4. Import the custom database
    IMPORTANT: We've included a copy of a starter database in this repo to simplify the training process and avoid having to do a site install. You should never commit a database in your own projects.

    ddev import-db --src=mysql/dev-starter-db.sql.gz

    After the database is imported, it will run a database update, clear the cache, and provide a user login link via Drush.

  • Alternatively, you can log into the site through the Drupal UI, http://a11y-training.ddev.site/user. Username - a11y, password = a11y

  • Or, you can also log in via drush: ddev . drush uli

Using Drush

With ddev, you can execute drush commands with ddev . drush <command>, where <command> is the actual drush command you want to run like status or cache-rebuild. The . (period), is shorthand for exec (such as ddev exec drush cr).