[Feat]: PoC forhåndsvisning av begrep

[terjesyl]

🚀 Feature forespørsel

Ønsker en forhåndsvisning av begrep slik besøkende til sidene våre kan få opp forklaring av begrepet i løpende tekst.

Feature beskrivelse

Gjerne noe lignende NRK sine ordforklaringer, men basert på Begrepskatalogen.

NRKs sin komponent

Hvorfor trenger vi det?

Viser innholdet i begrepskatalogen i kontekst av siden hvor begrepet brukes, slik at brukeren slipper å gå ut av konteksten hen befinner seg i. F.eks. på docs-sidene til data.norge.no er det relevant å ha ordforklaringer, men vi vil unngå at brukeren må bytte kontekst og klikke seg til detaljsiden til begrepet.

Forslag/løsning [Valgfritt]

UI-komponent som har klikkbar tekst, som oftest vil være del av løpende tekst. Ved klikk skal en PopOver (eller tilsvarende) vises med:

• Anbefalt term ("prefLabel")
• Definisjon
• URL til detaljside på data.norge.no

Data fetches fra data.norge.no/concepts som JSON-LD. Bruker en custom context og ev. JSON-LD Framing for å omforme til mer frontend-vennlig JSON.

Spørsmål

• Skal håndtere de ulike versjonene av begrep? (se detaljert beskrivelse i kommentar under)
• Skal man vise forklaring for allmennheten og/eller forklaring for spesialister dersom disse fins? (Foreslå å utvide senere ved behov)

Definisjon av ferdig

• [ ] JSON-LD parses korrekt for de utvalgte versjonene av SKOS-AP-NO-Begrep
• [ ] Anbefalt term, definisjon og URL vises korrekt i UI-komponent
  • [ ] Nettleserspråk skal brukes, men har fallback dersom data ikke fins for valgt språk.
  • [ ] Fallback i rekkefølge: norsk bokmål, norsk nynorsk, engelsk (?)
• [ ] Tester er skrevet for JSON-LD-parsingen

[terjesyl]

Ulike versjoner av SKOS-AP-NO

Måter å beskrive anbefalt term (prefLabel) på:

SKOS-AP-NO-Begrep versjon 1.1.1 (utgått)

med skosxl:prefLabel:

<begrep> skosxl:prefLabel [
  a skosxl:Label ;
  skosxl:literalForm "Her er anbefalt term på bokmål"@nb ;
] .

Denne forekommer fortsatt i dataen vi høster.

SKOS-AP-NO-Begrep versjon 2.0.10 (gjeldende versjon)

med skos:prefLabel (direkteangivelse)

<begrep> a skos:Concept ;
   skos:prefLabel "mødrekvote"@nb, "mødrekvote"@nn ;
   .

Måter å beskrive definisjon på:

SKOS-AP-NO-Begrep versjon 1.1.1 (utgått)

med skosno:definisjon:

<begrep> skosno:definisjon [
  a skosno:Definisjon ; rdfs:label "Her er definisjonen på bokmål"@nb ;
].

SKOS-AP-NO-Begrep versjon 2.0.10 (gjeldende versjon)

med skos:definition (direkte angivelse):

<begrep> a skos:Concept ;
   skos:definition "Her er definisjon på bokmål"@nb ;
   .

med euvoc:xlDefinition (via definisjonsobjekt):

<begrep> a skos:Concept ;
   euvoc:xlDefinition [ a euvoc:XlNote ;
      rdf:value "Her er definisjon på bokmål"@nb ; ] .

Spørsmål

• Skal v1 støttes?
• Hva har presedens om både direkte angivelse og definisjonsobjekt er i bruk?

[terjesyl]

Jeg foreslår å i første omgang å

• ikke støtte definisjon for allmennheten og definisjon for spesialister
• støtte den versjonen registreringsløsningen eksporterer per nå som er v2 (og ev. endre senere)

[terjesyl]

Dette issuet implementerer løsning i fdk-frontend for brukerhistorien https://github.com/Informasjonsforvaltning/behov/issues/533#issuecomment-2342896060