Introduction to Digital Humanities
Winter 2017 • HIST 698-002
Spy on your colleagues
1: Ethos of Digital Humanities / Digital Historiography
William Cronon, The Public Practice of History in and for a Digital Age.
Julia Flanders, The Productive Unease of 21st-century Digital Scholarship.
Stephen Ramsay, DH Types One and Two.
Mark Sample, The Digital Humanities Is Not About Building, It’s About Sharing.
Lisa Spiro, “This Is Why We Fight”: Defining the Values of the Digital Humanities
2: The Command Line
Some of the most powerful tools you might use for digital research and publishing don’t have a GUI (Graphical User Interface) for many reasons that we’ll discuss. If you haven’t used a command line interface before, it can be disorienting, but we’ll try for a very gentle introduction.
If you have Windows, you’ll need to use PowerShell; if you have a Mac, you’ll need to use your Terminal application. For our purposes, they are functionally equivalent.
Review Sample and Spiro from last week (since we didn’t get to them).
Jim Mussell, “Doing and Making: History as Digital Practice,” in Tony Weller (ed.), History in the Digital Age (London: Routledge, 2013), 79–94.
Read through (but don’t worry about completing) the in-class tutorials beforehand; we’ll go through them in class with some deviations. Please come to class with questions about the terms and concepts so we can be most efficient with our work time.
We’ll work through some basic examples with the Command Line and Pandoc and troubleshoot any issues you run into.
GitHub Markdown Reference Guide and a more stylized PDF. This Markdown sandbox allows you to experiment and see what your Markdown will look like in HTML and on a webpage.
If you haven’t found it already, I highly recommend that you use Atom as your text editor.
3: Digital Publishing
We’ll use our new knowledge of the command line and several tutorials to help us install Jekyll (which is what GitHub uses) and manage our websites more easily. First, we’ll talk about different strategies for and reasons why you might want to be more hands on with your own digital presence.
Before class (why you might care about your own website)
It is not necessary to read each of these in great depth, but you should skim through each to take away what you find interesting. This reading list is a bit long simply to provide a number of perspectives and considerations, not because they are all absolutely essential readings.
For your response essay: please comment on what you found attractive or repulsive about the readings in terms of professional identity? Any interesting perspectives you hadn’t considered? Particularly specious arguments? Omissions?
Christopher P. Long, The Googled Graduate Student.
Jentery Sayers, Do You Need Your Own Website while on the Job Market.
Patrick Iber, A Defence of Academic Twitter.
Katrina Gulliver, 10 Commandments of Twitter for Academics.
Chuck Tyron, Blogging, Scholarship, and the Networked Public Sphere.
Kim Barbour and David Marshall, The Academic Online: Constructing Persona Through the World Wide Web.
Also, read through the tutorials below so that you can start to conceptualize what we’ll be doing. Come to class with lots of questions about these, which we can address before we start and as we go. If you’d like to jump into the tutorials and do them, that’s great, but it’s more important to build familiarity with the various tools and steps to get them running.
We’re going to set up our websites locally (that is, on our own computers) so that we don’t have to do everything via GitHub. We’ll install Jekyll, the software that GitHub Pages uses to make our websites (but first we have to install some software that Jekyll requires). The tutorials can get confusing, we’re going to go through them together with some deviations.
- Zotero, Zotfile, and Dropbox
- Review of previous technologies and a few related examples.
- Brief introduction to GitHub Desktop and review of branches.
- We are going to work through Amanda Visconti, Building a static website with Jekyll and GitHub Pages. There is some review of what we did last time, so it should seem familiar, and you can skip some of the steps. Follow the relevant Mac or Windows instructions when they diverge under the “Installing Dependencies” section. - Stop at the “Setting up Jekyll” section because we’ve already got a website to connect to.
- We won’t be using the automatic blog feature of Jekyll for now, so you should read through that section, but don’t worry about doing it.
For another perspective and for reference, see Keith Miyake, Create Your (FREE) Website Using Github and Jekyll.
Remember: once you start using git on the command line, you can always undo just about anything.
4: Typography + HTML + CSS
Getting a handle on the fundamentals of design and typography goes a long way in improving communication. We’re going to practice typography with our CVs.
- Zotero, Zotfile, and Dropbox (neglected last time)
- Command line + pandoc review; ImageMagick
- GitHub Desktop tour
- Using branches to edit your CV
- Using git on the command line
- Review and clarify the HTML and CSS tutorials
- Fork demo repository for sample code
- Jekyll, Markdown, HTML, CSS localhost review
- Introduction to Jekyll includes and templates
- CSS Frameworks (like http://getskeleton.com)
- Begin fleshing out and styling your own site/pages
- Home (index.md)
- Start playing with more complex web frameworks (like Bootstrap)
5: Digital Spatial History
Richard White, What is spatial history?
Anne Kelly Knowles, A More Humane Approach to Digital Scholarship
David J. Bodenhamer, “The Spatial Humanities: Space, Time and Place in the New Digital Age,” in Tony Weller (ed.), History in the Digital Age (London: Routledge, 2013), 23-38.
- Zotero, Zotfile, and Dropbox (neglected last time, again)
- Using branches for working copies of files
- More on Jekyll layouts and themes
- Default installation and minima theme.
- Creating your own layouts to minimize maintenance
- Using and learning from CSS Frameworks (like skeleton)
- Continue fleshing out and styling your own site/pages
- Home (index.md)
- Start getting familiar with more complex web frameworks (like Bootstrap)
After we get a little more situated with our portfolios we’ll turn to the mapping articles for this week. Then, playing around with maps:
6: Mapping with QGIS
I. N. Gregory and A. Hardie, “Visual GISting: Bringing Together Corpus Linguistics and Geographical Information Systems,” Literary and Linguistic Computing 26, no. 3 (2011): 297–314.
Matthew Wilkens, “Geolocation Extraction and Mapping of Nineteenth-Century U.S. Fiction.”
- So as not to lose your hard-earned knowledge from last time, continue fleshing out and styling your own site/pages. Don’t be afraid about breaking anything. You should break stuff. Remember, you can use branches to keep good working copies of your files as you experiment.
- Complete the Google Maps tutorial. Compared to what you’ve been doing, this is going to be SO EASY.
- Download and install QGIS.
- MAC USERS: When you open the disk image that you download, you’ll see 4 .pkg files that you must install in the order they are numbered.
7: GIS and Portfolio Questions
- Gergely Baics, Mapping as Process: Food Access in Nineteenth-Century New York.
- Scan through 3-5 Humanities GIS Projects. It’s a mixed bag. They may be defunct, overly technical, totally confusing, or kind of awesome. Be prepared to highlight for everyone else the intriguing and questionable features of the sites you explored. Questions to keep in mind:
- How does mapping/GIS figure into the project? Is it necessary?
- What kind of data is being used? Where is it from? Is it accessible or reusable?
- How much does the design of the site matter in taking it seriously?
- How would you rate its usability?
- Work on your portfolios! Keep in mind the criteria below. In general, aim to do simple things well. See how simple you can make your site, but with a clear and consistent design aesthetic (and required content, of course). Bring questions to class! This is your best chance to get technical help before you are largely on your own before the portfolio review. It’s also usually the case that people benefit from hearing explanations even if they haven’t encountered or care about that particular issue at that time; so it’s good for us to do this together.
- GIS Project critiques and discussion
- Portfolio questions (includes, layouts, HTML, CSS, Markdown, typography, design, etc)
- Work through 3 simple Mapping with QGIS tutorials
- For future reference, you get stuck or have questions, consult the QGIS Training Manual, the QGIS wiki, and an array of tutorials
- MapBox Demo and data movement
- Start your own maps (for your portfolio). When gathering and organizing data, you might consider using Google Sheets or Airtable (read through the introductory guide or watch the 12-min. intro video) to organize your data. You can use Excel, but ultimately you need to get your data into CSV format, which Excel does not do well, especially with non-English characters. Airtable is especially good for helping you (and others) create normalized data (so you won’t have something like “Detroit” in some places and “detroit, MI” in other places.)
8: Portfolio Critiques
- Work on your portfolios! Keep in mind the criteria below. In general, aim to do simple things well. See how simple you can make your site, but with a clear and consistent design aesthetic (and required content, of course).
- Part 3 of the QGIS tutorials (geo-rectifying and overlaying images)
- MapBox Demo and data movement
- Portfolio critiques. You’ll show off your portfolio for the rest of the class and explain what you’re trying to do and where you’ve had trouble. There are two main goals here: 1) to have a deadline to keep portfolios moving forward; 2) get ideas from other people (from their own sites as well as questions/comments). Questions we will address in class for each site:
- Existence of basic pages and content
- Is there a consistent layout and navigation scheme?
- Typographic crimes? Consistency?
- Where does the design help or hinder the site and content?
- What is extraneous? What is missing?
Although we won’t dedicate entire days to website technologies anymore, we will continue to discuss various techniques to enhance your websites. The topics are listed in the In Class sections for each day.
Please keep in mind that these are are not just make-work for the course, but provide a forum for you to show off your facility with digital methods. So, the audience is not merely me or your class peers, but a general audience that wants to know what you know and can do (and is ostensibly interested in your critical engagement with these methods).
9: Text Mining
Under what circumstances are these techniques useful? How can they be used most effectively? We’re going to talk about the different formats of data these tools require, problems moving from one to the other, and the pros and cons of their various approaches.
Show your application of basic text mining in your own research, or a research topic that interests you.
Skim through some OCR readings
We won’t be discussing OCR correction in great detail, but you should be aware of the various challenges it presents and how people are dealing with it.
- Column layouts, grids, CSS frameworks, responsive design
- Fully defined layout (margins, page width, i.e. basic typography) with header and footer (however extensive or minimal)
- Functioning navigation bar (however you style it)
- Separate pages for your responses essays
- Essays should have compelling formatting (section headers, bold type)
10: Topic Modeling
The best way to get a handle on topic modeling is to read a variety of explanations. Most are pretty short, and the longest tend to be overviews of topic modeling in practice rather than technical explanations.
Demonstrate an example of using topic modeling in your research, including how you prepared the data, how you created topics, and what they tell you about your sources.
- Install and use MALLET to topic model some of your sources.
- As you get some results, you’ll want to consult this guide on interpreting results.
- Load up some of your sources into Overview, and compare what you can learn from “raw” topic modeling with MALLET and Overview’s presentation of your documents.
- Create a timeline with Timeline Curator
- Create a timeline with TimelineJS
- Demo on structured data and Bookworm
- Clean code
- Sound essay typography
11: Network Analysis
Demonstrate an example of using network analysis in your research, including the kind of relationships you set out to examine, how you prepared the data to visualize them, how you could style the diagram to aid in interpretation, and how it might be useful in your research at larger scales.
- Create data (remember: the process, not the data is important here) and create a network graph with Palladio
- Download, install, and model texts with Gephi, using Martin Grandjean, Introduction to Network Analysis and Visualization. You might also consult another set of tutorials for additional perspectives.
- As usual, our goal in surveying the tools is not methodological expertise in a week, but to understand the process of creating data, the basic functionality, and the better evaluate how it’s used in the real world.
12: Critiquing Digital Scholarship
At least in my review, critical discourse about digital humanities projects remains impoverished compared to its analog counterparts.
What do you consider the fundamental criteria for critiquing digital history projects? How much does the traditional peer review model need to change to accommodate new types of historical work/projects?
13: Digital Literacies/Pedagogy
Today we’ll explore how various digital methods can be incorporated into the undergraduate classroom.
The Last Push
- No critique essay
- Instead: email 3 questions relevant to your portfolio development. These can be as specific or as broad as you’d like (including suggestions for topics to cover). Please send these by the end of Tuesday so I have time to prepare answers for class. We’ll probably spread these out over the last two weeks.
These readings focus on visualization, obviously, but the broader question they should help us address is: how well can visual representation (modeling, graphing, design, etc) help communicate digital literacies and fundamental concerns of the humanities? Building on last week: are these digital humanities concerns, or just humanities?
But potentially useful for thinking about data? Or just critically evaluating data visualizations?
14: Topics TBD!
The Last Assignment
For your final response paper, I’d like you to produce an ~800 word review of a digital humanities project of your choice. Choose one that is worth reviewing, and about which you have something interesting to say. This should review should show you engaging in the various facets of the project that we have discussed throughout the semester: design, usability, sound use of digital research methods, accessible data, and so on.
Follow the steps outlined here: Quick start: Setting up a custom domain - GitHub
I highly recommend: Reclaim Hosting
In step 3, you’ll probably want to use the first link: Setting up an apex domain - GitHub
In order to complete that step, you’ll want to consult the Reclaim Hosting instructions: Domain Mapping to GitHub
15: Loose ends, conclusions, etc.