Modelling/Documents: Difference between revisions

From MetaBase
Jump to navigation Jump to search
No edit summary
 
(20 intermediate revisions by 2 users not shown)
Line 2: Line 2:


==Modeling a document==
==Modeling a document==
There are many possible types of '''{{Q|Q21}}'''. See the [https://metabase.wikibase.cloud/query/#%23All%20types%20of%20documents%20and%20their%20Wikidata%20equivalents%0APREFIX%20wb%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fentity%2F%3E%0APREFIX%20wbt%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fprop%2Fdirect%2F%3E%0ASELECT%20%3Fitem%20%3FitemLabel%20%3Fwikidata_iri%0AWHERE%0A%7B%0A%3Fitem%20wbt%3AP4%2a%20wb%3AQ21.%0AOPTIONAL%20%7B%3Fitem%20wbt%3AP1%20%3FwikidataQ%7D%0ABIND%28URI%28concat%28%22http%3A%2F%2Fwww.wikidata.org%2Fentity%2F%22%2C%20%3FwikidataQ%29%29%20AS%20%3Fwikidata_iri%29%0ASERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22en%2Csv%22.%20%7D%0A%7D list of available types.]
When a new '''document type''' is needed, it should have {{P|P4}} = {{Q|Q21}} (see {{Q|Q47}}), or {{P|P4}} = more specific type (see {{Q|Q76}} which is a type of {{Q|Q29}}).
Document types are expected to have a {{P|P1}}, though special cases that are not relevant for Wikidata are imaginable.
===Linking topics and projects===
A document should have one or more {{P|P15}} to describe what it's about, e.g. {{Q|Q70}}. The value of this statement can be an {{Q|Q12}} (topical keyword), an activity/event (a report from an edit-a-thon), a project (a report from a project), an organization, a {{Q|Q22}}...
The more subject keywords we add, the easier it becomes to run nuanced searches and analyses.
A document that was produced within the '''scope of a particular project''', as is the case with documents produced by WMSE, should link to this project with {{P|P36}}.
Note that documents like {{Q|Q43}}, which are directly related to a particular project, but were not created during this project, will have the project as {{P|P15}} but not as {{P|P36}} (because an application is published before the project has started).
===Example items===
===Example items===
* Final report: {{Q|Q35}}
* Final report: {{Q|Q35}}
Line 7: Line 22:
* Application: {{Q|Q74}}
* Application: {{Q|Q74}}
* Poster: {{Q|Q45}}
* Poster: {{Q|Q45}}
* Slide deck: {{Q|Q21958}}


===Properties used===
===Properties used===
Line 13: Line 29:
! Required !! Property !! Example value !! Notes
! Required !! Property !! Example value !! Notes
|-
|-
| IF EXISTS || {{P|P1}}|| ||
| IF EXISTS || {{P|P1}}|| Q12323 || If a document is relevant for Wikidata (e.g. a scholarly article) and has an item there.
|-
|-
| REQUIRED || {{P|P5}} || {{Q|Q29}} || See [https://metabase.wikibase.cloud/query/#%23All%20types%20of%20documents%20and%20their%20Wikidata%20equivalents%0APREFIX%20wb%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fentity%2F%3E%0APREFIX%20wbt%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fprop%2Fdirect%2F%3E%0ASELECT%20%3Fitem%20%3FitemLabel%20%3Fwikidata_iri%0AWHERE%0A%7B%0A%3Fitem%20wbt%3AP4%2a%20wb%3AQ21.%0AOPTIONAL%20%7B%3Fitem%20wbt%3AP1%20%3FwikidataQ%7D%0ABIND%28URI%28concat%28%22http%3A%2F%2Fwww.wikidata.org%2Fentity%2F%22%2C%20%3FwikidataQ%29%29%20AS%20%3Fwikidata_iri%29%0ASERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22en%2Csv%22.%20%7D%0A%7D all available types of documents]
| REQUIRED || {{P|P5}} || {{Q|Q29}} || See [https://metabase.wikibase.cloud/query/#%23All%20types%20of%20documents%20and%20their%20Wikidata%20equivalents%0APREFIX%20wb%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fentity%2F%3E%0APREFIX%20wbt%3A%20%3Chttps%3A%2F%2Fmetabase.wikibase.cloud%2Fprop%2Fdirect%2F%3E%0ASELECT%20%3Fitem%20%3FitemLabel%20%3Fwikidata_iri%0AWHERE%0A%7B%0A%3Fitem%20wbt%3AP4%2a%20wb%3AQ21.%0AOPTIONAL%20%7B%3Fitem%20wbt%3AP1%20%3FwikidataQ%7D%0ABIND%28URI%28concat%28%22http%3A%2F%2Fwww.wikidata.org%2Fentity%2F%22%2C%20%3FwikidataQ%29%29%20AS%20%3Fwikidata_iri%29%0ASERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22en%2Csv%22.%20%7D%0A%7D all available types of documents]
Line 21: Line 37:
|REQUIRED || {{P|P8}} || ''Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden'' ||  
|REQUIRED || {{P|P8}} || ''Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden'' ||  
|-
|-
| || {{P|P20}} || {{Q|Q32}} ||  
| REQUIRED || {{P|P20}} || {{Q|Q32}} ||  
|-
|-
| || {{P|P18}} || 31 July 2019 || If no specific date can be identified, month or year is enough
| || {{P|P18}} || 31 July 2019 || If no specific date can be identified, month or year is enough
Line 30: Line 46:
|-
|-
| || {{P|P19}} || {{Q|Q77}} ||  
| || {{P|P19}} || {{Q|Q77}} ||  
|-
| || {{P|P55}} || ''67'' || For documents (normally PDF) that are stored on Wikimedia Commons.
|-
|-
| || {{P|P17}} || {{Q|Q35}} || For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
| || {{P|P17}} || {{Q|Q35}} || For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
Line 35: Line 53:
| || {{P|P35}} || {{Q|Q96}} || For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
| || {{P|P35}} || {{Q|Q96}} || For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
|-
|-
| || {{P|x}} || {{Q|x}} || Connects the document with the {{Q|Q2}} it was produced for. Note that a document that describes a project (and thus has it as {{P|P15}}) can be created after the project has ended, and thus formally "belong" to another project's scope.
| || {{P|36}} || {{Q|Q14}} || Connects the document with the {{Q|Q2}} it was produced for. Note that a document that describes a project (and thus has it as {{P|P15}}) can be created after the project has ended, and thus formally "belong" to another project's scope.
|-
|-
| || {{P|P22}} || [https://commons.wikimedia.org/wiki/File:LIBER_2020_Poster_WMSE.pdf LIBER 2020 Poster WMSE.pdf] ||  
| || {{P|P22}} || [https://commons.wikimedia.org/wiki/File:LIBER_2020_Poster_WMSE.pdf LIBER 2020 Poster WMSE.pdf] ||  
|-
|-
| || {{P|P11}} || '':wmse:Projekt:Strategisk_inkludering_av_biblioteksdata_på_Wikidata_2018/Rapportering/Inklusionsguide'' || Link to a Wikimedia page where the project is described, using an [https://en.wikipedia.org/wiki/Help:Interwiki_linking interwiki prefix].
| || {{P|P11}} || '':wmse:Projekt:Strategisk_inkludering_av_biblioteksdata_på_Wikidata_2018/Rapportering/Inklusionsguide'' || Link to a Wikimedia page where the project is described, using an [https://en.wikipedia.org/wiki/Help:Interwiki_linking interwiki prefix]. Not to be confused with {{P|P45}}.
|-
| || {{P|P46}} || {{Q|Q52}} || Indicate if the document was created specifically to be used in a particular event or the like.
|-
| || {{P|P45}} || ''wmse:Projekt:GLAM 2021/Wikimedia Commons guide'' || Link a Wikimedia page containing the document, , using an [https://en.wikipedia.org/wiki/Help:Interwiki_linking interwiki prefix]. Not to be confused with {{P|44}}.
|-
| || {{P|P44}} || ''https://digiteket.se/kurs/att-skriva-pa-wikipedia/'' || URL of a web page (not a Wikimedia wiki) containing the full body of this item
|-
| || {{P|P61}} || ''23 minutes'' || For {{Q|Q21950}}.
<!-- |-
| || {{P|.......}} || {{Q|.......}} || ........ -->
|}
|}


Line 58: Line 86:


==See also==
==See also==
* Document [https://metabase.wikibase.cloud/tools/cradle/?#/shex/E4 Cradle] and [[EntitySchema:E4|Entity Schema]].
__FORCETOC__  
__FORCETOC__  
[[Category:Documentation|d]]
[[Category:Documentation|d]]

Latest revision as of 13:27, 14 February 2024


Modeling a document

There are many possible types of document (Q21). See the list of available types.

When a new document type is needed, it should have subclass of (P4) = document (Q21) (see white paper (Q47)), or subclass of (P4) = more specific type (see final report (Q76) which is a type of report (Q29)).

Document types are expected to have a same as on Wikidata (P1), though special cases that are not relevant for Wikidata are imaginable.

Linking topics and projects

A document should have one or more main subject (P15) to describe what it's about, e.g. linked open data (Q70). The value of this statement can be an index term (Q12) (topical keyword), an activity/event (a report from an edit-a-thon), a project (a report from a project), an organization, a Wikimedia content project (Q22)...

The more subject keywords we add, the easier it becomes to run nuanced searches and analyses.

A document that was produced within the scope of a particular project, as is the case with documents produced by WMSE, should link to this project with produced in the scope of the project (P36).

Note that documents like application (Q43), which are directly related to a particular project, but were not created during this project, will have the project as main subject (P15) but not as produced in the scope of the project (P36) (because an application is published before the project has started).

Example items

Properties used

Required Property Example value Notes
IF EXISTS same as on Wikidata (P1) Q12323 If a document is relevant for Wikidata (e.g. a scholarly article) and has an item there.
REQUIRED instance of (P5) report (Q29) See all available types of documents
REQUIRED main subject (P15) Wikidata (Q20)
REQUIRED title (P8) Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden
REQUIRED language of work or name (P20) English (Q32)
publication date (P18) 31 July 2019 If no specific date can be identified, month or year is enough
addressee (P29) National Library of Sweden (Q75) For grant applications, open letters and similar documents with a specific recipient
publisher (P21) Wikimedia Sverige (Q9)
author (P19) Axel Pettersson (Q77)
number of pages (P55) 67 For documents (normally PDF) that are stored on Wikimedia Commons.
part of (P17) Strategic Inclusion of Library Data in Wikidata 2018 ‒ final report (Q35) For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
has part(s) (P35) Q96 For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
produced in the scope of the project (P36) Wikidata for authority control (Q14) Connects the document with the project (Q2) it was produced for. Note that a document that describes a project (and thus has it as main subject (P15)) can be created after the project has ended, and thus formally "belong" to another project's scope.
document file on Wikimedia Commons (P22) LIBER 2020 Poster WMSE.pdf
described at Wikimedia-page (P11) :wmse:Projekt:Strategisk_inkludering_av_biblioteksdata_på_Wikidata_2018/Rapportering/Inklusionsguide Link to a Wikimedia page where the project is described, using an interwiki prefix. Not to be confused with full work available at Wikimedia page (P45).
created for (P46) Annual General Meeting of Wikimedia Sverige, 2022 (Q52) Indicate if the document was created specifically to be used in a particular event or the like.
full work available at Wikimedia page (P45) wmse:Projekt:GLAM 2021/Wikimedia Commons guide Link a Wikimedia page containing the document, , using an interwiki prefix. Not to be confused with full work available at URL (P44).
full work available at URL (P44) https://digiteket.se/kurs/att-skriva-pa-wikipedia/ URL of a web page (not a Wikimedia wiki) containing the full body of this item
duration (P61) 23 minutes For video (Q21950).

SPARQL

Find all documents:

PREFIX wb: <https://metabase.wikibase.cloud/entity/>
PREFIX wbt: <https://metabase.wikibase.cloud/prop/direct/>
SELECT ?item ?itemLabel ?instance_of ?instance_ofLabel ?published
WHERE
{
?item wbt:P5/wbt:P4* wb:Q21.
?item wbt:P5 ?instance_of.
OPTIONAL {?item wbt:P18 ?published.}
SERVICE wikibase:label { bd:serviceParam wikibase:language "sv,en". }
}

Try it!


See also