Help:Contributing/import: Difference between revisions

From Wikibase
Jump to navigation Jump to search
← Older editNewer edit →

SeedBot (talk | contribs)

4 user groups
5,323 edits
Restore full page + round-2 edits (previous update replaced the whole page by mistake) (via update-page on MediaWiki MCP Server)
Portrait section: collapse toggle + validate button + author/license-info (upload enhancements) (via update-page on MediaWiki MCP Server)
Tag: Replaced
Line 1: Line 1:
Instead of hand-creating an item per author or source, use the external-authority pages in the '''semantic tools''' sidebar.
* '''Portrait''' — optional, behind the ''"I will upload a portrait image for this person"'' toggle: upload a local image file or paste an image URL. For a pasted URL, click '''Validate''' next to the field — a preview thumbnail, the pixel + file size and a best-effort auto-fill of the author / licence fields appear (Wikimedia image URLs are read from your browser, so they are not rate-limited). Fill the '''portrait license''' (required when a portrait is provided), and optionally '''Portrait author''' and '''Additional license information''' (free text — e.g. the attribution line for a CC BY image). The file is saved as <code>File:&lt;name&gt;-portrait.&lt;ext&gt;</code> and linked from the item with <code>image</code>, <code>license</code>, <code>image author</code> and <code>additional license information</code> statements.
 
They fetch metadata from public services (Wikidata, dblp, OpenAlex, Crossref, Open Library, ORCID, YouTube, Wikipedia) and let you pick the right record. They create a local stub item with the authority identifiers (ORCID, VIAF, ISNI, DOI, ISBN, OpenAlex, YouTube IDs, …) and citation metadata (given/family name, journal, publisher as an entity, pages, volume, issue) — every imported statement carries an <syntaxhighlight lang="text" inline>imported from <authority></syntaxhighlight> reference. Each created item also gets a '''classic wiki page''' (Person:, Source: or Collective:) sitelinked to it, whose infobox renders the item's statements at view time — except '''book excerpts''', which are part of a book and get only an item. Where the authority has page prose (an abstract, a plot, lyrics, a lead intro), it is '''fetched and offered for review''' before it is written to the classic page (see [[Help:Contributing/import#Fetched page content]]).
 
{| class="wikitable" style="width:100%"
! Page !! Creates !! Input
|-
| [[Special:AddPerson]] || a person item + a <code>Person:</code> page || name, ORCID iD, VIAF ID, ISNI, or a Wikidata Q id
|-
| [[Special:AddSource]] || a source item + a <code>Source:</code> page — see the class list below || class first, then the class-specific input
|-
| [[Special:AddFictionalCharacter]] || a fictional-character item (no classic page) || a name (Wikidata)
|-
| [[Special:AddCollective]] || a non-person agent item (organization, company, band, agency, institution, team…) + a <code>Collective:</code> page || a name
|}
 
Every import flow offers a '''manual fallback''' — ''Create the item manually instead'' — on the search page and on the candidate-selection page. The manual form is '''prefilled with what you typed in the search boxes''' (a person name is split into given/family, e.g. "Marie Curie" → given ''Marie'', family ''Curie''), so you correct instead of retyping.
 
== People: lifecycle fields ==
 
The person review step pre-fills these from the authority when available:
 
* '''Given name''' / '''Family name''' — the item's '''label is the full name, auto-generated''' from these two fields (there is no separate label field). The <code>Person:</code> page title follows the same rule; a harvested record that has only a label keeps it.
* '''Description''' — a one-line summary of the person (below the name fields; pre-filled from the authority when available). Descriptions can be up to '''2000 characters''' on this instance.
* '''Date of birth''' / '''Date of death''' — day-precision date fields (<code>YYYY-MM-DD</code>).
* '''Place of birth''' / '''Place of death''' — entity search boxes: type a name to pick an existing place item (or type a Q-id directly). Create missing places first (see [[Help:Contributing/entities]]).
* '''This person is deceased''' — toggle, off by default; tick it to reveal the date/place of death fields.
* '''OpenAlex ID''' — the person's OpenAlex author identifier, fetched from the authority when available (otherwise type it, or leave empty).
* '''Portrait''' — optional: upload a local image file or paste an image URL (toggle), plus the '''portrait license''' (required when a portrait is provided). The file is saved as <code>File:&lt;name&gt;-portrait.&lt;ext&gt;</code> and linked from the item with an <code>image</code> statement.
 
== Fictional characters ==
 
[[Special:AddFictionalCharacter]] searches Wikidata by name (search → review candidates → create). The review step has '''Given name''' / '''Family name''' and '''Appears in''' (entity search, several works allowed). The '''label auto-generates''' as <syntaxhighlight lang="text" inline>{given name} {family name} (fictional character)</syntaxhighlight>; the '''description''' auto-generates as <syntaxhighlight lang="text" inline>fictional character in {works}</syntaxhighlight> when left blank. Characters get no classic page — just the item.
 
== Collectives: common classes ==
 
The collective class is inferred from the harvested Wikidata instance-of hints and chosen on the '''review step''' (the search-results selection step no longer shows a class field — pick the record first, then classify it when the harvested data is in front of you): private company, public company, non-profit organization, governmental agency, music band, educational institution, research institute, political party, trade union, religious organization, sports team — plus the generic organization / group of humans.
 
The collective review step also offers:
 
* '''Parent organization''' (optional) — an entity search box: the organization this collective is a subsidiary or subdivision of (type a name to pick an existing item, or type a Q-id).
* '''Logo''' (optional) — upload a local image file or paste an image URL (toggle), plus the '''logo license''' (required when a logo is provided). The file is saved as <code>File:&lt;name&gt;-logo.&lt;ext&gt;</code> and linked from the item with an <code>image</code> statement + a <code>license</code> statement.
 
== Special:AddSource is class-first ==
 
[[Special:AddSource]] opens on a '''class picker''' — choose the '''source type''' (the page title is <code>Special:AddSource</code>); the page then shows the adapted first step (search, or a URL entry for websites/web pages) and the adapted review fields for that class.
 
{| class="wikitable" style="width:100%"
! Class !! Kind !! First step
|-
| Book || parent || search: ISBN-13, title, or author
|-
| Scholarly article || parent || search: DOI, title, or author
|-
| Website || parent || '''enter the URL''' — metadata (title, description, intro) is fetched automatically
|-
| Song · Film · Video || parent || search: title or author (Wikidata)
|-
| YouTube channel || parent || search: YouTube name '''or URL''' (exact match for a URL)
|-
| YouTube video || child of YouTube channel || search: YouTube name '''or URL'''
|-
| Book excerpt || child of book || manual: parent book + pages
|-
| Web page || child of website || '''enter the URL''' — metadata fetched automatically
|}
 
* '''Website / web page URL entry''': type a public web address (<code>http://</code>/<code>https://</code>) and the title, description and intro are fetched automatically when the site allows it — you correct everything on the next pages. For '''websites''' the URL is collapsed to the site root (a website is the site, not a page) and there is '''no year''' field (a website is dynamic); for '''web pages''' the full URL is kept.
* '''Publisher is an entity''' (book, scholarly article): the publisher field is an entity search box — type a name to pick an existing publisher item (or type a Q-id). Create a missing publisher first (e.g. via [[Special:AddCollective]]). The item's publisher statement then points at that entity.
* '''Journal is an entity''' (scholarly article): the journal field is an entity search box, like the publisher — pick the journal item (create a missing one first, e.g. via [[Special:AddCollective]]).
* '''Access''' (book, scholarly article, song, film, book excerpt): how this source can be accessed — a toggle with four modes:
  * '''Access URL (non-direct)''' — a link to a page where the work can be accessed (a landing page, not the file itself).
  * '''Direct download link''' — a URL whose file is fetched and saved on this wiki automatically (as <code>File:&lt;title&gt;.&lt;ext&gt;</code>).
  * '''Local file''' — pick a file on your computer to upload.
  * '''N/A (no direct access)''' — the work is only reachable via archives or physical copies; no access statement is written.
  The download/file modes expand a '''license''' field (pick an existing license item — CC0, CC BY, GNU, etc., or type to search). Uploaded files are named after the item (your original filename is ignored) and you should not upload copyrighted content unless you have the right to distribute it publicly.
* '''The Access row on the Source: page''' — the infobox of every <code>Source:</code> page shows an '''Access''' row: a stored copy renders as the file name (click it to open '''[[Special:SourceFile]]''' — an embedded PDF preview when the file is a PDF, the licence, and a '''download button that requires accepting the licence conditions'''), a non-direct access URL renders as a clickable link, and a source without access shows '''N/A'''.
* '''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.
* '''Book excerpts''': after picking the parent book, fill the '''pages''' and optionally the '''volume''' and '''chapters'''. A blank '''description''' auto-generates as ''Pages a-b (Volume c) of {book}'' from the pages/volume fields and the book's title; blank '''year''' and '''author(s)''' fall back to the parent book's own values (''Leave blank if same as the parent book'').
* '''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''' — except a book excerpt that inherits its authors from the parent book: 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.
 
== Fetched page content ==
 
When the authority has page prose, it is fetched automatically and shown on a dedicated '''content review''' step after the record review — confirm, correct or clear each block; only what you keep is written to the page. Each block carries an attribution line (''from Wikipedia (CC BY-SA 4.0):'', ''from OpenAlex:'', …).
 
* '''Scholarly article''' — '''Abstract''' + '''Key words''' (OpenAlex, Crossref as fallback).
* '''Book''' — '''Summary''' (Wikipedia lead).
* '''Song''' — '''Overview''' (Wikipedia lead) + '''Lyrics''' (the Wikipedia article's lyrics section, when present).
* '''Film''' — '''Overview''' (Wikipedia lead) + '''Plot'''.
* '''Person''' — '''Biography''' (Wikipedia lead) on the <code>Person:</code> page.
* '''Website / web page''' — the intro/summary fetched from the site itself.
 
The classic pages render sections '''only when they have content''' (no empty placeholders; no ''See also''); websites and YouTube channels show a short intro without headings.
 
== Workflow ==
 
For classes with an authority: search → review the candidates (same-name disambiguation) → review the record → [review the fetched content, when present] → 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/&lt;class&gt;/manual</code>.
 
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 <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).
 
== 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)

Revision as of 14:37, 24 August 2026

Languages: English · français · Esperanto

  • Portrait — optional, behind the "I will upload a portrait image for this person" toggle: upload a local image file or paste an image URL. For a pasted URL, click Validate next to the field — a preview thumbnail, the pixel + file size and a best-effort auto-fill of the author / licence fields appear (Wikimedia image URLs are read from your browser, so they are not rate-limited). Fill the portrait license (required when a portrait is provided), and optionally Portrait author and Additional license information (free text — e.g. the attribution line for a CC BY image). The file is saved as File:<name>-portrait.<ext> and linked from the item with image, license, image author and additional license information statements.
Retrieved from "https://wikibase.ronzz.org/index.php?title=Help:Contributing/import&oldid=2355"