Digital humanities


Maintained by: David J. Birnbaum (djbpitt@gmail.com) [Creative Commons BY-NC-SA 3.0 Unported License] Last modified: 2015-07-29T10:08:49+0000


File-naming conventions

How to name a file

All homework files created for this course, including those uploaded to CourseWeb, must follow certain guidelines when giving the file a name. These guidelines include:

These guidelines still allow student flexibility, so if you want to include a dating system or something similar in the filename for your own convenience, you can do something like the following:

obama_09-01_xml-01.xml

This filename properly begins with a lowercase form of your surname (assuming you’re the President of the United States) and ends with the correct extension, .xml (assuming it is an XML file), the only two obligatory pieces of the filename. You can include information such as the due date (September 1 in the above example) or an assignment identifier (the first XML assignment in the above example), but these are not required (although you will probably want to use some system to differentiate files on your computer). Note that only permitted punctuation was used in the example above.

The naming policy (starting the file with your surname) applies only to files you create as homework, and not to files you create for your collaborative course project. Course project files, though, must still have correct extensions and must not use any characters except for letters, digits, periods, hypens, and underscores (in particular, no spaces and no other punctuation).

File formats

Coding assignments must be submitted as plain-text files with the appropriate filename extension (which we’ll tell you about as needed).

Response papers must be submitted as Word files (.docx, .doc) or rich text format (.rtf). No PDF please, since we need to be able to type comments into your paper, which is easier with a word-processor file than with PDF.

Uploading a file to CourseWeb

The policy outlined above applies to all files you submit to CourseWeb, including Word documents. For assignments that may require the submission of multiple files, such as an HTML file accompanied by CSS or JavaScript files (don’t worry if you don’t know what this means; we’ll explain it when it becomes relevant), all uploaded files must observe the conventions described above.

All homework assignments submitted to CourseWeb must be uploaded as attachments, not copied and pasted into the main text field. In addition, nothing, including questions or comments, should be typed into these fields. You will often want to include comments or questions when you submit your homework, and we’ll show you how to format those directly within your assignment files.