TheaterEncyclopedie:Eenduidig gebruik Infobox sjablonen

> Terug naar TheaterEncyclopedie:Sjablonen

Deze pagina inventariseert het gebruik van Infobox sjablonen en beschrijft het gewenste gebruik.

Infobox sjablonen

Infobox sjablonen worden gebruikt om een eenduidige vormgeving te implementeren. Ze plaatsen een afbeelding en een tabel met gestructureerde gegevens op een wiki-pagina. Tevens zorgen deze sjablonen/tabellen voor het toewijzen van de Semantische gegevens.

Lijst met "nieuwe" Infobox sjablonen

Sjabloon:Persoon	(gebruikt op 137.476 pagina's)
Sjabloon:Productie	(gebruikt op 65.417 pagina's)
Sjabloon:Producent	(gebruikt op 8.957 pagina's)
Sjabloon:Locatie	(gebruikt op 810 pagina's)

Hiervoor gebruikte sub-sjablonen:

Sjabloon:TEbox/DBNL
Sjabloon:TEbox/IBDB
Sjabloon:TEbox/IMDB
Sjabloon:TEbox/RKD
Sjabloon:TEbox/VIAF
Sjabloon:TEbox/datum
Sjabloon:TEbox/tekstrij
Sjabloon:TEbox/rij
Sjabloon:TEbox/website

Lijst met "oude" Infobox sjablonen

Sjabloon:Infobox persoon	(gebruikt op 9.287 pagina's)
Sjabloon:Infobox productie	(gebruikt op 8.959 pagina's)
Sjabloon:Infobox producent	(gebruikt op 116 pagina's) - lege sjabloon (alleen "vervallen"-melding)
Sjabloon:Infobox theater‏‎	(gebruikt op 16 pagina's)
Sjabloon:Infobox artiest	‏‎(gebruikt op 2 pagina's)
Sjabloon:Infobox auteur
Sjabloon:Infobox acteur
Sjabloon:Infobox collectie

Subsjablonen:

Sjabloon:Infobox generiek 2	‏‎ (gebruikt op 18.265 pagina's)
Sjabloon:Infobox rij‏‎	(gebruikt op 18.265 pagina's)
Sjabloon:Infobox/row	(gebruikt op één pagina)
Sjabloon:Fotogewenst/infobox	‏‎(gebruikt op 2 pagina's)

Aanpassingen voor nieuwe vormgeving (2018)

Bij de ontwikkeling van de de nieuwe vormgeving (2017/2018) zijn de "nieuwe" infobox sjablonen aangepast. Om de implementatie van de nieuwe vormgeving te completeren moeten ook de "oude" infobox sjablonen worden aangepast.

In principe zijn daar drie manieren voor:

Alle "oude" sjablonen vervangen door "nieuwe"
De "oude" sjablonen aanpassen t.b.v. de nieuwe vormgeving

Het aanpassen is het meest bewerkelijk en het betreft werk dat later weer "weggegooid" wordt.

Als tussenoplossing zou gekozen kunnen worden voor:

De "oude" sjablonen vertalen naar de "nieuwe" infobox sjablonen (en later vervangen, zoals bij 1)

Dit laatste is het efficiënts en kost het minste werk dat later alsnog weggegooid zal worden.

Voor het Sjabloon:Infobox_persoon is hiervoor een testcase gemaakt en zijn de resultaten kort geëvalueerd. Zie TheaterEncyclopedie:Eenduidig gebruik Infobox sjablonen/Testcase vertalen Sjabloon:Infobox_persoon.

Gevolgen divers gebruik Sjabloon Infobox persoon

Er ontstaan enkele nieuwe (c.q. andere) problemen a.g.v. van de vertaling, omdat het gebruik van de sjabloon Infobox_persoon niet 100% consistent is.

Voorbeeld van divers gebruik:

Jillis_Nooseman (originele link op Test-TE vervallen) (meervoudig met separator “;” (juist), met prefix “:categorie|” (problematisch))
- Huidig - Weergave “OK”; Semantische annotatie: geen!
Dominique Deutz (originele link op Test-TE vervallen) (enkelvoudig met categorie prefix) - geen annotatie Beroep - categorietoewijzing correct
- Huidig - Weergave “OK”; Foutmelding in categorie-toewijzing…; Semantische annotatie: GEEN
Hans_Croiset (originele link op Test-TE vervallen) (meervoudige invoer zonder categorie, met separator “,”) - annotatie beroep: geen - categorietoewijzing: correct.
- Huidig - Weergave “OK”; Foutmelding in categorie-toewijzing, annotatie correct (!!).

Deze fouten zullen op een later moment moeten worden opgelost; zie hiervoor ook Inventarisatie problemen Infobox-sjablonen (2019).

Op welke pagina's wordt een sjabloon gebruikt?

Om inzicht te krijgen op welke pagina's de sjabloon Infobox persoon, ga je naar deze sjabloon en klik vervolgens op:

Op Test-TE van Wikiwerkers en test.theaterencyclopedie: Kies "Koppelingen naar deze pagina" in het dropdown-menu rechtsboven
Op www.theaterencyclopedie: Kies "Koppeling naar deze pagina" uit het linker zij-menu

Je komt op een Speciale pagina.

Vervanging van Infobox sjablonen door middel van "vertaling"

In 2018 is besloten -ondanks de problemen met de correcte weergave en semantische annotatie- om de infobox sjablonen te vervangen. Dit is geïmplementeerd door de infobox sjablonen te laten verwijzen naar de nieuwe vervangende sjablonen. Op deze manier zijn de pagina's met oude infobox sjablonen nog te vinden (en te corrigeren).

Opschoning Infobox-sjablonen (2019)

In 2019 is gestart met het verhelpen van de problemen die veroorzaakt zijn door de genoemde Info-box sjablonen; zie actiepuntenoverzicht.

De eerste stap is het inventariseren van problemen; zie hiervoor de sub-pagina Inventarisatie problemen Infobox-sjablonen

Toolbox

Er is een serie aan hulpmiddelen, methodieken en te treffen maatregelen, die ervoor kan zorgen dat de geïnventariseerde problemen en fouten worden opgelost. Op de pagina Toolbox staat een overzicht.

Sommige hulpmiddelen gebruiken een MediaWiki-extensie, zoals Extension:Stringfunctions of een "Regex"-extensie. Beide implementeren functies om onderdelen (karakters) van de ingevoerde waarden te vervangen of te verwijderen. Regex-extensie heeft biedt uitgebreide filtermogelijkheden voor de vervangen/wijzigen onderdelen van een sjabloon-invoer.

De Extensie:Stringfunctions is beschikbaar en er is ook al een Regex-extensies geïmplementeerd op de TheaterEncyclopedie. Een aanpassing van de gebruikte "Regex"-extensie kan wenselijk zijn:

Extension:RegexFunctions vervangen door Extension:Regex Fun (what's in a name...) of Extension:RegexParserFunctions , omdat deze een betere status voor onderhoud hebben
Extension:ReplaceSet installeren (ter aanvulling op voorgaande), omdat deze uitgebreidere 'replace'-functionaliteit heeft (meervoudige vervangingen in eens).
Formulier-filters toepassen, zodat niet opnieuw "foute" waarden kunnen worden ingevoerd

De keuze voor de Regex-extensie moet met enige voorzichtigheid gebeuren, zodat bestaand gebruik van de functies blijft werken!

Plan van Aanpak

Op basis van de voorgaande inventarisatie is een (concept) Plan van Aanpak opgesteld om de problemen stap-voor-stap op te lossen.

Door de omvang en complexiteit van de problematiek lijkt het verstandig het probleem eerst te verkleinen en versimpelen, alvorens grote omzettingen uitgevoerd worden. Op deze manier hebben we meer controle over de materie en komen we waarschijnlijk sneller en efficiënter tot uiteindelijke ook betere resultaten.

Fase 0: Voorbereiding

Inventariseren
Oplossingen bedenken
Plan van Aanpak opstellen
Benodigde MediaWiki-extensies implementeren

Fase 1: Opruimen “broccoli”

Het opruimen van alle kleinschalige foutjes en problemen ("broccoli") in het (gebruik van) de ouden en nieuwe sjablonen:

Duidelijke, eenvoudige fouten in de nieuwe sjablonen verhelpen
Duidelijke, eenvoudige fouten in de vertaling van infobox naar nieuwe sjablonen aanpassen
Ontbrekende eigenschappen aanmaken, afspraken formattering, waarden etc. maken
Ontbrekende pagina’s aanmaken (m.n. plaatsen in Nederland, landen, jaartallen)
De oude Infobox-sjablonen die alleen nog sporadisch gebruikt zijn (Producent, Theater, Artiest), definitief vervangen door de nieuwe sjablonen
Nieuwe sjablonen “robuust” maken; bestand tegen veel voorkomen invoerfouten; toelichting en “invoerbeperking” formulieren verbeteren.

Zie verder: TheaterEncyclopedie:Eenduidig gebruik Infobox sjablonen/Fase 1

Fase 2: Tussenevaluatie

Door het opruimen van de "broccoli" komen de problemen bovendrijven, die nog niet zijn opgelost en mogelijk nog wel op grote schaal fouten veroorzaken. Tevens kan dan ook bezien worden of (en hoe) het opruimen van de oude sjablonen (die doorverwijzen naar de nieuwe) kan plaatsvinden en wat de resultaten daarvan zullen zijn:

Overgebleven problemen analyseren
Prioriteit van oplossing bepalen
Plan voor vervolg aanpak opstellen

Fase 3: Grootschalige vervangingen of correcties en borging

Op basis van de tussenevaluatie kunnen de overgebleven problemen worden aangepakt. Ook kunnen maatregelen worden genomen om ervoor te zorgen dat nieuwe (nieuw gevonden) problemen voorkomen dan wel alsnog opgelost worden:

Formulieren met toelichting verbeteren (tooltips maken)
Formulier-filters ontwikkelen
Vervangen van alle oude infobox sjablonen?
Vervangen van (foutief) ingevoerde waarden?
Controle en correctielijsten samenstellen?
Kwaliteitsborging instellen?

Besluitvorming

Besluitvorming over de aanpak, voortgang en evaluatie verloopt via het projectoverleg; zie hiervoor het overzicht van de actiepunten.

Onderhoud aan Infoboxen

In het kader van de de upgrade naar Bootstrap 4, is ook gekeken naar de mogelijkheid om de onderhoudbaarheid van de infoboxen te verbeteren.

Huidige situatie

Door de introductie van responsiviteit d.m.v. Bootstrap (3) en verdere ontwikkelingen, is in de infobox-sjablonen een substantiële en groeiende hoeveelheid opmaak opgenomen. Dat maakt de sjablonen onoverzichtelijker en daardoor wordt het moeilijker ze verder te ontwikkelen en te onderhouden.

Gewenste aanpassing

Optie 1 - "Geparametriseerde content" / cascaded

Herstructureren in de volgende onderdelen:

Content boven de infobox
Sjabloon:Infobox_header| content = ... (generiek voor alle infoboxen)
Sjabloon:Infobox_body | content = ... (idem)
Sjabloon:Infobox_footer | content = ... (idem)
Content onder de infobox

Optie 2 - : "Seriële opbouw"