Skip to Main Content

NOLA ILC Presentation

Useful information and checklist for ensuring the LibGuide you create is accessible to all.

Reminders

Structure and Hierarchy of LibGuides Content

Hierarchy

  • Guide - All guides start with one page. You can add pages and subpages to your guide. 
    • Page / Subpage - Pages and Subpages contain boxes. You do not have to have subpages, but they allow for content organization. This guide uses Pages and Subpages.
      • Boxes - A page has nothing on it until you add a box. There are different types of boxes, and you can have multiple boxes. The box title is the first header on your page, so it should be related to the name of the page.
        • Content - These are the things you put on your guide. LibGuides calls these "assets", and there are different kinds of assets that can be used with different reasons for doing so.

Structure

LibGuides is built using Bootstrap's grid system, and each page is made up of columns and rows. The boxes will always be "read" top-down in column order, meaning that the left-most top box will be read first and everything else in that column before moving to the second column. This is especially evident in the tabbed guide layouts.

Create, Reuse, Copy

There are three ways to add content to a guide: create from scratch, reuse from another source, or copy from another source. LibGuides are meant to be shared, especially from within the same organization. There is no reason for every guide to have a different citation page when you can easily just reuse an existing citation page. 

  • Create - Starting with a completely blank slate, you can create your own guide, pages/subpages, boxes, and content assets.
  • Reuse - You can reuse a page/subpage, box, or asset. This allows you to add something to your guide without having to maintain it everywhere. Reusing something creates a linked version on the page, meaning that you can not edit it on that guide (only the original owner or an admin can edit the item in the same way that if you shared a youtube video). 
  • Copy - You can make a copy of something, which will give you the option to then edit the thing you are reusing. You can do this if you want the layout of a page but need to adjust the specific content, or you want a lot of the content but want to customize the explanation. 

Routine Maintenance Checklist for A11y

Individual Guide Review

Guide information (Everything above the boxes)

  • The title is spelled correctly and accurately describes the content.
  • Consider giving the guide a description. This will help with findability, display within gallery boxes and widgets if desired, and aid non-sighted users in getting a quick understanding of the guide's purpose. 
  • Create a friendly URL.

Page Information 

  • Page names reflect the content.
  • Consider giving the page its own friendly URL
  • Box titles are descriptive of the content. Since box titles are headings, they are part of the navigational structure of a page.

Box Content Review

  • Text
    • color is not the only thing giving instruction 
    • headers are coded correctly
    • lists are coded correctly
    • links are descriptive (do NOT say “click here”)
  • Images
    • alt text is provided
    • Images are adequately explained for screen readers
  • Tables
    • Ensure they are not being used for layout
    • Headers are applied to rows and/or columns as appropriate
  • Embedded Content
    • Videos work, are still the right thing and have closed captioning
  • Documents
    • Content within the document should be accessible.