Guidelines: Difference between revisions

From Semantic Name Authority Repository Cymru
Jump to navigation Jump to search
No edit summary
No edit summary
 
(10 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 James Jones [[Item:Q67878|Q67878]] '''2.''' was Educated at ([[Property:P23|P23]]) '''3.''' Aberystwyth University [[Item:Q32313|Q32313]].   
  '''1.''' John James Jones [[Item:Q67878|Q67878]] '''2.''' was Educated at ([[Property:P23|P23]]) '''3.''' Aberystwyth University [[Item:Q32313|Q32313]].   
Line 5: Line 5:
* 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:MergItems|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 21: Line 27:
| Sex or gender|| [[Property:P13|P13]] || Item  || use [[Item:Q33|male]],[[Item:Q34|female]],[[Item:Q32|non-binary]],[[Item:Q35|intersex]],[[Item:Q35|intersex]],[[Item:Q36|trans woman]] or [[Item:Q37|trans man]] || style="background:{{{color|lightgreen}}}" | Always
| Sex or gender|| [[Property:P13|P13]] || Item  || use [[Item:Q33|male]],[[Item:Q34|female]],[[Item:Q32|non-binary]],[[Item:Q35|intersex]],[[Item:Q35|intersex]],[[Item:Q36|trans woman]] or [[Item:Q37|trans man]] || style="background:{{{color|lightgreen}}}" | Always
|-
|-
| Give Name(s) || [[Property:P15|P15]]|| Item || find or create an item for the subjects given name(s) || style="background:{{{color|lightgreen}}}" | Always
| Give Name(s) || [[Property:P15|P15]]|| Item || find or create an item for the subjects given name(s) || style="background:{{{color|lightgreen}}}" | Always
|-
|-
| Family Name || [[Property:P16|P16]] || Item|| find or create an item for the subjects family name || style="background:{{{color|lightgreen}}}" | Always
| Family Name || [[Property:P16|P16]] || Item|| find or create an item for the subjects family name || style="background:{{{color|lightgreen}}}" | Always
|-
|-
| Nationality || [[Property:P14|P14]] || Item || use any [[Special:WhatLinksHere/Item:Q948|sovereign country or nation]] (including Wales!) || style="background:{{{color|lightblue}}}" | Preferred  
| Nationality || [[Property:P14|P14]] || Item || use any [[Special:WhatLinksHere/Item:Q948|sovereign country or nation]] (including Wales!) || style="background:{{{color|lightblue}}}" | Preferred  
|-
|-
| Occupation || [[Property:P25|P25]] || Item || use [[Special:WhatLinksHere/Item:Q63|occupations]]. Choose the most specific (e.g. for Welsh Bards use Bard, not Poet or Writer) ||style="background:{{{color|lightblue}}}" | Preferred
| Occupation || [[Property:P25|P25]] || Item || use [[Special:WhatLinksHere/Item:Q63|occupations]]. Choose the most specific (e.g. for Welsh Bards use Bard, not Poet or Writer) ||style="background:{{{color|lightblue}}}" | Preferred
|-
|-
| Date of Birth || [[Property:P17|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 [[Property:P67|accuracy]] - [[Item:Q1578|circa]] ||style="background:{{{color|lightblue}}}" | Preferred
| Date of Birth || [[Property:P17|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 [[Property:P67|accuracy]] - [[Item:Q1578|circa]] ||style="background:{{{color|lightblue}}}" | Preferred
Line 33: Line 39:
| Date of Death || [[Property:P18|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 [[Property:P67|accuracy]] - [[Item:Q1578|circa]] ||style="background:{{{color|lightblue}}}" | Preferred
| Date of Death || [[Property:P18|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 [[Property:P67|accuracy]] - [[Item:Q1578|circa]] ||style="background:{{{color|lightblue}}}" | Preferred
|-
|-
| Educated at || [[Property:P23|P23]] || Item || use any [[Special:WhatLinksHere/Item:Q38|educational institution]]. Do not use towns, villages ect ||style="background:{{{color|gray}}}" | Optional
| Educated at || [[Property:P23|P23]] || Item || use any [[Special:WhatLinksHere/Item:Q38|educational institution]]. Do not use towns, villages ect ||style="background:{{{color|gray}}}" | Optional
|-
|-
| Place of Birth || [[Property:P21|P21]] || Item || can be any place (e.g. building, town, [[Special:WhatLinksHere/Item:Q1367|city]], [[Special:WhatLinksHere/Item:Q948|country]]) ||style="background:{{{color|gray}}}" | Optional
| Place of Birth || [[Property:P21|P21]] || Item || can be any place (e.g. building, town, [[Special:WhatLinksHere/Item:Q1367|city]], [[Special:WhatLinksHere/Item:Q948|country]]) ||style="background:{{{color|gray}}}" | Optional
Line 71: 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}}}" | Always
|-
|-
| country|| [[Property:P63|P63]] || Item  || The [[Special:WhatLinksHere/Item:Q948|country or nation]] in which the item is located || style="background:{{{color|lightgreen}}}" | Always
| 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}}}" | 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}}}" | 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}}}" | Always
Line 81: Line 87:
| 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
| 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
|-
|-
| 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
| diocese || [[Property:P70|P70]] || Item || used for ecclesiastic parishes ||style="background:{{{color|gray}}}" | Optional
|-
| parish church || [[Property:P71|P71]] || Item || used for ecclesiastic parishes to denote the church or churches associated with, or formally associated with a parish  ||style="background:{{{color|gray}}}" | Optional
|-
| 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. Only use if a recognised authority has published a standard form of the name ||style="background:{{{color|gray}}}" | Optional
|-
| location || [[Property:P73|P73]] || Item || used to state the location (city, town village ect) of the item ||style="background:{{{color|gray}}}" | Optional
|-
| occupant || [[Property:P79|P79]] || Item || 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}}}" | Optional
|}
|}


Line 95: Line 109:
| 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}}}" | Optional
|-
|-
| 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}}}" | Optional
|-
|-
| 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}}}" | 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}}}" | 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}}}" | Optional
Line 108: Line 122:
|-
|-
| 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}}}" | Optional
|-
| 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}}}" | Optional
|-
| CADW Monument ID || [[Property:P84|P84]] || String || legacy identifier for CADW historic monuments || style="background:{{{color|gray}}}" | Optional
|}
|}
== 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 17:48, 25 July 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
Always
country P63 Item The country or nation in which the item is located. (Not used on items for countries) Always
coordinate location P26 String add the decimal coordinates of a place e.g.
52.414,-4.081
Always
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 Preferred
located in territorial entity P27 Item Use to state the larger administrative area in which an item exists. Usually a county Preferred
diocese P70 Item used for ecclesiastic parishes Optional
parish church P71 Item used for ecclesiastic parishes to denote the church or churches associated with, or formally associated with a parish Optional
source of name form 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. Only use if a recognised authority has published a standard form of the name Optional
location P73 Item used to state the location (city, town village ect) of the item Optional
occupant P79 Item used to state the current or previous occupant(s) (person or organization) of a building such as a house, chapel or hotel Optional

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. Always
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 Optional
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 Optional
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 Optional
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 Optional
ISNI ID P9 String International Standard Name Identifier for an identity Optional
VIAF ID P10 String Identifier for the Virtual International Authority File database Optional
CADW Building ID P68 String identifier for listed buildings in Wales Optional
Coflein ID P69 String identifier for an historic site, monument or building in the National Monuments Record of Wales (NMRW) database Optional
Historic Place Names of Wales ID P83 String identifier for place names in the Historic Place Names of Wales database Optional
CADW Monument ID P84 String legacy identifier for CADW historic monuments Optional

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].