Modelling/Documents
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 sameAs 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)
- Slide deck: Wikidata at the museum (Q21958)
Properties used
| Required | Property | Example value | Notes |
|---|---|---|---|
| IF EXISTS | sameAs 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 2021 (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". }
}
See also
- Document Cradle and Entity Schema.