Guidelines: Difference between revisions

From Semantic Name Authority Repository Cymru
Jump to navigation Jump to search
No edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
== Basics ==
* Linked data works by connecting together data entities to create rich structured data in the form of triples. For example, <br>  
* Linked data works by connecting together data entities to create rich structured data in the form of triples. For example, <br>  
  '''1.''' John Jones (Q..) '''2.''' was Educated at ([[Property:P23|P23]]) '''3.''' Aberystwyth University (Q...).   
  '''1.''' John James Jones [[Item:Q67878|Q67878]] '''2.''' was Educated at ([[Property:P23|P23]]) '''3.''' Aberystwyth University [[Item:Q32313|Q32313]].   
<be>
   
   
* The more detailed we make our data the more inter-connected the data will become.  
* The more detailed we make our data the more inter-connected the data will become.  
   
   
* When creating new items for people or places you may find the data you need to describe them, such as the place they were born or educated, does not exist. When this happens you should also create a separate item for that entity in order to complete your data entry, but make sure you search the database thoroughly first in order to avoid creating duplicate items. You can examine similar items in order to see how the data should be structured, or consult the tables below.   
* When creating new items (click 'New Item' in the lefthand menu) for people or places you may find the data you need to describe them, such as the place they were born or educated, does not exist. When this happens you should also create a separate item for that entity in order to complete your data entry, but make sure you search the database thoroughly first in order to avoid creating duplicate items. You can examine similar items in order to see how the data should be structured, or consult the tables below.   


* When creating any new item you should '''always''' search for and include the [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata] ID if it exists, using [[Property:P2|Wikidata ID (P2)]] and [[Property:P62|Wikidata URI (P62)]].  
* When creating any new item you should '''always''' search for and include the [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata] ID if it exists, using [[Property:P62|Wikidata URI (P62)]]. This helps keep the two datasets aligned and allows for federated query across both databases.
 
* A full list of Properties used in the database can be found [[Special:ListProperties|here]]
 
* If you find Duplicate items, they can be merged using the [[Special:MergeItems|Merge Tool]]. Always merge the newer item (higher Q number) into the older item (lower Q number).
 
* Do not create new properties without consultation with [[Special:ActiveUsers|SNARC ADMIN]].




Line 72: Line 77:
! Title !! ID !! Data type !! Description !! Requirement
! Title !! ID !! Data type !! Description !! Requirement
|-
|-
| Instance of || [[Property:P7|P7]] || Item  || Use with types of [[Special:WhatLinksHere/Item:Q1368|human settlement]] or items such as [[Item:Q10278|monument]], [[Item:Q9793|house]] or [[Item:Q10278|Q10255]] to best describe a place. Be as specific as you can. <br> For example for a church use [[Item:Q9762|church building]] rather than [[Item:Q8576|building]]  || style="background:{{{color|lightgreen}}}" | Always
| Instance of || [[Property:P7|P7]] || Item  || Use with types of [[Special:WhatLinksHere/Item:Q1368|human settlement]] or items such as [[Item:Q10278|monument]], [[Item:Q9793|house]] or [[Item:Q10255|Library]] to best describe a place. Be as specific as you can. <br> For example for a church use [[Item:Q9762|church building]] rather than [[Item:Q8576|building]]  || style="background:{{{color|lightgreen}}}" | Bob amser
|-
| country|| [[Property:P63|P63]] || Item  || The [[Special:WhatLinksHere/Item:Q948|country or nation]] in which the item is located. (Not used on items for countries) || style="background:{{{color|lightgreen}}}" | Bob amser
|-
|-
| country|| [[Property:P63|P63]] || Item  || The [[Special:WhatLinksHere/Item:Q948|country or nation]] in which the item is located || style="background:{{{color|lightgreen}}}" | Always
| coordinate location || [[Property:P26|P26]]|| String || add the decimal coordinates of a place e.g. <syntaxhighlight>52.414,-4.081</syntaxhighlight> || style="background:{{{color|lightgreen}}}" | Bob amser
|-
|-
| coordinate location || [[Property:P26|P26]]|| String || add the decimal coordinates of a place e.g. <syntaxhighlight>52.414,-4.081</syntaxhighlight> || style="background:{{{color|lightgreen}}}" | Always
| historic county || [[Property:P38|P38]] || Item  || For places in the UK use with any [[Special:WhatLinksHere/Item:Q9661|historic county of England]], [[Special:WhatLinksHere/Item:Q1121|historic county of Wales]] or [[Special:WhatLinksHere/Item:Q1122|historic county of the United Kingdom]] ||style="background:{{{color|lightblue}}}" | Gwell
|-
|-
| historic county || [[Property:P38|P38]] || Item  || For places in the UK use with any [[Special:WhatLinksHere/Item:Q9661|historic county of England]], [[Special:WhatLinksHere/Item:Q1121|historic county of Wales]] or [[Special:WhatLinksHere/Item:Q1122|historic county of the United Kingdom]] ||style="background:{{{color|lightblue}}}" | Preferred
| located in territorial entity || [[Property:P27|P27]] || Item  || Use to state the larger administrative area in which an item exists. Usually a [[Special:WhatLinksHere/Item:Q948|county]]||style="background:{{{color|lightblue}}}" | Gwell
|-
|-
| located in territorial entity || [[Property:P27|P27]] || Item  || Use to state the larger administrative area in which an item exists. Usually a [[Special:WhatLinksHere/Item:Q948|county]]||style="background:{{{color|lightblue}}}" | Preferred
| diocese || [[Property:P70|P70]] || Eitem || used for ecclesiastic parishes ||style="background:{{{color|gray}}}" | Dewisol
|-
|-
| source of name form || [[Property:P72|P72]] || Item || source where the standard form of the name (label) was obtained. Please create new item to describe the source if one doesn't exist. If no source is specified Wikidata is assumed. ||style="background:{{{color|gray}}}" | Optional
| parish church || [[Property:P71|P71]] || Eitem || used for ecclesiastic parishes to denote the church or churches associated with, or formally associated with a parish  ||style="background:{{{color|gray}}}" | Dewisol
|-
| source of name form || [[Property:P72|P72]] || Eitem || source where the standard form of the name (label) was obtained. Please create new item to describe the source if one doesn't exist. If no source is specified Wikidata is assumed. Only use if a recognised authority has published a standard form of the name ||style="background:{{{color|gray}}}" | Dewisol
|-
| location || [[Property:P73|P73]] || Eitem || used to state the location (city, town village ect) of the item ||style="background:{{{color|gray}}}" | Dewisol
|-
| occupant || [[Property:P79|P79]] || Eitem || used to state the current or previous occupant(s) (person or organization) of a building such as a house, chapel or hotel ||style="background:{{{color|gray}}}" | Dewisol
|}
|}


Line 92: Line 105:
! Title !! ID !! Data type !! Description !! Requirement
! Title !! ID !! Data type !! Description !! Requirement
|-
|-
| Wikidata URI || [[Property:P62|P62]] || String || the corresponding URI in Wikidata, starting with http://, NOT https:// ! Example: http://www.wikidata.org/entity/Q6682. Search [https://www.wikidata.org/wiki/Wikidata:Main%20Page Wikidata] to find the equivalent item ID whenever possible. || style="background:{{{color|lightgreen}}}" | Always
| Wikidata URI || [[Property:P62|P62]] || String || the corresponding URI in Wikidata, starting with http://, NOT https:// ! Example: http://www.wikidata.org/entity/Q6682. Search [https://www.wikidata.org/wiki/Wikidata:Main%20Page Wikidata] to find the equivalent item ID whenever possible. || style="background:{{{color|lightgreen}}}" | Bob amser
|-
|-
| National Library of Wales Authority ID || [[Property:P12|P12]] || String || identifier of persons, corporate entities and families in the National Library of Wales Archives and Manuscripts database || style="background:{{{color|gray}}}" | Optional
| National Library of Wales Authority ID || [[Property:P12|P12]] || String || identifier of persons, corporate entities and families in the National Library of Wales Archives and Manuscripts database || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| Welsh Biography ID (EN) || [[Property:P5|P5]] || String || Identifier for the Dictionary of Welsh Biography || style="background:{{{color|gray}}}" | Optional
| Welsh Biography ID (EN) || [[Property:P5|P5]] || String || Identifier for the Dictionary of Welsh Biography. Can be qualified using [[Property:P85|Date published]] to provide the date the article was published || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| Welsh Biography ID (CY) || [[Property:P5|P5]] || String || Identifier for the Dictionary of Welsh Biography || style="background:{{{color|gray}}}" | Optional
| Welsh Biography ID (CY) || [[Property:P5|P5]] || String || Identifier for the Dictionary of Welsh Biography. Can be qualified using [[Property:P85|Date published]] to provide the date the article was published || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| Library of Congress authority ID || [[Property:P11|P11]] || String || Library of Congress name authority (persons, families, corporate bodies, events, places, works and expressions) and subject authority identifier || style="background:{{{color|gray}}}" | Optional
| Library of Congress authority ID || [[Property:P11|P11]] || String || Library of Congress name authority (persons, families, corporate bodies, events, places, works and expressions) and subject authority identifier || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| ISNI ID || [[Property:P9|P9]] || String || International Standard Name Identifier for an identity || style="background:{{{color|gray}}}" | Optional
| ISNI ID || [[Property:P9|P9]] || String || International Standard Name Identifier for an identity || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| VIAF ID || [[Property:P10|P10]] || String || Identifier for the Virtual International Authority File database || style="background:{{{color|gray}}}" | Optional
| VIAF ID || [[Property:P10|P10]] || String || Identifier for the Virtual International Authority File database || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| CADW Building ID || [[Property:P68|P68]] || String || identifier for listed buildings in Wales || style="background:{{{color|gray}}}" | Optional
| CADW Building ID || [[Property:P68|P68]] || String || identifier for listed buildings in Wales || style="background:{{{color|gray}}}" | Dewisol
|-
|-
| Coflein ID || [[Property:P69|P69]] || String || identifier for an historic site, monument or building in the National Monuments Record of Wales (NMRW) database || style="background:{{{color|gray}}}" | Optional
| Coflein ID || [[Property:P69|P69]] || String || identifier for an historic site, monument or building in the National Monuments Record of Wales (NMRW) database || style="background:{{{color|gray}}}" | Dewisol
|-
| Historic Place Names of Wales ID || [[Property:P83|P83]] || String || identifier for place names in the Historic Place Names of Wales database || style="background:{{{color|gray}}}" | Dewisol
|-
| CADW Monument ID || [[Property:P84|P84]] || String || legacy identifier for CADW historic monuments || style="background:{{{color|gray}}}" | Dewisol
|}
|}
== Images ==
There are two ways to connect images with items.
# Using [[Property:P31|Wikimedia Commons media (P31)]] allows you to connect a file from Wikimedia Commons. These can be searched manually or you copy the file name directly. For example: <code>Wales Principal Areas Map.svg</code>
# If The National Library of Wales has a digital image which clearly depicts the subject of the item, this can also be linked using [[Property:P50|NLW media (P50)]] by using the persistent identifier for the image found in the NLW image viewer (handle ID). For example <code>10107/1131121</code>. You can then add a qualifier [[Property:P80|image title (P80)]] to share the short title for the image. See [[https://snarc-llgc.wikibase.cloud/wiki/Item:Q1129 example]].

Latest revision as of 12:48, 15 May 2024

Basics

  • Linked data works by connecting together data entities to create rich structured data in the form of triples. For example,
1. John James Jones Q67878 2. was Educated at (P23) 3. Aberystwyth University Q32313.  

  • The more detailed we make our data the more inter-connected the data will become.
  • When creating new items (click 'New Item' in the lefthand menu) for people or places you may find the data you need to describe them, such as the place they were born or educated, does not exist. When this happens you should also create a separate item for that entity in order to complete your data entry, but make sure you search the database thoroughly first in order to avoid creating duplicate items. You can examine similar items in order to see how the data should be structured, or consult the tables below.
  • When creating any new item you should always search for and include the Wikidata ID if it exists, using Wikidata URI (P62). This helps keep the two datasets aligned and allows for federated query across both databases.
  • A full list of Properties used in the database can be found here
  • If you find Duplicate items, they can be merged using the Merge Tool. Always merge the newer item (higher Q number) into the older item (lower Q number).
  • Do not create new properties without consultation with SNARC ADMIN.


People

Identifiers
Title ID Data type Description Requirement
Instance of P7 Item should be used with Human for people Always
Sex or gender P13 Item use male,female,non-binary,intersex,intersex,trans woman or trans man Always
Give Name(s) P15 Item find or create an item for the subjects given name(s) Always
Family Name P16 Item find or create an item for the subjects family name Always
Nationality P14 Item use any sovereign country or nation (including Wales!) Preferred
Occupation P25 Item use occupations. Choose the most specific (e.g. for Welsh Bards use Bard, not Poet or Writer) Preferred
Date of Birth P17 Date date of birth of a person. Dates can be exact or a month, year, decade, century etc. Dates can also be qualified with accuracy - circa Preferred
Date of Death P18 Date date of death of a person. Dates can be exact or a month, year, decade, century etc. Dates can also be qualified with accuracy - circa Preferred
Educated at P23 Item use any educational institution. Do not use towns, villages ect Optional
Place of Birth P21 Item can be any place (e.g. building, town, city, country) Optional
Place of Death P22 Item can be any place (e.g. building, town, city, country) Optional
Sibling P52 Item use item for brother or sister of the subject (also add 'Sibling' to the target item) Optional
Father P53 Item use item for Father of subject. For step parent use step parent. (Also add the inverse statement (Child) to the target item) Optional
Child P54 Item use item for biological child of the subject. (Also add the inverse statement (Father and or Mother) to the target item) to the target item) Optional
Mother P55 Item use item for mother of subject. For step parent use step parent. (Also add the inverse statement (Child) to the target item) Optional
Spouse P56 Item use item for spouse of subject. For unmarried partners use unmarried partner. (Also add the inverse statement (Spouse) to the target item) Optional
Relative P59 Item family member other than parent, child. Such as cousin, grandparent, ancestor ect Optional
Date christened P60 Date The date a person was christened or baptised. Especially useful when no birth date can be found Optional
Date of Burial or Cremation P61 Date The date a person was buried or cremated. Especially useful when no death date can be found Optional
Language spoken or written P20 Item use any instance of a language Optional
Short Biography P19 String For any free text associated with authority records Optional
Pseudonym P24 String Alias used by someone, often to sign creative works Optional
Social classification P81 Item Social class as recognized in traditional or state law. Currently only used in conjunction with slaveholder. Optional

Places

Places
Title ID Data type Description Requirement
Instance of P7 Item Use with types of human settlement or items such as monument, house or Library to best describe a place. Be as specific as you can.
For example for a church use church building rather than building
Bob amser
country P63 Item The country or nation in which the item is located. (Not used on items for countries) Bob amser
coordinate location P26 String add the decimal coordinates of a place e.g.
52.414,-4.081
Bob amser
historic county P38 Item For places in the UK use with any historic county of England, historic county of Wales or historic county of the United Kingdom Gwell
located in territorial entity P27 Item Use to state the larger administrative area in which an item exists. Usually a county Gwell
diocese P70 Eitem used for ecclesiastic parishes Dewisol
parish church P71 Eitem used for ecclesiastic parishes to denote the church or churches associated with, or formally associated with a parish Dewisol
source of name form P72 Eitem source where the standard form of the name (label) was obtained. Please create new item to describe the source if one doesn't exist. If no source is specified Wikidata is assumed. Only use if a recognised authority has published a standard form of the name Dewisol
location P73 Eitem used to state the location (city, town village ect) of the item Dewisol
occupant P79 Eitem used to state the current or previous occupant(s) (person or organization) of a building such as a house, chapel or hotel Dewisol

Identifier Properties

Identifiers
Title ID Data type Description Requirement
Wikidata URI P62 String the corresponding URI in Wikidata, starting with http://, NOT https:// ! Example: http://www.wikidata.org/entity/Q6682. Search Wikidata to find the equivalent item ID whenever possible. Bob amser
National Library of Wales Authority ID P12 String identifier of persons, corporate entities and families in the National Library of Wales Archives and Manuscripts database Dewisol
Welsh Biography ID (EN) P5 String Identifier for the Dictionary of Welsh Biography. Can be qualified using Date published to provide the date the article was published Dewisol
Welsh Biography ID (CY) P5 String Identifier for the Dictionary of Welsh Biography. Can be qualified using Date published to provide the date the article was published Dewisol
Library of Congress authority ID P11 String Library of Congress name authority (persons, families, corporate bodies, events, places, works and expressions) and subject authority identifier Dewisol
ISNI ID P9 String International Standard Name Identifier for an identity Dewisol
VIAF ID P10 String Identifier for the Virtual International Authority File database Dewisol
CADW Building ID P68 String identifier for listed buildings in Wales Dewisol
Coflein ID P69 String identifier for an historic site, monument or building in the National Monuments Record of Wales (NMRW) database Dewisol
Historic Place Names of Wales ID P83 String identifier for place names in the Historic Place Names of Wales database Dewisol
CADW Monument ID P84 String legacy identifier for CADW historic monuments Dewisol

Images

There are two ways to connect images with items.

  1. Using Wikimedia Commons media (P31) allows you to connect a file from Wikimedia Commons. These can be searched manually or you copy the file name directly. For example: Wales Principal Areas Map.svg
  2. If The National Library of Wales has a digital image which clearly depicts the subject of the item, this can also be linked using NLW media (P50) by using the persistent identifier for the image found in the NLW image viewer (handle ID). For example 10107/1131121. You can then add a qualifier image title (P80) to share the short title for the image. See [example].