Modelling/Documents: Difference between revisions
| Line 8: | Line 8: | ||
Document types are expected to have a {{P|P1}}, though special cases that are not relevant for Wikidata are imaginable. | 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}}... | 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}}... | ||
Revision as of 13:01, 10 May 2023
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
- Final report: Strategic Inclusion of Library Data in Wikidata 2018 ‒ final report (Q35)
- White paper: WMSE white paper on Structured Data on Commons (Q89)
- Application: Strategic Inclusion of Library Data in Wikidata 2018 ‒ application (Q74)
- Poster: Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden (Q45)
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 | |
| 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) | ||
| 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. |
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". }
}