Difference between revisions of "TrainingMaterialsFall2021"
Jump to navigation
Jump to search
(One intermediate revision by the same user not shown) | |||
Line 30: | Line 30: | ||
=== Topics === | === Topics === | ||
* Questions? | * Questions? | ||
− | * Additional discussion on [https://www.wwp.neu.edu/outreach/seminars/_current/presentations/xml_intro/xml_newIntro_15.xhtml XML validity] | + | * Additional discussion on [https://www.wwp.neu.edu/outreach/seminars/_current/presentations/xml_intro/xml_newIntro_15.xhtml XML validity] ([https://wwp.northeastern.edu/outreach/seminars/_current/presentations/xml_intro/xml_newIntro_tutorial_00.xhtml tutorial with notes]) |
*[http://www.wwp.northeastern.edu/outreach/seminars/_current/handouts/oxygenCribSheet.xhtml Basics of Using Oxygen] See also [https://github.com/NEU-DSG/wwp-public-code-share/blob/master/docs/oxygen-cheat-sheet.md Oxygen Cheat Sheet] | *[http://www.wwp.northeastern.edu/outreach/seminars/_current/handouts/oxygenCribSheet.xhtml Basics of Using Oxygen] See also [https://github.com/NEU-DSG/wwp-public-code-share/blob/master/docs/oxygen-cheat-sheet.md Oxygen Cheat Sheet] | ||
**Clearing your working space | **Clearing your working space | ||
Line 88: | Line 88: | ||
=== Topics === | === Topics === | ||
*Questions about the exercise; any encoding you'd like to see? | *Questions about the exercise; any encoding you'd like to see? | ||
− | * | + | *WWP Markup |
− | ** | + | **Named entities |
***[http://www.wwp.neu.edu/research/publications/documentation/internal/#!/entry/persName_element <persName>] | ***[http://www.wwp.neu.edu/research/publications/documentation/internal/#!/entry/persName_element <persName>] | ||
***[http://www.wwp.neu.edu/research/publications/documentation/internal/#!/entry/placeName_element <placeName>] | ***[http://www.wwp.neu.edu/research/publications/documentation/internal/#!/entry/placeName_element <placeName>] | ||
Line 139: | Line 139: | ||
===Homework=== | ===Homework=== | ||
− | *Read the WWP's notes on [https://www.wwp.northeastern.edu/research/publications/documentation/training/document_analysis.html | + | *Read the WWP's notes on [https://www.wwp.northeastern.edu/research/publications/documentation/training/document_analysis.html document analysis] |
*Begin looking at the potential texts in the [https://docs.google.com/spreadsheets/d/1f_VnBkmOjTZeXF8fi2_hhvFJMn98a_UEWxYjZQKx-jo/edit#gid=0 Aquifer] (Make note of the status, not all texts are currently up for encoding; put your name next to a text to claim it; look up EEBO and ECCO texts by starting at the [https://library.northeastern.edu/research/resources/a-to-z-index library's list of databases]) | *Begin looking at the potential texts in the [https://docs.google.com/spreadsheets/d/1f_VnBkmOjTZeXF8fi2_hhvFJMn98a_UEWxYjZQKx-jo/edit#gid=0 Aquifer] (Make note of the status, not all texts are currently up for encoding; put your name next to a text to claim it; look up EEBO and ECCO texts by starting at the [https://library.northeastern.edu/research/resources/a-to-z-index library's list of databases]) | ||
Line 199: | Line 199: | ||
**[http://www.wwp.northeastern.edu/research/publications/documentation/training/ WWP Training Guide] | **[http://www.wwp.northeastern.edu/research/publications/documentation/training/ WWP Training Guide] | ||
**[http://www.wwp.northeastern.edu/research/publications/documentation/training/start.html Training Start Page] | **[http://www.wwp.northeastern.edu/research/publications/documentation/training/start.html Training Start Page] | ||
− | |||
− | |||
− |
Latest revision as of 13:29, 21 December 2021
Before meeting
Read:
- Julia Flanders, Syd Bauman, and Sarah Connell “Text Encoding Fundamentals with TEI” (Sarah will email to you)
Optional readings:
October 6 1:30–3pm or October 8 12–1:30pm
Topics
- Intro to the WWP
- Logistics and training process notes
- Make sure to attend one instance of each session
- There are office hours you can attend if you have questions or if you need to miss a session
- A note on submitting timesheets
- Why are we here and what are we doing?
- Training will start with some foundational concepts of encoding, then move on to the specifics of how the WWP approaches things
- Some of this might feel abstract at first, but the end goal is that everyone will know how to take early women's documents and create digital models of them with XML and the Text Encoding Initiative markup language
- To do that, you first need to understand what XML is!
- Intro to XML
Session 2: October 8 3:30–5pm or October 13 2–3:30pm
Topics
- Questions?
- Additional discussion on XML validity (tutorial with notes)
- Basics of Using Oxygen See also Oxygen Cheat Sheet
- Clearing your working space
- Turn of check ID/IDREF
- Turn off default attributes
- Opening a new TEI file
- Inserting tags
- Inserting attributes
- Surrounding text with tags
- Checking validity and well-formedness
- Adding comments
- Letting Oxygen help you work!
- Setting up for homework
- Getting the textbase
- Opening the letter files and associating the schema
- Basics of Prose Markup part one
Homework
- Before our next session, please make sure that you have downloaded Oxygen, following the instructions and using the key from Sarah's email
- Practice encoding with the samples:
- To create a new “letter” XML document (in order to start the above homework):
- In oXygen, start the process to create a new XML document:
- ⌘-N (or CTL-N on Windows or Linux)
- Select (but do not double-click on) “XML Document” — typing “xml” in the filter box usually makes this pretty easy to find
- Do NOT double click on it, click on the “Create” button, or press ENTER (which is the same); rather …
- Click the “Customize” button (which is on the bottom row)
- The “New” dialog box will change dramatically; don’t panic
- The first field you can fill in is the “Schema URL” field.
- Copy the URL that points to the schema (in this case it should end in “.rnc”), and paste it into the “Schema URL” field.
- The “Root Element” field should now say “letter”.
- Now go ahead and click the “Create” button
Session 3: October 14 9–10:30am or October 15 2:30–4pm
Topics
- Question about the homework or about downloading the textbase?
- Quick tour of the WWP files
- Accessing WWO through library databases
- Basics of Prose Markup part two
- Tour of the Internal Documentation
Hands-on Practice
Homework
- Look around the Internal Documentation
- Finish Exercise 0 (you don't have to 100% finish typing out the whole thing, but try to sketch in how you would encode everything that seems distinctive—tip: try using comments to mark out the things you are skipping!)
Session 4: October 22 9–10:30am or October 22 12–1:30pm
Topics
- Questions about the exercise; any encoding you'd like to see?
- WWP Markup
- Named entities
Hands-on Practice
Homework
- Keep working on exercise 2 (you don't have to 100% finish typing out the whole thing, but try to sketch in how you would encode everything that seems distinctive—tip: try using comments to mark out the things you are skipping!)
- Review the materials in Getting started with encoding
Session 5: October 22 3:30–5pm or October 27 2–3:30pm
Topics
- Questions about the exercise; any encoding you'd like to see?
- Special Characters
- What is Unicode?
- Numeric Character References
- Adding Unicode to Mac keyboards
- Unicode Quick Guide
- Typography & Special Characters
- Hard and Soft Hyphens
- Page Breaks & Metawork
- Drama
- Poetry
Homework
- Read the WWP's notes on document analysis
- Begin looking at the potential texts in the Aquifer (Make note of the status, not all texts are currently up for encoding; put your name next to a text to claim it; look up EEBO and ECCO texts by starting at the library's list of databases)
Session 6: October 28 9–10:3pam or October 29 9:30–11am
Topics
- Text selection from the Aquifer and notes on “tadpoles”
- Rendition
- Elements for marking changes in rendition
- Rendition Ladders
- Outline of Keywords & Arguments
- Delimiters
- Default break behavior
- To see a template for setting up renditional defaults, open tagsDecl.xml in under_construction
- Linking & Referencing
- Notes
Homework
- Exercise 5: Add rendition to previous exercises (if you want to; you could also wait until after the Friday session)
Session 7: November 5 12:30–2pm or November 5 3:30–5pm
- Questions on anything so far?
- Subversion
- Version Control and Using Subversion
- There is also an outline of the basic processes for using Subversion in encoding in Getting started with encoding
- Change logs
- Supplied, Missing, & Unclear Text
- Corrections
- Workflow
- Trello
- Slack
- Listserv
- Wiki
- Office Texts
Follow up
Exercises
- For more practice: Exercise 3 and Exercise 4Exercise 1: Poetry