README

This document explains how to use the template in this folder to prepare and submit your digital project for inclusion in the Digital Studies Archive and possibly being featured in a Virtual Showcase of some of the best recent projects.

This is a project that will probably evolve, so these instructions are only germane to the current iteration of this project as it stands at the end of the Fall 2018 semester.

This document is organized into a series of steps.

1 - First, download the ZIP file with all of the files in the template. That should include five files:
 - index.html
 - style.css
 - README.txt
 - LICENSE.txt
 - screenshot.jpg

Make sure you extract this folder so that you can edit the files. On Windows, you'll need to make sure you're not viewing a preview of the compressed folder's context. If you see an "Extract files" option or tab, that means you haven't extracted yet. 

2 - Move the files associated with your project into the folder alongside index.html, style.css and the other files. This could be a screenshot of a website, the HTML file of your Twine project, the MP3 of your podcast, the script file of your video -- anything you think would be useful or interesting to future students who might want to do a similar project. Just make sure that your files all together are no more than 10 megabytes.

3 - Open the index.html file in the text editor of your choice. Make sure it's a code-friendly text editor like Sublime Text or Notepad++. Do NOT use Microsoft Word, Pages, TextEdit, or Google Docs to edit an HTML file. Replace the sample text in the template with the information that pertains to your file. For each thing that needs to be updated, there is a  brief explanation or example in a comment nearby. (HTML comments between with '<!--' and end with '-->').

4 - In the right-hand column of index.html -- starting around line 90 -- use one of the embed options to include a sample of your project. There are examples of embed code in comments here.  If you've made a video, put the embed code here. If you made a website, I recommend using something like snapito.com to make a full-length snapshot.

5 - Finally, rename the folder with your last name, the course code, and the semester, all lower-case and separated with hyphens. E.g. 'whalen-dgst395-f18'. Compress that folder into a ZIP file, and email it to me at zwhalen@umw.edu.




