This is an old revision of the document!
Table of Contents
```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:
- Neste ledige permanente MP-REL-ID tildeles.
- Utgivelsen lagres som lokal collector-release.
- Matrix-data legges inn i det lokale matrix-registeret.
- Utgivelsen blir tilgjengelig i diskografien.
- Pluginen forsøker å opprette den permanente wiki-siden.
- 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 ```
