Help:Contributing/import: Difference between revisions
Jump to navigation
Jump to search
AddSource author search (free text / Wikidata Q-ids) + candidate record-details links (via update-page on MediaWiki MCP Server) |
class-first AddSource: class picker, per-class fields, child/parent classes, YouTube, required authors (deployed 2026-08-23) (via update-page on MediaWiki MCP Server) |
||
| Line 1: | Line 1: | ||
Instead of hand-creating an item per author or source, use the external-authority pages in the '''semantic tools''' sidebar. | 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) and let you pick the right record. They 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. | They fetch metadata from public services (Wikidata, dblp, OpenAlex, Crossref, Open Library, ORCID, YouTube) and let you pick the right record. They create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, YouTube IDs, …) 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. | ||
{| class="wikitable" style="width:100%" | {| class="wikitable" style="width:100%" | ||
| Line 8: | Line 8: | ||
| [[Special:AddPerson]] || a person item || ORCID iD, Wikidata Q, or a name | | [[Special:AddPerson]] || a person item || ORCID iD, Wikidata Q, or a name | ||
|- | |- | ||
| [[Special:AddSource]] || a | | [[Special:AddSource]] || a source item — see the class list below || class first, then the class-specific input | ||
|- | |- | ||
| [[Special:AddCollective]] || a non-person agent item (organization, company, band, collective, institution) || a name | | [[Special:AddCollective]] || a non-person agent item (organization, company, band, collective, institution) || a name | ||
|} | |} | ||
Workflow: search → review the candidates (same-name disambiguation | == Special:AddSource is class-first == | ||
[[Special:AddSource]] opens on a '''class picker'''. Choose the kind of source first; the page then shows the adapted search fields (if any) and the adapted review fields for that class. | |||
{| class="wikitable" style="width:100%" | |||
! Class !! Kind !! Search input | |||
|- | |||
| Book || parent || ISBN-13, title, or author | |||
|- | |||
| Scholarly article || parent || DOI, title, or author | |||
|- | |||
| Website || parent, manual entry || — (enter URL + title by hand) | |||
|- | |||
| Song · Film · Video || parent || title or author (Wikidata) | |||
|- | |||
| YouTube channel || parent || YouTube name '''or URL''' (exact match for a URL) | |||
|- | |||
| YouTube video || child of YouTube channel || YouTube name '''or URL''' | |||
|- | |||
| Book excerpt || child of book || — (manual: parent book + pages) | |||
|- | |||
| Web page || child of website || — (manual: parent website + URL) | |||
|} | |||
* '''Child classes need a parent''': for a book excerpt, YouTube video or web page you first pick the parent item (book, YouTube channel, website) with an entity search box. The line under the box — ''"Book not yet imported to RonzzWikiBase? import it yourself"'' — jumps to the parent's import page. On creation the child is linked to the parent with a <code>part of</code> statement. | |||
* '''Website vs web page''': add an '''entire website''' once, then add specific pages as child items (see the explanation on [[Special:AddSource/website]]). | |||
* '''Duration''' (film, song, video, YouTube video): type <syntaxhighlight lang="text" inline>MM:SS</syntaxhighlight> or <syntaxhighlight lang="text" inline>HH:MM:SS</syntaxhighlight> — stored in seconds. | |||
* '''A source needs at least one author''': the review step requires picking author '''entities''' (person, organization or group — type a name to search, or type a Q-id). Create missing people first via [[Special:AddPerson]]. This is enforced at creation. | |||
== Workflow == | |||
For classes with an authority: search → review the candidates (same-name disambiguation) → create. Each candidate carries a ''see record details'' link to its canonical authority page (opens in a new tab). 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 entry at <code>Special:AddSource/<class>/manual</code>. | |||
Notes: | Notes: | ||
* The authority lookups run '''only when you click search''' — never on page load. | * The authority lookups run '''only when you click search''' — never on page load. | ||
* '''Author search''' on | * '''Author search''' on the book / scholarly-article / film / song / video pages narrows the results for common titles. Toggle between '''free text''' (an author name, e.g. Albert Einstein) and '''semantic entities''' (Wikidata Q-ids, comma-separated — e.g. Q937, Q42). The semantic mode resolves works by the author entities on the Wikidata hub. | ||
* '''YouTube''': paste a URL for an exact match (no match → ''no match for the provided URL''), or type a name for the top 10 matches. | |||
* 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. | * 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 '''type''' 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). | ||
| Line 25: | Line 57: | ||
* [[Help:Contributing]] — the hub | * [[Help:Contributing]] — the hub | ||
* [[Help:Contributing/entities]] — creating and editing items and properties | * [[Help:Contributing/entities]] — creating and editing items and properties | ||
* [[Help:Contributing/semanticDynamicContent]] — page↔item sitelinks (incl. the Sitelink tab) | |||
Revision as of 03:55, 23 August 2026
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, YouTube) and let you pick the right record. They create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, YouTube IDs, …) 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 source item — see the class list below | class first, then the class-specific input |
| Special:AddCollective | a non-person agent item (organization, company, band, collective, institution) | a name |
Special:AddSource is class-first
Special:AddSource opens on a class picker. Choose the kind of source first; the page then shows the adapted search fields (if any) and the adapted review fields for that class.
| Class | Kind | Search input |
|---|---|---|
| Book | parent | ISBN-13, title, or author |
| Scholarly article | parent | DOI, title, or author |
| Website | parent, manual entry | — (enter URL + title by hand) |
| Song · Film · Video | parent | title or author (Wikidata) |
| YouTube channel | parent | YouTube name or URL (exact match for a URL) |
| YouTube video | child of YouTube channel | YouTube name or URL |
| Book excerpt | child of book | — (manual: parent book + pages) |
| Web page | child of website | — (manual: parent website + URL) |
- Child classes need a parent: for a book excerpt, YouTube video or web page you first pick the parent item (book, YouTube channel, website) with an entity search box. The line under the box — "Book not yet imported to RonzzWikiBase? import it yourself" — jumps to the parent's import page. On creation the child is linked to the parent with a
part ofstatement. - Website vs web page: add an entire website once, then add specific pages as child items (see the explanation on Special:AddSource/website).
- Duration (film, song, video, YouTube video): type
MM:SSorHH:MM:SS— stored in seconds. - A source needs at least one author: the review step requires picking author entities (person, organization or group — type a name to search, or type a Q-id). Create missing people first via Special:AddPerson. This is enforced at creation.
Workflow
For classes with an authority: search → review the candidates (same-name disambiguation) → create. Each candidate carries a see record details link to its canonical authority page (opens in a new tab). 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 entry at Special:AddSource/<class>/manual.
Notes:
- The authority lookups run only when you click search — never on page load.
- Author search on the book / scholarly-article / film / song / video pages narrows the results for common titles. Toggle between free text (an author name, e.g. Albert Einstein) and semantic entities (Wikidata Q-ids, comma-separated — e.g. Q937, Q42). The semantic mode resolves works by the author entities on the Wikidata hub.
- YouTube: paste a URL for an exact match (no match → no match for the provided URL), or type a name for the top 10 matches.
- The provenance form on Special:AddQuotation (and the other content pages) has entity search + autofill for
attributed toandsource: 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
- Help:Contributing — the hub
- Help:Contributing/entities — creating and editing items and properties
- Help:Contributing/semanticDynamicContent — page↔item sitelinks (incl. the Sitelink tab)