User Tools

Site Tools


wiki:discogs_plugin

This is an old revision of the document!


```text

Motorpsycho Discography-plugin

Motorpsycho Discography-pluginen brukes til å bygge og vedlikeholde et detaljert oppslagsverk over Motorpsychos fysiske utgivelser, pressinger og collector-varianter.

Pluginen bruker Discogs som grunnkilde, men Motorpsycho-wikien har sitt eget lokale register over utgivelser og collector-data.

En utgivelse trenger derfor ikke finnes på Discogs for å kunne registreres i wikien.

Discogs-data og lokale samlerdata lagres separat. Oppdateringer fra Discogs skal aldri overskrive egne registreringer av matrix, SID-koder, cover, labels eller andre collector-varianter.

Grunnleggende bruk

En Discogs-release kan vises på en wiki-side med:

{{mprelease>123456}}

Der 123456 er Discogs Release ID.

Den eldre syntaksen fungerer fortsatt:

{{discogs>123456}}

Begge fungerer foreløpig, men mprelease anbefales på nye sider.

En lokal utgivelse kan også vises direkte med sin permanente MP-REL-ID:

{{mprelease>MP-REL-000312}}

Dette fungerer også dersom utgivelsen ikke finnes på Discogs.

Discografi

Hele den registrerte diskografien kan vises med:

{{mpdiscography}}

Det er også mulig å filtrere eller gruppere resultatene.

Eksempel – vis utgivelser knyttet til én Discogs-master:

{{mpdiscography>master=763349}}

Grupper diskografien etter master:

{{mpdiscography>group=master}}

Filtrer etter for eksempel år og format:

{{mpdiscography>year=1993;format=Vinyl}}

Hva hentes fra Discogs?

Pluginen kan blant annet hente og vise:

  • Artist
  • Tittel
  • År og utgivelsesdato
  • Land
  • Plateselskap
  • Katalognummer
  • Format
  • Sjanger og stil
  • Cover
  • Tracklist
  • Barcode
  • Matrix / Runout
  • Mastering SID
  • Mould SID
  • Andre identifikatorer

Discogs-data lagres i lokal cache slik at Discogs ikke kontaktes ved hver sidevisning.

Discogs-cachen kan oppdateres eller bygges opp på nytt uten at lokale collector-data slettes.

Lokal release-ID – MP-REL

Alle utgivelser i collector-arkivet får en permanent lokal ID:

MP-REL-xxxxxx

Eksempel:

MP-REL-000312

MP-REL er Motorpsycho-wikiens egen identitet for den konkrete utgaven.

Discogs Release ID og MP-REL er derfor to forskjellige ting.

Eksempel:

Lokal ID:    MP-REL-000312
Discogs ID:  510010

MP-REL endres ikke dersom Discogs-data senere blir oppdatert.

En lokal utgivelse kan også eksistere uten Discogs-ID:

Lokal ID:    MP-REL-000641
Discogs ID:  Ikke registrert

Hvis den samme utgaven senere blir registrert på Discogs, kan Discogs-ID-en kobles til eksisterende MP-REL.

MP-REL beholdes uendret.

Lokale utgivelser

Fra versjon 0.7 kan utgivelser registreres selv om de ikke finnes på Discogs.

Dette kan være nyttig for blant annet:

  • Promo-utgivelser
  • Testpressinger
  • Feilpressinger
  • Sjeldne lokale pressinger
  • Utgaver som ennå ikke er registrert på Discogs
  • Dokumenterte varianter der Discogs mangler korrekt release

Lokale utgivelser kan blant annet inneholde:

  • Artist
  • Tittel
  • År
  • Land
  • Format
  • Label
  • Katalognummer
  • Valgfri Discogs Release ID
  • Matrix / Runout
  • Mastering SID
  • Mould SID
  • Covernotater
  • Labelnotater
  • Kilde
  • Collector-notater

Registrer ny utgivelse

Innloggede brukere kan sende inn forslag til nye utgivelser direkte fra wikien.

En registreringsside kan for eksempel opprettes som:

motorpsycho:registrer

med følgende innhold:

====== Registrer ny utgivelse ======
{{mpcontribute}}

Brukeren må være innlogget for å sende inn en utgivelse.

Vanlige brukere får ikke opprette en permanent MP-REL direkte.

Innsendingen får først en midlertidig ID:

MP-PENDING-xxxxxx

Eksempel:

MP-PENDING-000001

Utgivelsen må deretter godkjennes av en editor eller administrator.

En pending-utgivelse bruker ikke opp et MP-REL-nummer.

Godkjenning av innsendte utgivelser

En egen side kan brukes til å behandle innsendte utgivelser.

Eksempel:

motorpsycho:review

med:

====== Innmeldte utgivelser ======
{{mpreview}}

Denne siden bør beskyttes med DokuWiki ACL slik at bare editorer og administratorer har tilgang.

Standardgruppene som kan behandle innsendte utgivelser er:

editor
admin

Ved godkjenning skjer følgende:

  1. Neste ledige permanente MP-REL-ID tildeles.
  2. Utgivelsen lagres som lokal collector-release.
  3. Matrix-data legges inn i det lokale matrix-registeret.
  4. Utgivelsen blir tilgjengelig i diskografien.
  5. Pluginen forsøker å opprette den permanente wiki-siden.
  6. Eksisterende wiki-sider overskrives aldri.

Eksempel:

MP-PENDING-000001
      ↓
MP-REL-000641

En innsendt utgivelse kan også avvises.

Opprette lokale utgivelser som administrator

Administrator kan fortsatt opprette lokale utgivelser direkte uten å bruke pending-systemet.

Dette gjøres fra:

Admin → Motorpsycho Discography → Lokale utgivelser og innsendingskø

En utgivelse som opprettes direkte av administrator kan få permanent MP-REL med én gang.

Dette er nyttig ved vanlig registrering av egne plater og andre utgivelser der godkjenningsflyt ikke er nødvendig.

Permanente wiki-sider

En godkjent utgivelse kan få sin egen permanente wiki-side.

Standard namespace er:

motorpsycho:releases:

Eksempel:

motorpsycho:releases:mp-rel-000312

En generert side bruker den permanente lokale ID-en:

{{mprelease>MP-REL-000312}}

Wiki-siden kan deretter utvides manuelt med tekst, bilder, dokumentasjon og annen informasjon.

Pluginen skal aldri automatisk overskrive en eksisterende wiki-side.

Collector-varianter

Pluginen kan registrere variasjoner som ikke nødvendigvis er egne releases på Discogs.

Dette kan for eksempel være forskjeller i:

  • Matrix / Runout
  • Cover
  • Baksidecover
  • Label
  • Inner sleeve
  • Inserts
  • Stickers
  • Vinylfarge
  • CD-print
  • Mastering SID
  • Mould SID
  • Pressing plant
  • Andre produksjonsdetaljer

En collector-variant er en kombinasjon av observerte egenskaper.

Eksempel:

V1 – Matrix M1 + Mould SID IFPI 5223
V2 – Matrix M1 + Mould SID IFPI 5231

V1 og V2 kan dermed ha nøyaktig samme matrix, men likevel være forskjellige collector-varianter.

Dette er et viktig prinsipp:

En ny matrix er ikke nødvendig for at noe skal registreres som en egen collector-variant.

Matrix-sett

Matrix-data registreres separat slik at samme matrix kan brukes av flere collector-varianter.

Eksempel:

M1
Format: CD
Type: stamped
Matrix: BOD INDIGO 3907-2

En collector-variant kan deretter referere til M1.

Den eksakte matrix-transkripsjonen beholdes slik den er registrert.

Pluginen lager samtidig en normalisert søkeverdi.

Normaliseringen brukes bare til søk og sammenligning. Den opprinnelige matrix-teksten endres ikke.

Matrix-søk

Det offentlige matrix-søket kan legges på en wiki-side med:

{{mpmatrixsearch}}

For eksempel:

====== Motorpsycho Matrix Search ======
{{mpmatrixsearch}}

Søket har to hovedmoduser:

  • Inneholder
  • Eksakt matrix

Inneholder er nyttig dersom bare deler av matrixen er lesbar.

Eksempel:

3907-2

Eksakt matrix brukes når hele matrix-transkripsjonen er kjent.

Eksempel:

BOD INDIGO 3907-2

Vanlige forskjeller i mellomrom og bindestreker normaliseres ved søk.

For eksempel kan:

ABC – 123

og:

ABC-123

betraktes som samme normaliserte matrix.

Den originale transkripsjonen vises alltid uendret.

Matrix og flere utgivelser

Samme matrix kan finnes på flere registrerte utgivelser.

Matrix-søket grupperer identiske normaliserte matrixverdier og viser hvilke MP-REL-utgivelser de er registrert på.

Lokale collector-data prioriteres dersom samme matrix også finnes i Discogs-data.

Tilknyttede collector-varianter vises sammen med matrixen.

Dette gjør det mulig å dokumentere tilfeller der samme matrix finnes på flere varianter med forskjeller i for eksempel:

  • Mould SID
  • Mastering SID
  • Cover
  • Label
  • Andre komponenter

Administrasjon

Collector-data administreres fra:

Admin → Motorpsycho Discography

En eksisterende utgivelse kan åpnes ved hjelp av:

  • Discogs Release ID
  • Discogs release-URL
  • Lokal MP-REL-xxxxxx-ID

Administrasjonen inneholder blant annet funksjoner for:

  • Discogs-synkronisering
  • Matrix-søkeindeks
  • Collector-data
  • Wiki-sidegenerator
  • Lokale utgivelser
  • Innsendingskø

Discogs-data og lokale collector-data lagres separat.

Det betyr at en oppdatering fra Discogs ikke skal overskrive egne registreringer av matrix, cover, labels, SID-koder eller andre collector-varianter.

Verifisering og kilder

Lokale collector-data kan registreres med kilde og status.

Eksempler på kilder:

  • Fysisk eksemplar
  • Discogs
  • Foto
  • Offisiell informasjon
  • Plateselskap
  • Bok eller magasin
  • Annen dokumentert kilde

Aktuelle statuser kan være:

  • Verified
  • Unverified
  • Uncertain

Målet er at informasjon på samlernivå så langt som mulig skal kunne dokumenteres og etterprøves.

Prinsippet bak pluginen

Kort fortalt:

Discogs er grunnkilden – Motorpsycho-wikien er collector-fasiten.

Discogs brukes til å hente og vedlikeholde grunnleggende releasedata.

MP-REL brukes som permanent lokal identitet.

Collector-data brukes til å dokumentere fysiske forskjeller og observerte varianter.

Lokale utgivelser gjør det mulig å registrere materiale som ikke finnes på Discogs.

Brukerinnsending gjør det mulig for andre samlere å bidra, samtidig som nye permanente utgivelser må godkjennes før de blir en del av arkivet.

En Discogs-ID kan endres, mangle eller kobles til senere.

En MP-REL skal være permanent.

Plugin-versjon

Denne dokumentasjonen gjelder:

Motorpsycho Collector Discography v0.7.0 ```

wiki/discogs_plugin.1786559099.txt.gz · Last modified: (external edit)