Jump to content

Accessibility Filescan: Difference between revisions

From Swarthmore Knowledge Base
Clarsen3 (talk | contribs)
Clarsen3 (talk | contribs)
m Increasing image size for improved readability
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Accessibility Filescan block was developed to help determine how friendly course PDFs are to assistive technology such as Read&Write, Kurzweil, screen readers, and other tools students might use to help them consume course readings.
The Accessibility Filescan block was developed to help determine how friendly course PDFs are to assistive technology such as Read&Write, Kurzweil, screen readers, and other tools students might use to help them consume course readings.
{{Card
{{Banner
| variant = warning
| variant = info
| icon = information-circle
| title = Note
| title = Note
| content = This tool does not guarantee that a document is fully accessible; it is simply a useful indicator of how much of your course material may be friendly to assistive technology.
| content = This tool does not guarantee that a document is fully accessible; it is simply a useful indicator of how much of your course material may be friendly to assistive technology.
}}
}}


To access the Accessibility Filescan block (and all other blocks), open the "block drawer" on the right of your Moodle course. Please see [[Blocks|Moodle Blocks]] for more thorough information.
To access the Accessibility Filescan block (and all other blocks), open the "block drawer" on the right of your Moodle course. Please see [[Moodle Blocks]] for more thorough information.
[[File:Moodle_block_drawer_location.png|alt=Moodle block drawer location, which is an arrow button on the right side of the screen in a Moodle course.|400x400px|center|frameless]]
[[File:Moodle_block_drawer_location.png|alt=Moodle block drawer location, which is an arrow button on the right side of the screen in a Moodle course.|400x400px|center|frameless]]


Line 12: Line 13:
[[File:accessibility_filescan_block.png|alt=The Accessibility Filescan block displays a pie chart showing the percentage of PDFs that satisfy all checks, some checks, and no checks. There is a Details button and a "last scanned" status below it.|312x312px|center|frameless]]
[[File:accessibility_filescan_block.png|alt=The Accessibility Filescan block displays a pie chart showing the percentage of PDFs that satisfy all checks, some checks, and no checks. There is a Details button and a "last scanned" status below it.|312x312px|center|frameless]]
The Accessibility Filescan tool checks the accessibility of PDFs in a Moodle class and provides a report on the accessibility of each file. The status is either '''Satisfies all checks''', '''Satisfies some checks''', or '''Satisfies no checks'''. A PDF '''fails''' if it does not pass any of the checks. A file is marked as '''check''' if the file passes at least one check but does not meet all checks. A PDF '''passes''' if it meets all the accessibility checks.
The Accessibility Filescan tool checks the accessibility of PDFs in a Moodle class and provides a report on the accessibility of each file. The status is either '''Satisfies all checks''', '''Satisfies some checks''', or '''Satisfies no checks'''. A PDF '''fails''' if it does not pass any of the checks. A file is marked as '''check''' if the file passes at least one check but does not meet all checks. A PDF '''passes''' if it meets all the accessibility checks.
{{Card
{{Banner
| variant = success
| variant = success
| title = Please Use the Accessibility Filescan
| title = Please Use the Accessibility Filescan
Line 19: Line 20:


== What the Tool Checks For ==
== What the Tool Checks For ==
[[File:accessibility_filescan_table.png|alt=Accessibility of Course PDFs details table with a button to download to CSV. File names are listed in one column, followed by four columns with checkmarks or x's indicating whether the files pass the categories Language, Text, Title, and Tagged. A final column displays the PDFs' page counts.|center|442x442px]]
[[File:accessibility_filescan_table.png|alt=Accessibility of Course PDFs details table with a button to download to CSV. File names are listed in one column, followed by four columns with checkmarks or x's indicating whether the files pass the categories Language, Text, Title, and Tagged. A final column displays the PDFs' page counts.|center|829x829px]]


=== Language ===
=== Language ===
Line 62: Line 63:
You can also upload your file to Robobraille's [https://www.robobraille.org/web3/swarthmore/ Alternate media made easy] tool. Multiple documents can be converted at once. You will receive the converted document(s) via email within a few hours.{{Scanning Tips}}
You can also upload your file to Robobraille's [https://www.robobraille.org/web3/swarthmore/ Alternate media made easy] tool. Multiple documents can be converted at once. You will receive the converted document(s) via email within a few hours.{{Scanning Tips}}


To check that your scan was OCR'd, try copying some text from the document and pasting it into Word. If you can successfully paste the text you copied, your document has been OCR'd, but you should check a few things:
To check whether your scan was OCRed, try copying some text from the document and pasting it into Word. If you can successfully paste the text you copied, your document has been OCRed, but you should check a few things:


* If there isn't any text in the document, [https://support.swarthmore.edu/ open a ticket with the help desk] explaining that the Canon copier is not OCRing documents.
* If there isn't any text in the document, [https://support.swarthmore.edu/ open a ticket with the help desk] explaining that the Canon copier you used is not OCRing documents.
* How accurate is the text? If there are significant errors with the accuracy or the reading order, please [https://support.swarthmore.edu/ open a ticket with the help desk] and flag the document for the accessibility team.
* How accurate is the text? If there are significant errors with the accuracy or the reading order, please [https://support.swarthmore.edu/ open a ticket with the help desk] and flag the document for the accessibility team.


=== Setting PDF Title, Language, and Outline ===
=== Setting PDF Title, Language, and Outline ===


The title, language, and outline can often be fixed by using [[Adobe Acrobat & Creative Cloud|Adobe Acrobat DC]]'s "Action Wizard", which can be found in the right sidebar. Look for this icon: [[File:ActionWizard.png|24px|alt=Acrobat Action Wizard Icon]]
The title, language, and outline can often be fixed by using [[Adobe Acrobat & Creative Cloud|Acrobat Pro's]] Make Accessible guided action. Go to All tools > Use guided actions (click on "View more" at the bottom if you don't see it) > Make Accessible.
[[File:Acrobat_DC_Action_Wizard.png|alt=Adobe Acrobat highlighting location of Action Wizard|center|400x400px]]
[[File:Use guided actions tool Acrobat.png|alt=Adobe Acrobat highlighting location of the guided actions tool.|617x617px|left]]
 
[[File:Make Accessible guided action Acrobat.png|alt="Make Accessible" action highlighted at the top of the Use guided actions list in a PDF editing tool|617x617px|center]]
 
<br>
Alternatively, navigate to the '''Tools menu →''' '''Customize''' '''→ Action Wizard'''
== Additional Resources ==
 
One of the first options on the Action Wizard '''Actions List''' is to '''Make Accessible'''. Follow the steps. This will work for about 70% of documents.
 
{{Card
| variant = warning
| title = Quality of the original document is very important
| content = Not all documents can successfully be made accessible. A great deal depends on the quality of the original document ([http://bit.ly/UW-Scanning-Advice consult this guide from the University of Washington] for what makes a high-quality scan). Even if Acrobat successfully translates an image of text to text, it is very important to review the document. Original documents of poor quality, documents that have a lot of notes, marginalia or underlines, and documents with blurred text may result in inaccurate translations and gibberish. If you find this to be the case, please contact [mailto:accessibility@swarthmore.edu accessibility@swarthmore.edu] for assistance in working with your file.
}}
 
== More Information ==
 
The Accessibility Filescan is a very useful tool to use as an '''''indicator''''' of how much of your course material may be friendly to assistive technology. By assistive technology we mean tools like [[Kurzweil 3000|Kurzweil]], [[BeeLine Reader and PDF Viewer|Beeline Reader]], and [[Read&Write|Read&Write]]; screen readers such as VoiceOver, [[NVDA|NVDA]] and [[JAWS|JAWS]]; and various other tools people might use to help them consume course readings.


If you'd like to learn more about accessibility, check out these [https://blogs.swarthmore.edu/its/category/accessibility/ posts on the ITS blog].
If you'd like to learn more about accessibility, check out these [https://blogs.swarthmore.edu/its/category/accessibility/ posts on the ITS blog].


== Bonus Section: using screen readers ==
Below are a few informative videos about the major screen readers:
 
Below are a few informative how-to videos on the major screen readers:
 
* [https://youtu.be/5R-6WvAihms?feature=shared VoiceOver on Desktop [video]]- native screen reader for iOS
* [https://youtu.be/Jao3s_CwdRU?feature=shared NVDA on Desktop [video]] - stands for Non-Visual Desktop Access, only works on Windows
* [https://youtu.be/aQzT_mHRGjk?feature=shared JAWS on Desktop [video]] - stands for Job Access With Speech, only works on Windows, is the most robust and hardest to learn


* [https://youtu.be/5R-6WvAihms?feature=shared <nowiki>VoiceOver [video]</nowiki>]: Native screen reader for macOS and iOS
* [https://youtu.be/Jao3s_CwdRU?feature=shared <nowiki>NVDA [video]</nowiki>]: Stands for Non-Visual Desktop Access; only works on Windows
* [https://youtu.be/aQzT_mHRGjk?feature=shared <nowiki>JAWS [video]</nowiki>]: Stands for Job Access With Speech; only works on Windows; is the most robust


[[Category:Moodle]][[Category:Accessibility]]
[[Category:Moodle Fundamentals]][[Category:Accessibility]]

Latest revision as of 16:18, 23 July 2026

The Accessibility Filescan block was developed to help determine how friendly course PDFs are to assistive technology such as Read&Write, Kurzweil, screen readers, and other tools students might use to help them consume course readings.

To access the Accessibility Filescan block (and all other blocks), open the "block drawer" on the right of your Moodle course. Please see Moodle Blocks for more thorough information.

Moodle block drawer location, which is an arrow button on the right side of the screen in a Moodle course.

The Accessibility Filescan provides a summary report on files in the course. Click the Details button to get more information.

The Accessibility Filescan block displays a pie chart showing the percentage of PDFs that satisfy all checks, some checks, and no checks. There is a Details button and a "last scanned" status below it.

The Accessibility Filescan tool checks the accessibility of PDFs in a Moodle class and provides a report on the accessibility of each file. The status is either Satisfies all checks, Satisfies some checks, or Satisfies no checks. A PDF fails if it does not pass any of the checks. A file is marked as check if the file passes at least one check but does not meet all checks. A PDF passes if it meets all the accessibility checks.

What the Tool Checks For

Accessibility of Course PDFs details table with a button to download to CSV. File names are listed in one column, followed by four columns with checkmarks or x's indicating whether the files pass the categories Language, Text, Title, and Tagged. A final column displays the PDFs' page counts.

Language

A PDF stores information about the language of the document. This is used by screen readers and other assistive devices to ensure proper pronunciation and is particularly important for documents that are in non-English languages. See Changing the global language of an Adobe PDF.

Text

If a PDF does not have selectable text, the file has been scanned as an image. This means that screen readers and other assistive devices will not be able to read the content unless steps are taken to convert the image to text. As of fall 2023, our goal is to strive for green checks under both the "Text" and the "Tagged" columns on all documents (except where files are legitimate images, not images of text).

Title

A PDF stores metadata about the document, including the title of the document. This is different than the file name. Having a clear and accurate title helps assure users that they are reading the correct document. It also helps with findability. If the title is missing from the metadata fields, the PDF will fail this test. See Changing the title of an Adobe PDF.

Tagged

Creating structure in a PDF allows screen readers to easily navigate a document.

For instance, if every section of a document is tagged, a user can quickly jump from one section to the next. Imagine someone looking at a syllabus who could visually scan the document for the section on grading; someone using a screen reader could do the same audibly if the sections are marked correctly.

Documents created in a word processor (Word, Google Docs, Pages) can create structure using the built-in heading styles (e.g., Heading 1, Heading 2). That structure will be saved in the native document format or by saving as a tagged PDF. PDFs created from a scanned document usually do not have outlines because the scanner cannot distinguish between chapters or sections within a document. It can be complex to tag PDFs, and we suggest contacting the accessibility team if you need help.

As of fall 2023, our goal is to strive for green checks under both the "Text" and the "Tagged" columns on all documents (except where files are legitimate images, not images of text).

Symbols

The following symbols are used to display the result of the Accessibility Filescan.

Green check markA green check means the test passed.

Red X symbolA red X means the test failed.

How to Fix PDFs

Check with the Library

Before fixing a document, check with the Library to see if they have the document in an accessible electronic format. This can save a lot of time.

Converting to Text

OCR, or Optical Character Recognition, is a technology that enables you to convert different types of documents—such as scanned paper documents, PDF files, or images captured by a digital camera—into editable and searchable data. Copiers installed by ITS at Swarthmore default using to OCR.

However, if you need to execute OCR, you can use Adobe Acrobat Pro to convert the material.

  1. Open the document in Adobe Acrobat Pro.
  2. Open the Tools tab.
  3. Select Scan & OCR.
  4. Select Recognize Text.
  5. Choose the relevant settings, such as language.
  6. Click on the Recognize Text button.

For more details, explore Adobe's article How to scan and get text from an image with OCR.

You can also upload your file to Robobraille's Alternate media made easy tool. Multiple documents can be converted at once. You will receive the converted document(s) via email within a few hours.

To check whether your scan was OCRed, try copying some text from the document and pasting it into Word. If you can successfully paste the text you copied, your document has been OCRed, but you should check a few things:

  • If there isn't any text in the document, open a ticket with the help desk explaining that the Canon copier you used is not OCRing documents.
  • How accurate is the text? If there are significant errors with the accuracy or the reading order, please open a ticket with the help desk and flag the document for the accessibility team.

Setting PDF Title, Language, and Outline

The title, language, and outline can often be fixed by using Acrobat Pro's Make Accessible guided action. Go to All tools > Use guided actions (click on "View more" at the bottom if you don't see it) > Make Accessible.

Adobe Acrobat highlighting location of the guided actions tool.
"Make Accessible" action highlighted at the top of the Use guided actions list in a PDF editing tool


Additional Resources

If you'd like to learn more about accessibility, check out these posts on the ITS blog.

Below are a few informative videos about the major screen readers:

  • VoiceOver [video]: Native screen reader for macOS and iOS
  • NVDA [video]: Stands for Non-Visual Desktop Access; only works on Windows
  • JAWS [video]: Stands for Job Access With Speech; only works on Windows; is the most robust