Content Comparison

Go out and test with your users!

Validating the EPUB package

Validation is very vital and should not be ignored. The pagina EPUB-Checker and the DAISY-ACE are open-source tools used in the validation of EPUB files.

Validating Using the  Pagina EPUB-Checker

OCF container structure, OPF and OPS mark-up, and internal reference consistency are checked using the tool.

To validate the Book+X.epub file:

1. Launch the pagina EPUB-Checker
2. Click on "Choose EPUB file" to open the explorer.                                                                                                                          Image Added
3. Navigate to the location on where you were working on template, and select the EPUB file that was generated by the eCanCrusher.          Image Added
4. Click "Open" to initiate the validation. Wait for the validation result.
5. If the epub is not valid, the errors/warnings will be displayed with the location of the file generating the error specified.
6. DELETE the EPUB file you validated and REPEAT the process from the STEP 4 after making the changes. Validate the EPUB iteratively until all issues have been resolved.
7. If the EPUB is valid, this is the screen you expect to see:                            Image Added

Validating Using the DAISY-ACE

Ace, the Accessibility Checker for EPUB, is a tool developed by the DAISY Consortium to assist with the evaluation of accessibility features of EPUB publications.

To check Book_X.epub with the DAISY ACE:

1. Create a folder and name it "Ace_Report" in the /Book_X/ directory.                                                                                                 Image Added
2. Launch the terminal, if in Windows OS, press WINDOWS_LOGO_KEY + R keys
3. Once the Run dialog box opens, type cmd.                                                                                                                                                                                                                      Image Added
4. Press OK to launch the program.
5. Navigate into the  /Book_X/Ace_Report/Book_X.epub location via the terminal.                                                                                                                                                                 Image Added

6. Run the command below. You can specify the directory for Ace to store its output with the --outdir option (which is the Ace_Report folder we created) 

   Code Block
   language bash theme DJango title item-id
   ace --outdir "Ace_Report" "Book_X.epub"

   
   

   Note
   title Note
   if you do not specify a directory with --outdir, no reports get saved. You would only see output in the shell.

   
   

7. Press ENTER on the keyboard.
8. The terminal will show the progress of the validation. On completion, the information will read done.                                                                                                       Image Added
9. Switch back to the File Explorer window and navigate into the Ace_Report folder.                                                                                                                                 Image Added
10. Open the report.html file using the browser of your choice to view the Ace report.                                                               Image Added
11. The summary of violations, the outline, book metadata and images can be viewed in a readable format.   Image Added

Congratulations, you completed created an accessible EPUB. You can test the image descriptions using the NVDA software while using the VitalSource Bookshelf.

Version 1.2