Skip to content

Konvertering og fremvisning av katalogen «Norske epitafier 1537-1700»

License

Notifications You must be signed in to change notification settings

uio-library/norske-epitafier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Norske epitafier 1537–1700

Dette repoet inneholder script for konvertering og presentasjon av katalogen «Norske epitafier 1537–1700». Selve kildedataene finnes på https://ub-media.uio.no/norske-epitafier-1537-1700/kildedata-kopi/ og vil etterhvert bli arkivert.

Katalogen omfatter 164 epitafier, der hvert epitafium er tilordnet en katalogkode bestående av stiftsnavn og et løpenummer, f.eks. «bergen-01». Katalogkoden er brukt som navn på en mappe som inneholder en metadata.xml-fil og én eller flere bildefiler:

kildedata-kopi/
		bergen-01/
				metadata.xml
				bilde 1.jpg
				bilde 2.jpg
				biografi.jpg
		...

XML-filene følger det lokale RELAX NG Compact-skjemaet definert i epitafium.rnc.

For import til Alma, konverteres filene ved hjelp av XSLT-filen dc_record.xsl til en Dublin Core applikasjonsprofil definert i Alma (http://alma.exlibrisgroup.com/dc/47BIBSYS_UBO). Denne er i liten grad kompatibel med andre skjemaer, og blander dessuten inn presentasjonselementer, så den er mest en pragmatisk løsning for å få dataene inn i Alma Digital på, men har gitt oss noen erfaringer med hvordan det er å jobbe med DC-applikasjonsprofiler i Alma, og har også åpnet for å kunne tilgjengeliggjøre katalogen i Oria.

Dataelementer

Under følger definisjon av feltene som brukes i katalogen, samt hvilke felter de er mappet til i DC application profile 1 i Alma og PNX (Oria). Feltene i Alma Digital er satt opp under Alma Configuration > Resources > Cataloging > Metadata Configuration > DC application profile 1.

Språkvalg for skjemaet: engelske felt/egenskaper og norske etiketter/labels. [utviklingsønske: etiketter på flere språk]

Felter som er i bruk for denne samlingen (pr 5.10.2020):

Tittel

URI

dc:title

Beskrivelse

Generert standardtekst på formen «Norske epitafier 1537–1700: {Epitafium over} ({Opprinnelig plassering})»

PNX

Display/title og Search/title

Katalogkode

URI

:catalogCode

Underegenskap av

dc:identifier

Beskrivelse

Alma-kode

local2

PNX

Search/addsrcrecordid?

Epitafium over (skjult fordi feltet inngår i tittel)

URI

:epitaphOn

Beskrivelse

Person(er) som epitafiet er til minne over. Eksempel: «Christen Jensen (Sorenskriver) og hustru Gye Lauridtzdatter, med barn»

Alma-kode

local1

PNX

- (søkbar via tittel)

Opprinnelig plassering

URI

:originalLocation

Underegenskap av

dc:spatial

Beskrivelse

Kirke epitafiet opprinnelig var plassert i.

Alma-kode

local4

PNX

Evt. Display/description med fortekst?

Plassering

URI

:location

Underegenskap av

dc:spatial

Beskrivelse

Nåværende plassering, typisk navn på et museum eller en kirke

Alma-kode

local5

PNX

Search/general. Evt. Display/description med fortekst?

Dato

URI

dc:date

Beskrivelse

Datering (omtrentlig eller eksakt) for når epitafiet ble fremstilt. Omtrentlige verdier kan f.eks. ha formen «1590-tallet» og «ca. 1630».

PNX

Display/creationdate og Search/creationdate

Stift (skjult fordi det fremkommer av katalognummer)

URI

:diocese

Beskrivelse

Historisk stift, slik de så ut rundt ca. 1700. Fire mulige verdier: «Bergen», «Oslo/Christiania», «Stavanger» eller «Trondhjem».

Alma-kode

local3

PNX

Evt. Display/description med fortekst?

Utformet av

URI

:artist

Underegenskap av

dc:creator

Beskrivelse

Person(er) som har fremstilt epitafiet. Ofte ukjent. Feltet kan ha komplekse verdier som «X har stått for utskjæringene, Y har malt bildet.» og «Antagelig utformet av X.»

Alma-kode

local6

PNX

Display/creator og Search/creator

Innskrifter

URI

:inscriptions

Beskrivelse

Feltet inneholder alle innskrifter, samt overskrifter. Er html-formatert med avsnitt pga. manglende formateringsmuligheter i visning.

Alma-kode

local7

PNX

Search/general. Evt. Display/description med fortekst?

Merknader

URI

:notes

Beskrivelse

(Fylles inn)

Alma-kode

local8

PNX

Search/general. Evt. Display/description med fortekst?

Beskrivelse

URI

dc:description

Beskrivelse

Fysisk beskrivelse av epitafiet. Eks: …​ Forfatteren av beskrivelsen er angitt med initialer på slutten av teksten.

PNX

Search/general. Evt. Display/description med fortekst?

Biografi

URI

:biography

Beskrivelse

Lengre biografisk tekst om personen/-ene epitafiet er til minne over. Forfatteren av biografien er angitt med initialer på slutten av teksten.

Alma-kode

local9

PNX

-

Referanser

URI

dcterms:bibliographicCitation

Beskrivelse

Referanser til omtale av epitafiet.

PNX

Evt. Display/description med fortekst?

Kreditering

URI

dc:rights

Beskrivelse

Informasjon om kreditering for gjenbruk av tekst og bilder.

PNX

Display/rights

Katalog (skjult)

URI

dcterms:isPartOf

Beskrivelse

Katalogens navn: «Norske epitafier 1537–1700». Skjult i fremviser, ment for visning i trefflister i Oria.

PNX

Display/ispartof

Kilde

URI

dcterms:source

Beskrivelse

Standardtekst som går igjen på alle epitafiene.

PNX

Display/source?

Identifikator (skjult)

URI

dc:identifier

Beskrivelse

Per i dag flere funksjoner: Intern Alma-ID (MMS-ID), filnavn ved ingest (veldig rar løsning).

PNX

Konverteringsprosessen

Oppsett

Hent inn avhengigheter med poetry:

cd conversion
poetry install

Opprett en konfigurasjonsfil:

cp config.yml.dist config.yml

og legg nøkler for Alma og S3 her. Her legges også stien til kildemappen.

1. Konvertering og import til Alma Digital

For å konvertere poster fra lokalt XML-format til Dublin Core og importere til Alma Digital:

poetry run python -m scripts.push_to_alma

2. Eksport av ID-er fra Alma Digital

Når postene har blitt importert i Alma, kan en hente ned ID-ene som har blitt generert for postene:

poetry run python -m scripts.fetch_ids

Disse lagres i fila collection.json, og vi trenger den for å kunne lenke til postene fra kart og listevisning.

3. Generere kart og listevisning

For å trekke ut koordinater og generere GeoJSON for kartlaget:

poetry run python -m scripts.make_map_data

Dette havner i fila kart_data.json.

4. Generere bildefliser og miniatyrbilder for fremviseren

Inntil et par problemer med Alma Digital har blitt fikset, lager vi fliser og miniatyrbilder selv med vips:

poetry run python -m scripts.make_tiles
poetry run python -m scripts.make_thumbs

Disse havner i mappa "tiles".

5. Bygge fremviser

cd ../popcorn-viewer
npm run build

6. Deploy

Nå skal dist-mappa være full av filer, som kan overføres til ønsket sted:

rsync -rtWz dist/ ub-media:/www/htdocs/norske-epitafier-1537-1700/

Oppdatering av samlingen i Alma

Ta først en sikkerhetskopi av kildedataene:

rsync -rtWz --progress ~/Dropbox/katalog\ -\ arbeidsmappe/epitafier/ ub-media:/www/htdocs/norske-epitafier-1537-1700/kildedata-kopi/

Det er ikke mulig å sette opp overskriving av filer når en bruker [Alma Ingest API-et](https://developers.exlibrisgroup.com/alma/integrations/digital/almadigital/ingest/). Oppdatering av samlingen innebærer derfor at samlingen blir slettet og gjenopprettet, noe som tar > 30 minutter. Kan utføres i en éngangsoperasjon med dette scriptet, som også genererer bildefliser og kartdata:

./update_collection.sh

Fulgt av opplasting til ønsket destinasjon:

rsync -rtWz --progress dist/ ub-media:/www/htdocs/norske-epitafier-1537-1700/