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 inserted into the JSTOR Knowledge Graph using Google Sheets.
Please treat this as a living document 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.
- In terms of order of operations, the book must exist in either Wikidata or the local JSTOR Knowledge Graph before it can be referenced by our Surface Mention Spreadsheet. If it does not exist in either place, proceed to our guide on loading items into our knowledge graph. To check if the item exists, search for it on either wikidata.org or use the search bar on this page.
- The Surface Mention spreadsheet is comprised of the following fields:
- Ingest data (button)
- Generally this is the last field to be updated. Once all other desired fields are populated, write TRUE in the 'Ingest Data' column and click the 'Ingest data' button. Clicking that button will run the script.
- local id
- Please leave this field blank, it will be populated with a QID by our script.
- Please also leave this blank, it will be auto-populated.
- part of
- This is the herbal or volume from which the mention is taken. Populate this field with either the exact label or QID of the item.
- For example, please use either Theatrum Botanicum or Q12593. Both of these items link to Theatrum Botanicum.
- page number(s)
- This is page number (on the physical book copy).
- This should be the URL displayed when looking at the particular mention.
- Please note that at this time we only accept Biodiversity Heritage Library URLs.
- 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.
- A parenthetical language code for each historic name is required. 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.
- As a last note, there is a notes field available. This is a free-form text field, nothing entered into this field will be ingested.
- Ingest data (button)
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.