Skip to Main Content

Style Guide & Resuable Content

A place to find information on our overall style formatting, reusable boxes and pages, and tutorials

Overview

When creating or editing LibGuides, please avoid adding video (media or widgets) in rich text/html. Here are some reasons why adding a video as a media/widget asset is a much better choice:

  1. The media/widget asset will validate code before you insert it into a page to spot things that could break your page, like unclosed tags or calls to jQuery for example.
  2. Putting bad outside code into a rich text box can "break" your page, making it impossible to edit, find, and remove that bad code. When this happens, we have to submit a support ticket so that Springshare can make your guide editable again. 
  3. Like all assets (book, link, database), you can easily reuse a media/widget asset across guides for consistency. 
  4. If your media/widget asset stops working (the source video gets removed, edited, etc.), it is much easier to delete or edit the widget code.  

The directions below were adapted from Springshare.

Add a new Media/Widget asset to a guide

  1. While editing your guide, click on the Add / Reorder button at the bottom of the box where you want to add the asset.
  2. Select Media/Widget from the dropdown menu. Add Media/Widget pop-up box appears (see Figure 2).
  3. Give your asset a name in the Name field. This is how the asset will be identified in our LibGuides assets library, making it much easier to find later.
  4. In the Embed Code field, enter or paste the HTML code you want to embed. This is typically provided for you from the content provider or vendor. (e.g., YouTube)
  5. Use the Position option to choose where the new asset should be inserted in the box. (You can always reorder it later.)
  6. Click the Save button.

Selecting Media/Widget from the Add/Reorder dropdown

Creating a new Media/Widget asset

Reuse an existing Media/Widget asset

Reuse an existing Media/Widget asset that you or a colleague created earlier.
  1. While editing your guide, click on the Add / Reorder button at the bottom of the box where you want to add this.
  2. Select Media/Widget from the dropdown menu.
  3. In the Add Media / Widget window, click on the Reuse Existing Widget tab.
  4. In the Search for Media / Widget field, start typing in the name of the asset you want to add (NOTE:This is one of the reasons why it is important to name Media / Widget assets when they are first created!)
  5. Select the asset you want to add from the list of results.
  6. A summary of the asset info will appear.
  7. Not the asset you are looking for? Simply search again and select a different one.
  8. By default, a mapping of the original asset will be added to your guide. If you would rather create a copy of the original asset, select the Copy checkbox.
    • Using a mapping is convenient because any changes made to the original asset will automatically be reflected on your guide. The drawback of mapping is that you won't be able to edit the asset yourself.
    • If you need to customize the reused asset, then select the Copy checkbox. This will create a standalone copy of the asset that you own and can fully customize.
  9. Use the Position dropdown to select where in the box the new asset will be inserted. (You can reorder this later if necessary.)
  10. Click the Save button.