Instructions for entering data via the Primary Source Sets app web interface.
Audio, Author, Document, Image, Source, Set, Teaching Guide, Video
| Anchor | ||||
|---|---|---|---|---|
|
File upload
- Make sure that files have unique names. If a file already exists with the same file name, the existing file will be over-written.
- Wait until the file upload says "100% complete" before navigating away from the page.
- Acceptable file formats: .mp3 .mp2 .mp4a .wav .flac .aif .aiff .wma .mpga .oga .ogg .au .adp .aac .weba
| Anchor | ||||
|---|---|---|---|---|
|
| Label | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|
| Name | text | Required | Name of the author. | Example: "Ella Howard" |
| Affiliation | text | Optional | Organizational affiliation of the author. | Example: "Armstrong State University, Savannah, Georgia" |
Anchor document document
Document
| document | |
| document |
File upload
- Make sure that files have unique names. If a file already exists with the same file name, the existing file will be over-written.
- Wait until the file upload says "100% complete" before navigating away from the page.
- Acceptable file formats: .pdf
| Anchor | ||||
|---|---|---|---|---|
|
File upload
- Make sure that files have unique names. If a file already exists with the same file name, the existing file will be over-written.
- Wait until the file upload says "100% complete" before navigating away from the page.
- Acceptable file formats: .jpg .jpeg .png .gif
| Label | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|
| Size | 'large', 'small', or 'thumbnail' | Required | The size of the image. | Large images will be displayed on as the main asset on the source page. Thumbnail images will represent the source on the set page. Small images will represent the set on the landing page. |
| Width | number | Optional | Pixel width of the image. | |
| Height | number | Optional | Pixel height of the image. | |
| Alt text | text | Optional | Alt text for the image. | If left blank, the alt text for the image will default to the source caption. |
Anchor set set
Set
| set | |
| set |
Field | Data format | Obligation | Definition | Notes |
|---|---|---|---|---|
| Name | markdown | Required | Name of the set | Example: "The French and Indian War" |
| DescriptionSEO description | text | Recommended | Brief description of the set. This description is intended for use in SEO - it will appear and in the Learning Registry. | Example: "This collection uses A set of primary sources to explore exploring the French and Indian War, with accompanying teaching guide." |
| Overview | Optional | Narrative overview of the set. |
| |
| Resources | markdown | Optional | Narrative information regarding resources for further research. Can include links to additional sources and tips for finding related materials in the DPLA. |
|
| Author | choose one or more from menu | Recommended | Author(s) of the set. |
|
| Anchor | ||||
|---|---|---|---|---|
|
| Field | Data format | Obligation | Definition | Notes | |||||
|---|---|---|---|---|---|---|---|---|---|
| NameCaption | markdown | Recommended | Name or brief caption describing the source. | Maximum length: 140 characters Example: "Diary of Major George Washington, 1753" | |||||
| DPLA id | text | Required | The DPLA aggregation representing the source. | Example: "ebc07432a6ba4f864daaddc4ad0a68f9" | Media type | choose one from menu | Required | The format in which the full representation of the source is encoded. Media type refers to the file type of the digital object. It is not a description of the original object. | |
| Citation | markdown | Recommended | A bibliographic citation for the the source. | Example: Washington, George. *The Journal of Major George Washington.* Chicago: The Newberry Library, 1958: page 53. | |||||
| Credits | markdown | Recommended | A statement crediting the hub and contributing institution. | Example: "Courtesy of The University of Michigan via Hathitrust" | |||||
| Textual contentDescription / transcription | markdown | Optional | Narrative description, transcription, citation, or other text describing the source. | ||||||
| Featured | checkbox | Required | If checked, this source's small image will be the featured image for the set. | ||||||
| Main media asset | checkbox | Recommended | The large image, document, audio, or video, that will be features on the source page. | ||||||
| Thumbnail | checkbox | Recommended | The thumbnail image that will be used to represent the source on the set page. | ||||||
| Small image | checkbox | Optional | The small image that will be used to represent the set on the landing page. |
| Anchor | ||||
|---|---|---|---|---|
|
| Label | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|
| Name | markdown | Required | Name of the guide. | Example: "Exploring the French and Indian War" |
Questions | markdown | Recommended | Discussion questions related to the set for use in an educational context. | Example: 1. Choose five days from [British soldier Luke Gridley’s diary](http://dp.la/sets/french-and-indian-war/source/34). From his description, what do we learn about soldiers’ experience of the war? Use the [letter to William Pitt] (http://dp.la/sets/french-and-indian-war/source/35) and the [British history of the war](http://dp.la/sets/french-and- indian-war/source/36) to learn about the British perspective on the war. 2. What do the sources tell us about England's reason for fighting? Are the sources biased? |
| Activity | Optional | Activity related to the set for use in an educational context. |
| |
| Author | choose one or more from menu | Recommended | Author(s) of the guide. | Enter the authors for the teaching guide even if they are the same as the authors for the set. |
| Anchor | ||||
|---|---|---|---|---|
|
File upload
- Make sure that files have unique names. If a file already exists with the same file name, the existing file will be over-written.
- Wait until the file upload says "100% complete" before navigating away from the page.
- Acceptable file formats: .mov .m4v .mp4 .mpeg .mp1 .3gp .3g2 .avi .f4v .flv .h261 .h263 .h264 .jpm .jpgv .asf .wm .wmv .mj2 .ogv .webm .qt .movie .dv