Help:Contributing/import: Difference between revisions

From Wikibase
Jump to navigation Jump to search
docs: migrate contribution guide §11 (import from external authorities) from docs/contribution-guide.md (via create-page on MediaWiki MCP Server)
 
Rewrite in code-guide style: strip translation markup, <code> for plain tokens (via update-page on MediaWiki MCP Server)
Line 1: Line 1:
<languages/>
Instead of hand-creating an item per author or source, use the external-authority pages in the '''semantic tools''' sidebar. They fetch metadata from public services (Wikidata, dblp, OpenAlex, Crossref, Open Library, ORCID), let you pick the right record, and create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, …) and citation metadata (given/family name, published in, publisher, pages, volume, issue) — every imported statement carries an <syntaxhighlight lang="text" inline>imported from <authority></syntaxhighlight> reference.
 
<translate>
<!--T:1-->
Instead of hand-creating an item per author or source, use the external-authority pages in the <b>semantic tools</b> sidebar. They fetch metadata from public services (Wikidata, dblp, OpenAlex, Crossref, Open Library, ORCID), let you pick the right record, and create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, …) and citation metadata (given/family name, published in, publisher, pages, volume, issue) — every imported statement carries an <tvar name="ref"><syntaxhighlight lang="text" inline>imported from <authority></syntaxhighlight></tvar> reference.
</translate>


{| class="wikitable" style="width:100%"
{| class="wikitable" style="width:100%"
! Page !! Creates !! Input
|-
|-
! <translate><!--T:2--> Page</translate> !! <translate><!--T:3--> Creates</translate> !! <translate><!--T:4--> Input</translate>
| [[Special:AddPerson]] || a person item || ORCID iD, Wikidata Q, or a name
|-
| <translate><!--T:5--> <tvar name="p1">[[Special:AddPerson]]</tvar></translate> || <translate><!--T:6--> a person item</translate> || <translate><!--T:7--> ORCID iD, Wikidata Q, or a name</translate>
|-
|-
| <translate><!--T:8--> <tvar name="p2">[[Special:AddSource]]</tvar></translate> || <translate><!--T:9--> a work item (book, scholarly article, website, song, film, video)</translate> || <translate><!--T:10--> DOI, ISBN-13, or a title</translate>
| [[Special:AddSource]] || a work item (book, scholarly article, website, song, film, video) || DOI, ISBN-13, or a title
|-
|-
| <translate><!--T:11--> <tvar name="p3">[[Special:AddCollective]]</tvar></translate> || <translate><!--T:12--> a non-person agent item (organization, company, band, collective, institution)</translate> || <translate><!--T:13--> a name</translate>
| [[Special:AddCollective]] || a non-person agent item (organization, company, band, collective, institution) || a name
|}
|}


<translate>
Workflow: search → review the candidates (same-name disambiguation) → confirm the class (pre-inferred from the authority) → create. Repeating a lookup for an already-imported label reuses the existing item (create-or-skip). The English label comes from the authority; add <code>fr</code>/<code>eo</code> labels afterwards. Fetch failures degrade to manual item creation at [[Special:NewItem]].
<!--T:14-->
Workflow: search → review the candidates (same-name disambiguation) → confirm the class (pre-inferred from the authority) → create. Repeating a lookup for an already-imported label reuses the existing item (create-or-skip). The English label comes from the authority; add <tvar name="fr"><syntaxhighlight lang="text" inline>fr</syntaxhighlight></tvar>/<tvar name="eo"><syntaxhighlight lang="text" inline>eo</syntaxhighlight></tvar> labels afterwards. Fetch failures degrade to manual item creation at <tvar name="newitem">[[Special:NewItem]]</tvar>.
</translate>


<translate>
<!--T:15-->
Notes:
Notes:
* The authority lookups run <b>only when you click search</b> — never on page load.
* The authority lookups run '''only when you click search''' — never on page load.
* The provenance form on <tvar name="aq">[[Special:AddQuotation]]</tvar> (and the other content pages) has entity <b>search + autofill</b> for <tvar name="at"><syntaxhighlight lang="text" inline>attributed to</syntaxhighlight></tvar> and <tvar name="src"><syntaxhighlight lang="text" inline>source</syntaxhighlight></tvar>: type a name, pick the entity, the item id is filled in. Manually typed ids still work.
* The provenance form on [[Special:AddQuotation]] (and the other content pages) has entity '''search + autofill''' for <code>attributed to</code> and <code>source</code>: type a name, pick the entity, the item id is filled in. Manually typed ids still work.
* Citations use the source item's harvested metadata (journal name, publisher, volume/issue/pages, DOI, ISBN) and cite the source <b>type</b> correctly (a book quote cites as a book, a song quote as a song).
* Citations use the source item's harvested metadata (journal name, publisher, volume/issue/pages, DOI, ISBN) and cite the source '''type''' correctly (a book quote cites as a book, a song quote as a song).
</translate>


== <translate><!--T:16--> See also</translate> ==
== See also ==


<translate>
* [[Help:Contributing]] — the hub
<!--T:17-->
* [[Help:Contributing/entities]] — creating and editing items and properties
* <tvar name="hub">[[Help:Contributing]]</tvar> — the hub
* <tvar name="entities">[[Help:Contributing/entities]]</tvar> — creating and editing items and properties
</translate>

Revision as of 17:27, 19 August 2026

Languages: English · français · Esperanto

Instead of hand-creating an item per author or source, use the external-authority pages in the semantic tools sidebar. They fetch metadata from public services (Wikidata, dblp, OpenAlex, Crossref, Open Library, ORCID), let you pick the right record, and create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, …) and citation metadata (given/family name, published in, publisher, pages, volume, issue) — every imported statement carries an imported from <authority> reference.

Page Creates Input
Special:AddPerson a person item ORCID iD, Wikidata Q, or a name
Special:AddSource a work item (book, scholarly article, website, song, film, video) DOI, ISBN-13, or a title
Special:AddCollective a non-person agent item (organization, company, band, collective, institution) a name

Workflow: search → review the candidates (same-name disambiguation) → confirm the class (pre-inferred from the authority) → create. Repeating a lookup for an already-imported label reuses the existing item (create-or-skip). The English label comes from the authority; add fr/eo labels afterwards. Fetch failures degrade to manual item creation at Special:NewItem.

Notes:

  • The authority lookups run only when you click search — never on page load.
  • The provenance form on Special:AddQuotation (and the other content pages) has entity search + autofill for attributed to and source: type a name, pick the entity, the item id is filled in. Manually typed ids still work.
  • Citations use the source item's harvested metadata (journal name, publisher, volume/issue/pages, DOI, ISBN) and cite the source type correctly (a book quote cites as a book, a song quote as a song).

See also