NORA Online:Release notes WikiXL 2.0

In 2019 wordt het technische platform van deze wiki geüpgrade. Onderstaand de technische wijzigingen.

Generiek

• <code> gebruiken om 'code' te laten zien met vaste-letterafstand. In tegenstelling tot <pre>, worden Mediawiki-opmaakcodes hiermee nog steeds verwerkt. Dus: <code>dit is code met ''cursieve tekst'' </code> wordt dit is code met cursieve tekst . In tegenstelling tot <pre>, kan de code in lopende tekst worden getoond ('pre' wordt altijd een aparte alinea).
• meer uitnodiging tot interactie: je gebruikerspagina, overlegpagina, en pagina's die je hebt bewerkt komen standaard op je volglijst te staan. Standaard worden gebruikers gemaild over hun volglijst, dit is uit te zetten.
• SmartBooks: de dialoog om een document op te slaan is wat gestroomlijnd, waardoor geen pop-up meer geopend wordt.
• Bij het hernoemen van een pagina wordt standaard een doorverwijzing aangemaakt.

Semantische functies

• Het is in (bv) sjablonen eenvoudiger geworden om:
  • subobjecten aan te maken, waarbij de ID's niet expliciet opgegeven hoeven worden.
  • Waarden leeg te laten in subobjecten (dit gaf voorheen foutmeldingen met onjuiste omschrijving)
  • met {{#set:}} een eigenschap instellen met meerdere waarden (bv komma-gescheiden)
• (optioneel) toestaan van interne hyperlinks in tekst-waarden
• meer datumnotaties in resultaten van bevragingen

Uiterlijk

• Het menuitem 'verversen' heet nu 'vernieuwen'.
• 'bewerken' staat nu direct naast kopjes ipv aan de rechter kantlijn
• Inlog en registratie heeft een andere styling en andere bewoording.
• Aantal bezoeken per pagina wordt niet meer bijgehouden. Dit was standaard zichtbaar onderaan de pagina.
• Een kleine aanpassing in de lettertypen van de standaard skin (iets groter en meer consistent)
• "Recente Wijzigingen" is overzichtelijker
• Veel aanpassingen aan de toegankelijkheid voor bv visueel beperkten, zoals een toegankelijker 'diff' om verschillen tussen pagina's te zien. Je kunt ook gemakkelijk linken naar wijzigingen met de pagina Special:Diff.
• Een paar kleinere wijzigingen voor meer responsive design (zoals tabbladen die op kleine schermen veranderen in een 'drop-down' menu)
• Speciaal:PaginareeksVerwijderen toont in de bevestiging niet meer welke pagina's verwijderd worden

Javascripts in MediaWiki (Common.js)

(Waarschijnlijk niet van toepassing bij NORA)

• "addPortletLink" is in 1.27 veranderd naar: "mw.util.addPortletLink", de oude aanroep zal dus niet meer werken!
• Het zelfde geld voor variabelen zoals wgCanonicalNamespace, wgArticlePath e.d. Deze variabelen dienen opgehaald worden d.m.v. mw.config.get('wgCanonicalNamespace')

Semantic Forms / PageForms

Bewerken met formulier

Voor formulieren die niet met SmartCore werken:

• Heeft standaard formulier moet vervangen worden naar {{#default_form:}}. Dit kun je doen naar Speciaal:TekstVervangen te gaan en de code \[\[Heeft standaard formulier::(.*)\]\] in het veld 'Oorspronkelijke tekst' te plaatsen, en vervolgens de code {{#default_form:$1}} in het veld 'Vervangende tekst' te plaatsen. Vink 'Reguliere expressies en wildcards gebruiken' ook aan. Mocht de \[\[Heeft standaard formulier::(.*)\]\] niets opleveren, probeer het dan met \[\[Has default form::(.*)\]\] Zoek voor de zekerheid ook op {{#default_form: en vervang dat door {{#default_form:

Query's in formulierdefinitie

• In formulierdefinities is in de field-parameter 'values=' soms een query gebruikt om een lijst met toegestane waarden op te stellen. Dat kon in eerdere versies van page forms alleen door die query te omsluiten met verwisselde nowiki-tags. Dat is in de nieuwe versie niet meer nodig, en werkt ook niet meer. Op het nieuwe platform zal bij dergelijke velden de eerste en de laatste waarde in de rij een fout opleveren. Oplossing is de nowiki-tags uit de formulierdefinitie te verwijderen; de query kan blijven staan.

De aanroep van een formulier via parameter formedit

Voorheen kon een 'formedit'-parameter worden gebruikt om in een link aan te geven dat een pagina met zijn default formulier moest worden geopend. Vanaf de nieuwe versie moet er altijd een form-naam bij staan. Dus via een interne link

• [[Special:FormEdit/Formuliernaam/Paginanaam]]

• https://<something>/index.php?title=paginaam&form=formuliernaam&action=formedit

Vervang comboboxen door tokens

Het nieuw beschikbare inputtype "tokens" is gebruiksvriendelijker dan de combobox. Dit geldt met name voor invoervelden waar het logisch is om meerdere waarden in te voeren. Vervang daarom "input type=combobox" door "input type=tokens". In SmartCore is 'tokens' nu één van de opties die bij een Eigenschap kunnen worden gekozen.

Vervangen van SemanticTitle-extensie door DISPLAYTITLE-extensie

Voorheen werd in NORA gebruik gemaakt van SemanticTitle, waarmee per naamruimte kon worden gedefinieerd welke weergegeven titel bij de pagina hoort.

Het toekennen van een DISPLAYTITLE aan een pagina

• Zorg dat $wgAllowDisplayTitle op 'true' staat (dit is de defaultwaarde).
• Om een displaytitle te zetten, gebruik

  {{DISPLAYTITLE:<tekst>}}

• Om een displaytitle te zetten op basis van een eigenschap Abc, zoals voorheen gedaan werd met de extensie SemanticTitle, gebruik

  {{DISPLAYTITLE:{{{Abc|}}} }}

• Om een displaytitle te zetten op een smartcore pagina (#element), zorg dat in de #element sjabloon een parameter 'Semantictitle' aanwezig is. SmartCore zet automatisch de displaytitle op de waarde van de eigenschap Semantictitle. Die eigenschap hoeft ook niet in de lijst met eigenschappen van het desbetreffende elementtype te zijn opgenomen.
• Om een andere waarde dan 'Semantictitle' als displaytitle te zetten: gebruik Sjabloon:SmartCoreEpilogue met een code als:

  {{DISPLAYTITLE:{{{Title|}}} }}

Het opvragen van een DISPLAYTITLE

• Om een semantische paginatitel op te vragen, gebruik

  {{#getdisplaytitle: <paginatitel>}}

  • Vervang dus {{#semantic-title:(.*)}} met {{#getdisplaytitle:$1}}.

Database update voor displaytitle

• Alle semantische eigenschappen moeten na deze acties weer opnieuwe gezet worden! Doe dat door het model opnieuw te importeren,of (beter) draai 'Gegevens bijwerken' vanaf de pagina Speciaal:SMWBeheer.
• om de DISPLAYTITLE actief te krijgen in Page Forms, moet in de local settings deze variabele gezet worden

$wgPageFormsUseDisplayTitle = true;

Customtitle

• vervang {{#customtitle:(.*)}} met {{DISPLAYTITLE:$1}}

SMW

• Het result format 'max' is nu gevoelig voor de limit-instelling, inclusief de (impliciete) default limit van 20 resultaten. Om zeker te zijn van de juiste max-waarde, sorteer het queryresultaat in aflopende volgorde. (Mutatis mutandis, hetzelfde voor format 'min')
• Datums (en tijden) kunnen nu op meerdere manieren worden getoond https://www.semantic-mediawiki.org/wiki/Help_talk:Type_Date
• Eigenschappen mogen GEEN punten in de naam hebben; dit wordt geïnterpreteerd als poging tot 'property chaining' in de #set

SmartCore

• Sjabloon:SmartCoreEpilogue maakt het mogelijk om generieke maatwerkcode uit te voeren na executie van de opmaaksjabloon voor elke smartcore wikipagina (=pagina met #element).
• Sjabloon:<Elementtype>Epilogue maakt het mogelijk om elementtypespecifieke maatwerkcode uit te voeren na executie van de opmaaksjabloon van het desbetreffende elementtype. Voorbeeld: Sjabloon:BusinessProcessEpilogue.
• Displaytitle wordt automatisch gezet op basis van de waarde van de 'Semantictitle' sjabloonparameter in #element, als die aanwezig is. Deze parameter hoeft niet bij de elementtypedefinitie opgenomen te worden. (Zie 'Semantictitle' hierboven)
• Elementeigenschap kan nu het type "Tokens" krijgen; elke gekozen waarde wordt dan een 'vakje'.
• Insluiten (embedden/includen) van pagina's/sjablonen (met {{:andere pagina}}) neemt ook de semantische eigenschappen over van die ingesloten pagina. Dit is een fix tov de vorige versie, waarbij eigenschappen niet meegenomen werden.

===SmartCore upgraden===l

Verschillende sjablonen van SmartCore worden vervangen door parserfuncties. Concreet betekent dit, dat een

{{InstellingX}}

wordt vervangen door

{{#InstellingX}}

. Bij NORA is de belangrijkste sjabloon, "Element", al vervangen door de parserfunctie

{{#Element:}}

.

Het vervangen gebeurt geautomatiseerd.

SmartConnectArchiMate

(Deze functionaliteit, voor importeren, weergeven en exporteren van ArchiMate uitwisselbestanden, wordt niet door NORA gebruikt)

GraphViz

• Wanneer meerdere graphs op 1 pagina worden geplaatst, moeten deze elk een unieke naam krijgen. Geldt ook voor het SRF format=graph.

Translation strings (systeemberichten)

• MediaWiki:Enotif body heeft nieuwe opmaak (MW 1.21)
• De verschillende mail en inlog-berichten hebben nieuwe strings.

Houdt in dat informatie vindbaar, interpreteerbaar en uitwisselbaar is.

Nederlandse Overheid Referentie Architectuur.