Difference between revisions of "Adding Items"

From JSTOR Labs Wikibase
Jump to navigation Jump to search
(Created page with "===Manual Edits=== Please find below information about editing or creating an individual Knowledge Graph page. Individual Knowledge graph entries can be updated or created m...")
 
Line 1: Line 1:
===Manual Edits===
 
 
Please find below information about editing or creating an individual Knowledge Graph page.
 
 
Individual Knowledge graph entries can be updated or created manually once a username has been created. Please contact [mailto:Labs@ithaka.org JSTOR Labs via email to create a username].
 
 
To add individual items
 
 
# Click on the [https://kg.jstor.org/wiki/Special:NewItem Add New Item tag] on the left tool bar of this page.
 
# Enter a label, description, and alias (if applicable). Please note that aliases are separated either by a new line (preferred) or the pipe symbol ( | ). Click create.
 
# Once the base document has been created, feel free to enter any additional properties through the 'add statement' button.
 
## A master list of properties can be found [https://kg.jstor.org/wiki/Special:ListProperties here].
 
## It may help to see some examples of items with many properties. Find some useful examples below:
 
### [https://kg.jstor.org/wiki/Item:Q6529 Persea americana]
 
### [https://kg.jstor.org/wiki/Item:Q5737 Exoticorum libri decem]
 
# Due to the experimental nature of this early-stage product, known data caveats are as follows:
 
## We only support images added from the [https://www.biodiversitylibrary.org/ Bioheritage Diversity Library]. Thus, if you would like to link to individual pages within a book or herbal, please locate it on the BHL website and add the DOI under the property tag: [https://kg.jstor.org/wiki/Property:P134 full work available at (P134)].
 
## If looking to add a linked property, for example, mentions in [https://plants.jstor.org/ JSTOR Global Plants] ... should we encourage this to be done manually?
 
 
===Programatic Edits===
 
 
 
This section includes information for the Dumbarton Oaks fellows about updating JSTOR's Knowledge Graph programmatically using a Google sheet interface.
 
This section includes information for the Dumbarton Oaks fellows about updating JSTOR's Knowledge Graph programmatically using a Google sheet interface.
  
 
Please note that if referencing an entity, the thing must exist before it can be referenced.  
 
Please note that if referencing an entity, the thing must exist before it can be referenced.  
 
 
If the thing exists in the knowledge graph, refer to it as a QID rather than as an entity label.
 
If the thing exists in the knowledge graph, refer to it as a QID rather than as an entity label.
  
 
====Items====
 
====Items====
  
To add an item or series of items into the Knowledge Graph, follow the steps below:
+
To add an item or series of items into the Knowledge Graph, follow the steps below. Please note that a user must be in the PH - Master spreadsheet:
  
# Search for item on [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata]. If this item does not exist on Wikidata, skip to step two.
+
# Search for an item on [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata]. If this item does not exist on Wikidata, skip to step two.
## Copy Wikidata QID from the webpage header. For example, a search for Cactaceae reveals a QID of Q14560.
+
## If it does exist, copy the Wikidata QID from the webpage header. For example, a search for Cactaceae reveals a QID of Q14560.
## In the spreadsheet, paste the QID into 'wikidata id' column.
+
## In the PH - Master spreadsheet, paste the QID into 'wikidata id' column.
## If the 'wikidata id' column is populated, the remaining fields will be auto-populated based on Wikidata's fields. Based on what information is desired, proceed to step two.
+
## If the 'wikidata id' column is populated, the remaining fields will be auto-populated based on Wikidata's fields. Based on what information is desired.
# Populate 'label,' 'description,' 'aliases,' 'instance of,' 'subclass of' fields with string fields. Where apt, populate remaining fields with Wikidata QID information.
+
# The following fields are required: 'label,' 'description,' 'aliases.' Where apt, populate remaining fields with Wikidata QID information.
 
## For example, the Wikidata QID for Latin is Q397. This can be used to populate the 'language of work or name' field.
 
## For example, the Wikidata QID for Latin is Q397. This can be used to populate the 'language of work or name' field.
 
## As a reminder, these fields will be auto-populated based on what data is drawn from the 'wikidata id.'
 
## As a reminder, these fields will be auto-populated based on what data is drawn from the 'wikidata id.'
Line 50: Line 28:
 
# If populating a field that requires a QID, ensure that the item exists in either Wikidata or the JSTOR Knowledge Graph.
 
# If populating a field that requires a QID, ensure that the item exists in either Wikidata or the JSTOR Knowledge Graph.
 
# Once satisfied with the information given, populate the 'Ingest Data' cell with a TRUE value, and click the 'Ingest Data' button. This will run the script and generate a local knowledge graph id upon completion. There is a known lag, please give it a minute.
 
# Once satisfied with the information given, populate the 'Ingest Data' cell with a TRUE value, and click the 'Ingest Data' button. This will run the script and generate a local knowledge graph id upon completion. There is a known lag, please give it a minute.
 +
 +
===Manual Edits===
 +
 +
Please find below information about editing or creating an individual Knowledge Graph page.
 +
 +
Individual Knowledge graph entries can be updated or created manually once a username has been created. Please contact [mailto:Labs@ithaka.org JSTOR Labs via email to create a username].
 +
 +
To add individual items
 +
 +
# Click on the [https://kg.jstor.org/wiki/Special:NewItem Add New Item tag] on the left tool bar of this page.
 +
# Enter a label, description, and alias (if applicable). Please note that aliases are separated either by a new line (preferred) or the pipe symbol ( | ). Click create.
 +
# Once the base document has been created, feel free to enter any additional properties through the 'add statement' button.
 +
## A master list of properties can be found [https://kg.jstor.org/wiki/Special:ListProperties here].
 +
## It may help to see some examples of items with many properties. Find some useful examples below:
 +
### [https://kg.jstor.org/wiki/Item:Q6529 Persea americana]
 +
### [https://kg.jstor.org/wiki/Item:Q5737 Exoticorum libri decem]
 +
# Due to the experimental nature of this early-stage product, known data caveats are as follows:
 +
## We only support images added from the [https://www.biodiversitylibrary.org/ Bioheritage Diversity Library]. Thus, if you would like to link to individual pages within a book or herbal, please locate it on the BHL website and add the DOI under the property tag: [https://kg.jstor.org/wiki/Property:P134 full work available at (P134)].
 +
## If looking to add a linked property, for example, mentions in [https://plants.jstor.org/ JSTOR Global Plants] ... should we encourage this to be done manually?

Revision as of 21:25, 19 November 2019

This section includes information for the Dumbarton Oaks fellows about updating JSTOR's Knowledge Graph programmatically using a Google sheet interface.

Please note that if referencing an entity, the thing must exist before it can be referenced. If the thing exists in the knowledge graph, refer to it as a QID rather than as an entity label.

Items

To add an item or series of items into the Knowledge Graph, follow the steps below. Please note that a user must be in the PH - Master spreadsheet:

  1. Search for an item on Wikidata. If this item does not exist on Wikidata, skip to step two.
    1. If it does exist, copy the Wikidata QID from the webpage header. For example, a search for Cactaceae reveals a QID of Q14560.
    2. In the PH - Master spreadsheet, paste the QID into 'wikidata id' column.
    3. If the 'wikidata id' column is populated, the remaining fields will be auto-populated based on Wikidata's fields. Based on what information is desired.
  2. The following fields are required: 'label,' 'description,' 'aliases.' Where apt, populate remaining fields with Wikidata QID information.
    1. For example, the Wikidata QID for Latin is Q397. This can be used to populate the 'language of work or name' field.
    2. As a reminder, these fields will be auto-populated based on what data is drawn from the 'wikidata id.'
  3. Once all desired fields are populated, write TRUE in the 'Ingest Data' column and click the 'Ingest Data' button.
    1. NB: A green pop-up will appear on Google Sheets, informing the user that a script is running and that a script has finished, however, the data fields will still remain empty. This is a known data lag, please be patient as the database updates.
  4. Upon completion of the script, a 'local id' will be produced (In the case of Cactaceae, QID Q994 will be produced).


Books and Herbals

Adding herbals to the knowledge graph follows much the same format as adding items:

  1. First look up the item in Wikidata. If it exists fill in supplemental material as desired. These facets could include author or printer information, or full work information.
  2. If Wikidata QID is provided, please note that existing fields do not need to be repeated on spreadsheet.
  3. If populating a field that requires a QID, ensure that the item exists in either Wikidata or the JSTOR Knowledge Graph.
  4. Once satisfied with the information given, populate the 'Ingest Data' cell with a TRUE value, and click the 'Ingest Data' button. This will run the script and generate a local knowledge graph id upon completion. There is a known lag, please give it a minute.

Manual Edits

Please find below information about editing or creating an individual Knowledge Graph page.

Individual Knowledge graph entries can be updated or created manually once a username has been created. Please contact JSTOR Labs via email to create a username.

To add individual items

  1. Click on the Add New Item tag on the left tool bar of this page.
  2. Enter a label, description, and alias (if applicable). Please note that aliases are separated either by a new line (preferred) or the pipe symbol ( | ). Click create.
  3. Once the base document has been created, feel free to enter any additional properties through the 'add statement' button.
    1. A master list of properties can be found here.
    2. It may help to see some examples of items with many properties. Find some useful examples below:
      1. Persea americana
      2. Exoticorum libri decem
  4. Due to the experimental nature of this early-stage product, known data caveats are as follows:
    1. We only support images added from the Bioheritage Diversity Library. Thus, if you would like to link to individual pages within a book or herbal, please locate it on the BHL website and add the DOI under the property tag: full work available at (P134).
    2. If looking to add a linked property, for example, mentions in JSTOR Global Plants ... should we encourage this to be done manually?