Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents


What is it?

Blackboard Ally is a plugin for Moodle that uses machine algorithms to provides students and staff with alternative file formats for common file types stored within Moodle.

...

Ally also provides a course report, which scores the accessibility of all the content on a Moodle course. From the report, you can see all the issues Ally has flagged, and you can hone in on a specific issue or document to work through using Ally's guidance. 

Why use it?

Accessible content benefits all students and staff at UCL. Ally will allow students with specific needs to access formats essential to their learning, whilst giving all students more control over how they access the content. It will also assist staff in improving the accessibility of their content, and assist UCL in meeting its legal obligations set out in the UK's The Public Sector Bodies (Website and Mobile Applications) Accessibility Regulations (2018)

Who can use it?

Tutors and Course Administrators will have access to Ally's scoring and feedback on the accessibility of common files that they upload to Moodle.

...

Info

Ally's scoring or feedback is only available to Tutors and Course Administrators. It is not visible to students.

How do I access Ally for a specific file?

Ally will run automatically within Moodle. Staff can upload content as normal and will have the option to use Ally's available alternative formats and Ally's accessibility guidance.

When a resource is added, a fuel gauge icon and a download arrow will be displayed next to the file name. Clicking on the fuel gauge icon will open up the file alongside guidance, clicking on the download arrow icon will open up a menu of alternative formats.

Staff will see a fuel gauge icon, which indicates the accessibility of a file, which, if clicked, will open up Ally's accessibility guidance. Staff will also see a download arrow icon, which, if clicked, will open up a menu of alternative formats.

What do the Ally scores mean?

Ally's score is based on the accessibility of the file, such as the file's structure, use of heading styles, the use of alternative text for images, and colour contrast. To see all the factors Ally considers, see the Ally Accessibility Checklist.  

...

To learn more, you can watch Digital Education's Ally accessibility guidance video guide (4m 51s). Alternatively, please read Ally's Instructor Feedback Panel guide. 



What alternative formats can Ally produce?

Ally can provide alternative formats for the following file formats:

...

  • Tagged PDF (currently for Word, Powerpoint and OpenOffice/LibreOffice files)
  • Audio (mp3)
  • ePub
  • Electronic Braille
  • Semantic HTML
  • BeeLine Reader format (adds a colour gradient to make reading a document quicker and easier)
  • OCR’d version for scanned documents (Note. The quality of OCR conversion is limited)

How do staff and students access alternative formats? 

Staff and students can download alternative formats by clicking the download arrow icon. The icon will only appear next to files where alternative formats are available. 

...

Watch Digital Education's Alternative format video guide (3m 2s) for an introduction to Ally's alternative formats.


How do I view Ally's course report?

You can view Ally's accessibility report on your Moodle course by going to your course and clicking Accessibility report under the Navigation block. You can also view the report in the Administration block, by clicking Reports and then Accessibility report.

...

Expand
titleLearn more about the HTML issues Ally identifies

What Moodle content can Ally identify?

HTML issue

How this helps you?

Who is affected?
The HTML content contains images without a description.Can be used to identify images on Moodle without alternative descriptive text.Students using screen readers.

The HTML content has contrast issues.

Helpful for identifying where you have used text-colour or highlighting with insufficient contrast.

You can learn more about colour contrast on Digital Education's Visuals and use of colour guidance (https://www.ucl.ac.uk/isd/services/websites-apps/creating-accessible-content/visuals-and-use-colour)

All students.

The HTML content has empty headings.

Can be useful for cleaning up text editor HTML and deleting "junk code" e.g. empty header tags.

Students using screen readers.

The HTML content has malformed lists.

Can be useful in identifying lists which have inconsistent formatting e.g a list with different icons and inconsistent levels of bullet points.

All students

The HTML content contains links without discernible text.

Can be useful for identifying links which have been coded into Moodle but don’t have descriptive text. These links are likely to be old links that haven't been removed from Moodle correctly.

Students using screen readers.

The HTML content has tables that don't have any headers.

Can be useful for identifying tables without heading formatting.

Tables created in Moodle will have table heading format by default.

Students using screen readers.

The HTML's heading structure does not start at the right level.

Ignore, as this issue is caused by how Ally reads Moodle content. The flag is likely to be discontinued by Ally as it generates false positives.

N/A

The HTML content does not have a language set.

Primarily to do with SCORM packages. Check with your SCORM developer.

Check with your SCORM developer.

The HTML content is missing a title.

Primarily to do with SCORM packages. Check with your SCORM developer.

Check with your SCORM developer.

How can I clean up HTML content?

There are two key ways to clean up HTML content in Moodle:

  1. Copy and paste Moodle content to and from a text editor

    One way to tidy up HTML code in Moodle is to copy and paste your Moodle text to a text editor, such as Notepad. This will strip out any formatting.

    You can then copy and paste the text back into Moodle, and reformat it. Limiting your formatting is advisable in order to avoid error and to keep content easier to maintain.


  2. Edit Moodle HTML directly

Whenever you write content in Moodle's text editor, HTML is created.

If you have a firm grasp of HTML, in certain circumstances you may find it easier to edit the HTML formatting rather than use the text editor.


Warning
titleHTML warning

Note. Only proceed if you are familiar with HTML code, and even then make sure to save the text you are editing.

To access the HTML of your content, simply edit the section, and above the text editor click the HTML icon.

...

  • Ally's alternative formats will only be as accessible as the original source file. You should therefore always ensure you follow accessible practice when creating your source file.
  • It is almost always easier to edit the source file for accessibility than editing a PDF version of a file.
  • Ally's accessibility check does not evaluate the quality of alt text provided.
  • Ally does not flag the reading order of document elements. If set incorrectly, the audio alternative format may have content that is read out in the wrong order. Microsoft Office's accessibility checker does check and flag reading order so should be used. 
  • Blackboard has been made aware that the colour scheme of the score indicator (Red, Orange and Green) is not entirely accessible.  
  • There can be some delay in generating alternative formats the first time it is requested, especially for large files. Once the alternative format is generated it becomes accessible to other staff and students and should be much quicker to download.
  • Ally does not keep a copy of any of your files, they remain in Moodle. 

Examples

  • Coming soon

Questions & Answers

How do I improve the accessibility of a PDF file if I don't have access to the original source file?

If you don't have access to the original source file, you can open a PDF with Microsoft Word and it will convert the PDF to an editable Word document. Make sure to check the converted document thoroughly as errors can occur. Save the document as a word file to ensure you can use Word's editing tools.

...

When you re-save the document as PDF, ensure that tags for accessibility are included in the converted file. For more information on creating accessible PDFs see Digital Education's PDF document guidance.

Ally has flagged one of my documents with the message 'This PDF does not have a language set'. How do I fix this?

The best way to resolve this issue is to access the original file before it was converted to PDF. If you don't have access to the original file, open the PDF with Microsoft Word to convert the PDF to an editable Word document. Make sure to check the converted document thoroughly as errors can occur from the conversion process. Save the document as a word file to ensure you can use Word's editing tools.

...

Alternatively, if you have access to Adobe Pro, Adobe provides the following guidance on how to set document language

Known Issues

IssueWorkaround
Ally is unable to provide an accessibility score on files that are contained within multiple Moodle folders. It can only read one level.Where possible limit the use of multiple levels of folders on Moodle.

Further Information

The Blackboard Ally website provides a Quick Start guide, and specific guidance on Alternative Formats and Accessibility Scores.

...