This page should serve as a resource for the 2019-2020 Dumbarton Oaks Fellows. It is intended to help guide them through the process of ingesting and manipulating Surface Mention data in the JSTOR Knowledge Graph using Google Sheets. Please treat this as a living document, reach out to us at JSTOR Labs with feedback, and check back frequently for updates.
If you are having issues with any stage of this process feel free to reach out to us via Slack or email.
To record Surface Mentions in a book or herbal, follow the steps below:
- First identify the plant that is mentioned in the book or herbal.
- Ensure the book is loaded into our local knowledge graph. If not proceed to our guide on loading items into our knowledge graph. In terms of order of operations, the book must exist in the local JSTOR Knowledge Graph before it can be used in our Surface Mention Spreadsheet.
- The Surface Mention spreadsheet is comprised of the following columns:
- ready for ingest
- Once all desired fields are populated, write TRUE in the 'Ingest Data' column and click the 'Ingest Data' button.
- local id
- This will be populated with a QID by our script.
- This will also be populated by our script.
- part of
- This is the herbal or volume from which the mention is taken. Populate this with either the name of the item or the QID.
- For example, please use either Theatrum Botanicum or jstor:Q12593. Both of these items link to Theatrum Botanicum.
- page number(s)
- This is page number (on the physical book copy)
- Please note that at this time we only accept Biodiversity Heritage Library URLs.
- This should link to the particular mention
- historic name
- Please note that the spreadsheet does support the addition of multiple historic names. The preferred method for doing so is to create a separate row for each new historic name, however, pipe delimiters ( | ) within an individual cell are also supported.
- Please include a parenthetical language code for each historic name. For example, Acacia (la). See a list of Wikimedia language codes/lists/all. We have preprocessed a number of languages, if you include one not in our list, please feel free to reach out.
- main subject
- This field denotes the modern plant genus or species information, if known. It can be populated with either text or a QID.
- Please note that the text entered must exactly match the label of the entity in the knowledge graph.
- plant description
- This is a free form text field for additional notes
- If apt, the images associated with a particular mention are demarked through the image: page, image: creator, image creator name string, and image: inception fields.
- In image: page the user identifies the page range of the mention (usually one page).
- They also denote the engraver, or artist as identified by either QID or string.
- Finally, image: inception is used to identify the creation date of those images. At this time, only an exact YYYY format is supported.
- ready for ingest
Once ingested, each item can be manually manipulated. Each item an be accessed via its local id or found by searching in the knowledge graph. To edit an item, first login and click on edit.