Skip to Main Content

DU Library Style Guide

Page Content: Other

Animation

  • Add pause option to any animation that may distract users
  • Do not include flashing content

Attribution

Format

This content is (adapted) from [Author]'s, [Content Title and link].

Example

This content is adapted from Purdue Online Writing Lab (OWL)'s, "On Paragraphs".

Add To Your Guide

  1. Click Add/Reorder
  2. Click Rich Text / HTML
  3. Click Source
  4. Paste:

    <p class="attribution">This content is adapted from Purdue Online Writing Lab (OWL)'s, <a href="https://owl.purdue.edu/owl/general_writing/academic_writing/paragraphs_and_paragraphing/index.html">"On Paragraphs"</a>.</p>

  5. Click Source again to return to the WYSIWYG basic editor
  6. Adjust the text and link to match your own source

Format

This content is (adapted) from [Author]'s, [Content Title with link], licensed under [License Title and link].

Example

This content is from absoluteSteven's, "Vitruvian Man", licensed under CC BY-NC-ND 2.0.

HTML Code

<p class="attribution">This content is from absoluteSteven's, <a href="https://www.flickr.com/photos/15577711@N00/151754333">"Vitruvian Man"</a>, licensed under CC BY-NC-ND 2.0.</p>

Audio

  • Recorded audio must have transcription (or equivalent text).
  • Sound should never play automatically.

Book

Add a Book

Add a Book Video (8 min, 25 sec)

  1. Click Add / Reorder
  2. Select Book from the Catalog
  3. Enter the ISBN to import book information (you can choose to show or delete the ISBN after the book info is imported).
  4. Publication Date: Year only (e.g. 2018)
  5. Description: 1-2 short sentences
  6. Cover Art:
    • Choose Medium - 140px wide
    • If ISBN doesn't populate Cover Art:
      • Under "Cover Art", select "Other"
      • Insert URL of the book cover image you want
        • Find the book cover image (likely in our database or catalog)
        • Right-click the book cover image
        • For Firefox: Choose "Copy Image Location" (for Chrome: "Copy Image Address")
        • Paste the URL into the "Enter Cover Art URL" box
  7. Description Display: Choose your preference
  8. If print book:
    • URL: link to catalog for print book (e.g. https://davenport.kohacatalog.com/cgi-bin/koha/opac-detail.pl?biblionumber=2309)
  9. If e-book:
    1. URL:
      • Use the permanent link provided by the database
      • Link to the full-text of the e-book (e.g. https://a-cloud-igpublish-com.proxy.davenport.edu/iglibrary/search/BEPB0000812.main.html)
    2. Assign Resource Icons: Select e-book icon

E-book Example


Print Book Example

Chat

By default, library chat will appear in every guide:

  1. In the right, bottom (set to animate a wobble 3 times)
  2. In the footer

Both chats appear with 1 and 2 beside them.

Remove Chat

Each guide owner can decide if they want to retain library chat on their guide (the default) or remove it. In general, we recommend all class and subject library guides have it.

To remove the 2 chats on your guide:

  1. Add the tag no_chat to your guide

    Tags with CoT-online and no_chat are shown, with no_chat being highlighted.

Database

Do not use a link for a database.

Instead:

  1. Click "Add/Reorder"
  2. Select "Database"
  3. Find and select the database you want

Icon

  • Use any Font Awesome 4.7 icon
  • Only use icons for decorative effect:
    • icons should not communicate things that aren't spelled out elsewhere on the page
    • for exceptions, contact us
  • Ensure aria-hidden is within the icon HTML:
    • <i class="fas fa-camera-retro" aria-hidden></i>

Image

  • Images of text should never be used in place of actual text
  • Images should always have alt attribute.
  • If your image does not present new content or have a function (i.e., it is purely decorative): 
    • leave alt attribute blank: alt=
  • If your image presents new content and/or has a function, create an alt attribute with these WebAIM: Alternative Text guidelines:
    1. Accurately describe what the image is and/or does (if clicked, for instance)
    2. Be succinct
    3. Don't repeat what is made clear by text elsewhere on the page
    4. Don't use the phrases image of or graphic of.
  • You can insert alt text directly within the Image Manager of LibGuides:
    1. Go to LibApps Image Manager Library
    2. Select the image thumbnail of the image you want to edit
    3. Add your alternate text

      alt text with 'man questioning'

Link

  • Recommended: links should be inserted via the link asset ( Add / Reorder > Link), unless there are reasons to not have the link stand alone or in a list
  • Any link on a page should be uniquely named
    • Ex: Don't have 2 links say "Find more information," while each one leads to a separate page
  • Use precise language to describe the purpose of the link:
    • Good: "More Information on Opposing Viewpoints"
    • Bad: "More Information"
  • If multiple links all lead to the same page, label them identically
    • Ex: Don't have "search this" and "find this" take users to the same page
  • Do not spell out a URL address; add meaningful link text instead (see above)
  • Do not insert e-mail links for library staff. Instead, link to their contact forms (find these links at Library Phone Numbers & E-Mail)
  • Underline links (this is default behavior)
  • Links should not be styled to look like a button
  • Links should always open a new page within the same tab (default behavior). Do not set links to open in a separate tab

When to Open Links in a New Tab

  1. Links on a current davenport libguide that point users to a different davenport libguide should always open in a new tab.
  2. Links found on pages that could potentially interrupt the completion of current content (such as on forms) should always open in a new tab.

Set links to open in a new tab

As a Link Asset

  1. Change Window Target to Open in New Window

In LibGuides Rich Text / HTML (WYSIWYG) Editor

  1. Highlight linked text in LibGuides editor
  2. Click the link icon
  3. Click Target
  4. Set Target as New Window (_blank)
  5. You will know it successfully worked if you see after your link on the public page

Table

Only use tables for simple data display that appears best in a table.

  • Create your table:
    • Required
      1. Click Add / Reorder
      2. Click Rich Text/HTML
      3. Click the Table icon
      4. Choose number of Rows and Columns
      5. Select Headers location(s)
      6. Enter a Caption
    • Optional
      1. Choose Class for styling
  • See WebAIM: Creating Accessible Tables for more details

Video

Caption

  • Recorded video with audio must have captions (see WebAIM: Captions, Transcripts, and Audio Descriptions)
    • When there is dialogue, show who is speaking so the viewer can accurately follow along:
      VADER: If you only knew the power of the dark side. Obi-Wan never told
      you what happened to your father.
      
      LUKE: He told me enough! He told me you killed him.
      
      VADER: No. I am your father.
      
  • If captions can't be used, use a transcript (with headings)

Embed Your Video

  1. If you want your video styled like videos on our video page
    1. Send Brian Holda links to the original videos and the page you want them inserted
  2. Alternatively: Manually add videos
    1. Click Add/Reorder
    2. Click Media / Widget
    3. Name the widget as Video: [Title of Video]
      • Example: Video: Academic Libraries in the Digital Age
    4. Paste your video embed code
    5. Add a title within your video embed code

      Example:

      <iframe title=Video: Academic Libraries in the Digital Age src="https://www.youtube.com/embed/GoLiLvUFS-M"></iframe>

Webpage Suggestion Form

LibGuide owners can choose to insert this form in as many (or few) of their pages as they wish.

Add Webpage Suggestion Form

  1. Click Add Box
  2. Click Reuse Existing Box
  3. Choose Guide: *HomePage/Reusable Page
  4. Choose Box: Webpage Suggestions

Webpage Suggestion Form: