DHRI@A-State

Style Guide

The purpose of this guide is to ensure consistency across the curriculum. It is not intended to limit your possibilities. Should you find any of these guidelines limiting, please contact me so that we can update the guide accordingly. For additional instructions consult the Scalar 2 User's Guide.

Workshop Overview

Broadly speaking, each workshop should include: explanatory text, technical instruction (when applicable), activities, and an Additional Resources page. Remember that the purpose of the curriculum is to 1) provide participants with resources that they can use during and after the institute, 2)  make the workshops available to people who will not be attending the institute, and  3) create teaching materials that we can use at future events.

Page Layout and Styling

When you create a page, you can make a number of aesthetic decisions regarding page layout and styling. For the purposes of this project, I recommend that you select the basic, image header, media gallery, google map, or timeline layout for your curriculum pages. I also encourage you to assign a thumbnail image to each page, as it will show up in the context and content navigation icons in the margins and in certain widgets that we may decide to use at a future date. At this stage, do not assign background images to your pages. The current background image gives coherence to the project, and it would be best to address the broader styling of the project collaboratively at a later date. 

Structure

One of the most exciting things about Scalar is its flexible and non-hierarchical structure. As we develop the curriculum, create a "floating" page for your workshop (i.e. a page that isn't linked to anything). The title of this page should be the title that you have given your workshop so that we can find and review each other's contributions using the hypothes.is tab (which we will disable after the revision process).  While each workshop will remain unlinked until we collaboratively restructure the project following revisions, I encourage you to make use of Scalar's diverse structuring functions within your individual workshops by creating whole-whole relationships via paths and tags and whole-part relationships via annotations, media links, and notes.

Adding Media

All media added to this project should be: uploaded as a local or internet media file and assigned a title, description, and source. The title should  be the original name given to the resource; the description should provide users with a brief description of the resource; and the source should contain information about where the resource came from, such as a web address. In Scalar you have to create media entries first, before you can add media to a page. 

Using Media

You can add media to a Scalar page in different ways. The first way, as in the selficity example above, is to add inline media. For this option you can manually select where you want to insert the media, and then choose the size, alignment, and caption. For this project, please select "title and description" for all captions. You can also create a media link, by highlighting the relevant text. This creates a direct link between the text and media.  Scalar also allows you to annotate media and insert selected annotations into a page. 

Hyperlinks 

There are two ways to add hyperlinks in Scalar. The blue link button allows you to link to another page in this Scalar project. The grey link button allows you to create a link to content outside of our Scalar project. When you add outside content, make sure to click the "open in a new browser window" box.

Citation Style

The citation style for this project is  Chicago Manual of Style 17th Edition.

Notes

To create a note add a bracketed number (sequential by page) at the end of the relevant sentence. Highlight the bracket and add your information using scalar's note function [1].  

This page references: