Skip to content

cu-mkp/GR8975

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

650 Commits

_texts

_texts

 
 

assets

assets

 
 

entry_files

entry_files

 
 

folio_files

folio_files

 
 

lib

lib

 
 

presentations

presentations

 
 

samples

samples

 
 

schema

schema

 
 

term_lists

term_lists

 
 

xml

xml

 
 

xml_needwork

xml_needwork

 
 

xslt

xslt

 
 

.gitignore

.gitignore

 
 

.travis.yml

.travis.yml

 
 

LinksToPresentations.md

LinksToPresentations.md

 
 

March 21 protocols doc

March 21 protocols doc

 
 

README.md

README.md

 
 

StudentSyllabusDraftUnformatted.md

StudentSyllabusDraftUnformatted.md

 
 

WEB VERSION - STUDENT Syllabus_Digital_course, 2017-01-04.docx

WEB VERSION - STUDENT Syllabus_Digital_course, 2017-01-04.docx

 
 

WEB VERSION - STUDENT Syllabus_Digital_course, 2017-01-04.pdf

WEB VERSION - STUDENT Syllabus_Digital_course, 2017-01-04.pdf

 
 

all_entries.xml

all_entries.xml

 
 

birds.txt

birds.txt

 
 

element_definitions.md

element_definitions.md

 
 

entry-metadata.csv

entry-metadata.csv

 
 

files.txt

files.txt

 
 

metadata.md

metadata.md

 
 

metadata_definitions.md

metadata_definitions.md

 
 

not_well_formed_20170510.txt

not_well_formed_20170510.txt

 
 

revised-metadata_GUIDE.csv

revised-metadata_GUIDE.csv

 
 

translatedfolio.pdf

translatedfolio.pdf

 
 

user_stories.md

user_stories.md

 
 

xml_files.txt

xml_files.txt

 
 

xml_resources

xml_resources

 
 

Repository files navigation

History GR8975

What is a Book in the 21st Century?

Working with Historical Texts in a Digital Environment

Spring 2017

Wednesdays, 4:10pm-6pm, Studio @ Butler

Some Friday Labs, 2-4pm, Studio @ Butler

Some shared sessions with the Experimental Methods Group (Fridays 3-5pm)

and Professor Dennis Tenen

INSTRUCTORS : Terry Catapano (CU Libraries) and Pamela Smith (History), with guest lectures by Steven Feiner (Computer Science)

Course Instructors

Prof. Pamela Smith

Prof. Terry Catapano

Project Manager

Naomi Rosenkranz

Course Assistants

Atif Ahmed

Mehul Kumar

Varsha Maragi

Jeffrey Wayno

This course will introduce graduate students to techniques of working in digital environments. The course is intended mainly for humanities and social science students who are novices with little or no experience in using digital platforms, but we also welcome students from all disciplines, as well as those who might be familiar with constructing websites or blogs, or even with creating minimal editions. Through hands-on assignments (with plenty of assistance), you will master a variety of skills that constitute literacy in digital humanities, and, by the end of the semester, you will be able to take your newfound digital literacy with you as you pursue your own study, research, and future work.

Throughout the course, your skills will be built by implementing them to collectively create a small scale digital edition, which will be festively launched at the end of the semester. This digital edition will draw on collaboration with and research done by the Making and Knowing Project ( http://www.makingandknowing.org/) on an anonymous sixteenth-century French compilation of artistic and technical recipes (BnF Ms. Fr. 640). The Project's existing English translation of this manuscript will constitute the "data" with which students in this course will work to create their small scale edition.

This rare French manuscript resulted from the compilation of craft knowledge over time, followed by its subsequent "disassembly" in a late sixteenth-century workshop by an author-compiler-practitioner who experimented on techniques contained in the manuscript's "recipes." While the course will focus on this intriguing manuscript and the research that has been carried out on it, the skills you will learn over the course of the semester are widely applicable to other types of Digital Humanities projects, and, indeed, in many fields outside of traditional academic study.

The Making and Knowing Project, directed by Professor Smith, has produced the transcription and English translation of this manuscript, "disassembling" Ms. Fr. 640 through research seminars and workshops, involving multidisciplinary teams of students and scholars. The Project is now engaged in creating a complete critical digital edition, which represents a reassembly of this manuscript in a 21st-century form. In this course, you will be an active participant in the Project's exploration of the technologies that allow not just a reading of the text but an interaction with the content itself. This is in direct resonance with the ways that this sixteenth-century recipe collection can only be transformed from text to knowledge when the techniques contained within it are practiced, whether in the sixteenth century or in the Making and Knowing Laboratory reconstructions today. Through this exploration, the course aims to foster reflection on the constraints of the codex as a framework and vehicle for the production of knowledge, and to re-think the technology of the book and what it means to read a text. To this end, the course also includes collaboration with Professor Steven Feiner's Computer Graphics and User Interfaces Lab ( CGUI, http://graphics.cs.columbia.edu/home/home/).

This course is one component of the History in Action Initiative of the Columbia Department of History. The American Historical Association (AHA) and the Andrew W. Mellon Foundation are collaborating to re-think career education for history PhD candidates at four selected universities (Columbia, Chicago, New Mexico, and UCLA) and to continue, expand, and enhance the AHA's " Career Diversity and the History PhD" initiative. The long-term goal is to establish a new norm: that doctoral graduates in history and the humanities will be equipped with the skills to pursue a wide spectrum of career opportunities and communicate their research to a broad audience.

ASSE** SSMENT **:

Participation, initiative, effort: 10%

Weekly assignments and field notes: 30%

Final edition project: 60%

SCHEDULE:

Please note: You will encounter many unfamiliar and possibly intimidating terms in the following syllabus, but FEAR NOT! Learning a new craft involves not just "how to do" it, but also "how to talk" about it. Hands-on techniques are in general difficult to put into words, so this practitioners' jargon is often necessary.

Please see here for a short and easy to read version of the class schedule and syllabus that includes the digital skills introduced in each class.

Be sure to bring your computer (not tablet) to every class.

Week 1: Jan 18 - Introduction

Get to know your many collaborators in this class!

To prepare in advance of the class on Jan 18:

  • ●●** To do:**

    • ○○ If you do not already have one, please create a GitHub account.
    • ○○ Please fill out this form to be granted access to the Project's Google Drive which serves as the Project's collaborative workspace for transcription, translation, and annotation of the manuscript, BnF Ms Fr 640.
      • ■■ You will need a Gmail account explicitly ending in "@gmail.com," so if you do not have one already, please create one. PLEASE DO NOT ACCESS THE GOOGLE DRIVE WITH YOUR LIONMAIL ACCOUNT.
      • ■■ Please consult the following introductory document with more information about Google Drive, and which explains in brief how our files are organized within the folder, and provides further instructions and details about access.

  • ●●** Read and Explore:**

In class on Jan 18:

  • ●● Introduction
    • ○○ Aims and overview of the course (Smith and Catapano)
    • ○○ The Making and Knowing Project and BnF. Ms. Fr. 640 (Smith)
    • ○○ Digital literacy - resources and digital competencies (Jessica Brodsky)
    • ○○ Overview of and Digital Editions and Editing(Catapano)
    • ○○ Computer Graphics and User Interfaces Lab (Feiner)

Homework assignment Jan 18:

  • ●● Reading (for lab on Jan 20):
  • ●● Assignment 1 (due Jan 25):
    • ○○ Begin to familiarize yourself with your assigned folios from the course GitHub and read through them. (You can also read in the pdfs we sent on Wednesday, but also find them on the GitHub repository.)
    • ○○ Complete Digital Competencies Evaluation #1 and permission and contribution forms, and bring them to class.
  • ●● Reading (for Jan 25):
    • ○○"User Story" https://en.wikipedia.org/wiki/User_story
    • ○○ Thomas Tanselle. A Rationale of Textual Criticism (Philadelphia: University of Pennsylvania Press, 1992). Available at Book Culture.

Lab 1: Jan 20 - workshop with Dennis Tenen

Week 2: Jan 2** 5 - General introduction to text editing and scholarship**

What is a "book"? How does it organize text and content? What aims does it achieve? Who does it reach? What is Scholarly Editing and Textual Criticism? What are the rationale, purposes, scope, and features of scholarly editions?

In class on Jan 25:

  • ●● Discussion: What is a book? Digital Humanities projects, scholarly editions, user stories
  • ●● Introduction of the Casebooks Project by director, Prof. Lauren Kassell, Cambridge University

Homework assignment Jan 25:

  • ●● Assignment 2 (due Feb 1):
    • ○○ Read about User Stories: https://en.wikipedia.org/wiki/User_story
    • ○○ From class on January 25, think about the Casebooks Project and the Making and Knowing Project, derive 3-5 user stories related to our proposed online edition of BnF Ms. Fr. 640, based on your reading of your folios. In class, we will discuss the user stories and create a document that we will collaboratively add to GitHub.
    • ○○ Create your profile in Wikischolars. If you have questions about how to do this, and can come to Monday's lab class, please feel free to attend 10:10-2 for the whole class, OR, from 11:30-12:15, we'll cover field notes, and from 12:30-2, we'll cover an intro to using WikiScholars, and troubleshooting for GD and WikiScholars.
    • ○○ If you can't come to Monday's class, there will be office hours for troubleshooting help announced later this week.

Reading (for Feb 1):

    • ○○ Identify and read the annotations relevant to your folios.

Lab 2: Jan 27 - Wiki, GD, and GitHub workshop

  • ●● Dennis Tenen, Introduction to GitHub
  • ●● Wiki Scholars introduction and setup
  • ●● M&K Google Drive troubleshooting,GitHub troubleshooting
  • ●● Photos of today's lecture notes from Dennis Tenen

Week 3: Feb 1 - Data and Project Management

How do we think about the social, intellectual, and physical infrastructure of producing a "book" or a "digital project"? What is distinctive about digital projects? What is the range of concerns for a digital editing project?

In class on Feb 1:

  • ●● Class discussion and exercise:
    • ○○ User stories
    • ○○ The whole class will:
      • ■■ Discuss and refine user stories and collaboratively contribute to a shared document on the class Github repository
      • ■■ From user stories create "feature requests" in the issue tracker
  • ●● Lecture and discussion:
    • ○○ Project Management
      • ■■"Agile" development and management
      • ■■ Collaboration and Communication
      • ■■ Release Management
      • ■■ Technical Debt and Digital Obsolescence
    • ○○ Data Management
      • ■■ Identifiers
      • ■■ Metadata
      • ■■ Tracking
      • ■■ Preservation and Sustainability
      • ■■ Licensing: Creative Commons and open access
      • ■■ Optimising for Re-use

Homework assignment Feb 1:

  • ●● In Wikischolars, create your profile. Begin taking rudimentary field notes that record the process of doing your homework. Transfer your field notes into Wikischolars field note pages.
  • ●● Metadata: For 5 of your folios (r and v), create a metadata table, based on the schema/template we came up with in class.
    • ○○ See this sample based on one of Tianna's folios, and a descriptionf the elements of the template
    • ○○ Remember, please read and use the foliosin GitHub. At the same time, have a look at the manuscript pages in Google Drive, including looking at the HD images of your folios.
  • ●● If you come up with additional metadata fields, please create a new issue in GitHub. Also use the issue tracker tracker if you come across problems while filling in the table.
  • ●● Remember to do the reading also:

Reading (for Feb 8):

Lab 3: Feb 3 - Metadata

What are the categories by which we organize our "content," our "materials," our "digital assets"?

  • ●● We will start this assignment in the lab, and students will finish at home:
    • ○○ Create master table of metadata elements collaboratively, to be filled in for homework: What are the considerations we may need to have for creating a digital edition? What should our metadata be?
    • ○○ Here is the Schema/template we came up with in class:
    • ○○ Us the template to create table of metadata for your assigned folios and add to GitHub.
      • ■■ Add to issue tracker as you come across issues while filling in the table

Week 4** : Feb **** 8 - Digital Representation Fundamentals**

Representing a representation: How are images represented digitally? How are they viewed, processed, and referenced? What are their advantages and limitations?

In class on Feb 8:

  • ●● Discussion:
    • ○○ Reconciliation and resolution of metadata issues
  • ●● Lecture and discussion:
    • ○○ Digital image fundamentals
  • ●● Tool:
    • ○○ Viewshare

Homework assignment Feb 8:

Lab 4: Feb 10 - Using metadata in Viewshare

  • ●● Review metadata table - create a composite table
  • ●● Create presentation metadata in Viewshare
  • ●● Start Assignment 4 (if needed, finish for homework)

Week 5: Feb 15 - Text Fundamentals

What is digital text? What can it do that printed type on paper cannot? How may digital or "electronic" text be "processed"? What sorts of study and inquiry does text "processing" facilitate? How does the way digital text is "prepared" affect its possible uses?

In class on Feb 15:

Homework assignment Feb 15:

  • ●● Assignment 5 (due Feb 22):
    • ○○ Continue with last week work
    • ○○ Play around with your cloned Viewshare "View"
    • ○○ Try Unix for Poets exercises on your command line
    • ○○ Update your field notes

Reading (for Feb 22)

Be sure to have read and worked with previous assignments:

Lab 5: Feb 17 - GitHub lab

  • ●● Git/Github and command line hands-on

Week 6: Feb 22 - More on Text Processing, Command Line, Utilities, and Version Control in GitHub

The mess of digital reproduction: how to maintain control of content, issue, edition, "release"? How can digital tools accommodate textual "instability"?

In class on Feb 22:

  • ●● Hands-on Exercises:

    • ○○ Text Processing, Command Line, Utilities, Version control and representation of textual variance in traditional critical editions

Homework assignment Feb 22:

  • ●● Assignment 6 (due Mar 1):
    • ○○ practice the work we did in class in this file in the Github repository:

https://github.com/cu-mkp/GR8975/blob/master/command_line_text_processing.md

Lab 6: Feb 24 - SPEAKER - STUDIO@BUTLER 2-3PM

"Digital Amati: Structure and Interpretation of Classical Stringed Instruments" by Harry Mairson, professor of computer science at Brandeis University. Professor Mairson is also an amateur violoncello maker, has conducted research on type systems in programming languages and their relation to problems in logic and complexity theory. In this lecture, he introduces the Digital Amati Project which explores the structure,interpretation, and making of stringed instruments, and how modern software can be used to represent historical practices of instrument design. The lecture discusses digital humanities tools, and the creative work done with them, and will be of interest to historians, musicologists, practitioners of digital humanities, and makers. Link to event page can be found here. The event is hosted by the Making and Knowing Project and co-sponsored by History in Action in the Columbia University History Department.

Week 7: March 1 - Text Markup: Introduction and Overview

Digital text: How it works in practice, part 1. Approaches for preparing textual data to represent implicit "formal" or "structural" features

In class on Mar 1:

Homework assignment Mar 1:

  • ●● Assignment 7 (due Mar 8):
    • ○○ Read about markdown here: https://guides.github.com/features/mastering-markdown/#syntax
    • ○○ Create files of the entries in your folios (copy to text editor, save to entry_files directory in your local Github repository. Remember to name these files *.md. Then commit AND push to the shared repository in GitHub
      • ■■ if you need a text editor, you can download Atom here: https://atom.io/
    • ○○ Practice markdown of your entry files.
    • ○○ Consider the affordances and limitations of markdown and bring your ideas to the next class about what more you want from markup of your folios
    • ○○ Update your field notes
  • ●● Reading (for Mar 8):

NO LAB Week 7: March 3 - Terry Office Hours

  • ●● Terry will be at Studio@Butler at 2PM for any troubleshooting needs.

Week 8: Mar 8 - Text Markup Continued: Semantic Markup

Digital Text: How it works in practice, part 2. "Text Encoding" or "Markup" for preparing textual data to represent both "formal" and "semantic" textual features.

In class on Mar 8:

  • ●● Lecture and discussion:
    • ○○ Introduction to XML
    • ○○ Text Encoding Initiative (TEI) and customized markup
  • ●● Exercise:
    • ○○ Begin determination of our possible markup tag set
  • ●● Tool:
    • ○○ XML-aware text editor, eg. Sublime or Atom

Homework assignment Mar 8:

  • ●● Assignment 8: Due Monday March 20:

    • ○○ [p+folio number]_mb[sequence #].xml
    • ○○ For example: p001r_mb1.xml
    • ○○ Determine the sequence number from the order that they appear in the entry files now. If you have individual files for marginal notes, just assign a different number to make the file names unique (don't worry about "sequence").
    • ○○ Find features that are not currently marked up and apply your own.

  • ●● Due Wednesday March 22: Compare and review your partner's tag set and, using the issue tracker, comment on your partner's tag set. Be prepared to present to the rest of the class on Mar 22 during class.

  • ●● Update your field notes

  • ●● Digital Competencies Evaluation #2 [Please print this form, fill it out and bring it to class on March 22 to turn in]

  • ●● Prepare for NYU class visit. Together will present our collective project. Pamela and Terry will give a 5-minute overview of the course goals and methods, and then each of you can take 2-3 minutes to present one of your entries that demonstrates the challenges we face in creating our minimal edition. Over Spring Break, please decide on an entry or two that might be useful to present.

  • ●● Reading:

Lab 6: Mar 10 - Markup - Fayerweather 513

  • ●● Text editor and markup troubleshooting and help

      Working in teams (form teams)

  Assign peer reviewers

  Choose presentation/presentation for March 24

Spring Break: Mar 15 - NO CLASS

  • ●● Working on Assignment 8 [DUE Monday Mar 20 to your peer reviewers]

Week 9: Mar 2** 2 - Text Markup Continued: Establishing Consensus**

Digital Text: How it works in practice in collaborative projects (part 3). How to decide what to tag and what not to tag. The role of the "schema" in formally defining (i.e., for a computer) a "document type" or "tag set"

In class on Mar 22:

  • ●● Present your comparison and review of your own and partner group's tag set. Discussion of different markup
  • ●● Begin to form a consensus markup strategy
  • ●● Begin to formalize this consensus markup in a schema
  • ●● Begin applying the consensus markup - troubleshooting, understanding, reporting, diagnosing, and fixing errors

Homework assignment Mar 22:

  • ●● Continue to think about semantic issues. Come up with things you think might be significant to the user?

  • ●● Assignment 9 (due Mar 29):

    • ○○ Apply consensus markup (in its current form) to your folios
    • ○○ Review partner group's markup (through issue tracker)
      • ■■ Identify Issues:
  1. 1. Bugs
  2. 2. Commentary

Lab 7: Mar 24 - NYU Student Visit

  • ●● Meeting with graduate digital humanities students from NYU in Fayerweather 513. Please note the unusual meeting time: 4-6 pm.
  • ●● Optional Event: March 28th at 6PM at NYU Center for the Humanities. "Digital Humanities Meets Art Galleries" This event is free. More info can be found here. The NYU Center for the Humanities website can be found here.

Week 10: March 29 - Text Markup Continued: Establishing Consensus

In class on March 29:

  • ●● Protocols and Guidelines
  • ●● Continue refining consensus markup: What problems have we encountered, and how might we overcome them? Think back to our user stories.

Lab 8: March 31 - Transformations, Representations, and Interfaces to Digital Resources Part 1

Digital text: How it really works.

In Lab on March 31:

  • ●● Xygen setup and intro (XML editing and XSLT frameworks)
  • ●● Review and troubleshooting of your marked-up folios
  • ●● Lecture and discussion:
    • ○○ Transformation of XML - XSLT

Homework assignment Mar 31:

Week 11: April 5 - Transformations, Representations, and Interfaces to Digital Resources Part 2

Moving from preparation of digital textual data to "processing" and "application", particularly "transformation" or "conversion" into appropriate formats for publishing in an online edition.

In class on Apr 5:

Homework assignment Apr 5:

  • ●● Assignment 11 (due Apr 12):
    • ○○ Transform marked-up pages to Jekyll markdown using Oxygen XML Editor
    • ○○ Revisit feature requests from Week 3 and evaluate status of requests
    • ○○ Update your field notes

Lab 8: Apr 7 - XSLT workshop - IN BUTLER 208

  • ●● Hands-on XSLT session: We will discuss progress on markup, tackle problems, and refine our markup strategy accordingly

Week 12: April 12 - Transformations, Representations, and Interfaces to Digital Resources Part 3

In class on Apr 12:

  • ●● Continued: Transformation of XML - XSLT
  • ●● Continue the process of refining our markup
  • ●● Troubleshoot problems with Oxygen XML Editor
  • ●● Update field notes

Week 13: Apr 19

  • ●● Continue markup in light of ongoing challenges; refer back to user stories to help determine what we should be marking up, and why
  • ●● Begin discussion of what functionality we want our online edition to have
  • ●● Update field notes

Lab 9: Apr 21 - Computer Graphics and User Interface Lab

  • ●● Presentation by Computer Graphics and User Interface Lab (Feiner and digital assistants)

Week 14: Apr 2** 6 - Review and Conclusion**

Finalizing markup while preparing for the first launch of the digital edition

In class on Apr 26:

  • ●● Finalize markup strategy and discuss timeline to complete all entry files
  • ●● Discuss in more depth functionality required in our digital edition
  • ●● Have a first launch of our edition by 6pm

Week 15: Digital Bytes and Bites

May 3 in Fayerweather 513 from 4-6PM

  • ●● Working session to hone our markup and complete work for the launch of 1.1

May 5 in Fayerweather 411 from 3:20-5:20PM

  • ●● Working session to hone our markup and complete work for the launch of 1.1

Week 16: May 10 Digital Launch

  • ●● Digital launch to be held from 4-6PM in Fayerweather 513

S** tatement on Academic Integrity**

The intellectual venture in which we are all engaged requires of faculty and students alike the highest level of personal and academic integrity. As members of an academic community, each one of us bears the responsibility to participate in scholarly discourse and research in a manner characterized by intellectual honesty and scholarly integrity.

Scholarship, by its very nature, is an iterative process, with ideas and insights building one upon the other. Collaborative scholarship requires the study of other scholars' work, the free discussion of such work, and the explicit acknowledgement of those ideas in any work that inform our own. This exchange of ideas relies upon a mutual trust that sources, opinions, facts, and insights will be properly noted and carefully credited.

In practical terms, this means that, as students, you must be responsible for the full citations of others' ideas in all of your research papers and projects; you must be scrupulously honest when taking your examinations; you must always submit your own work and not that of another student, scholar, or internet agent.

Any breach of this intellectual responsibility is a breach of faith with the rest of our academic community. It undermines our shared intellectual culture, and it cannot be tolerated. Students failing to meet these responsibilities should anticipate being asked to leave Columbia.

Disability-Related Accommodations

In order to receive disability-related academic accommodations, students must first be registered with Disability Services (DS). More information on the DS registration process is available online at www.health.columbia.edu/ods. Faculty must be notified of registered students' accommodations before exam or other accommodations will be provided. Students who have (or think they may have) a disability are invited to contact Disability Services for a confidential discussion at (212) 854-2388 (Voice/TTY) or by email at disability@columbia.edu.

About

Repository for "What is a Book in the 21st Century" GR8975, Spring 2017

Resources

Readme
Activity
Custom properties

Stars

2 stars

Watchers

13 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 16

+ 2 contributors

Languages