Module:Layout/doc

Dit is de documentatiepagina voor Module:Layout

Deze module is nog in ontwikkeling (versie 0.0) en wordt getest.

De Module:Layout is bedoeld om snel, consistent en uitgebreid een pagina op te maken.
Er is een op de module afgestemde handleiding over deze onderwijswiki beschikbaar.

De module wordt geïnitialiseerd met de configuratie in Module:Layout/Production/Configuration.

Controleer op scriptfouten of opmaak notificaties.

De module Layout werkt nauw samen met het sjabloon Opmaak. Directe benadering door gebruikers van deze module wordt dan ook ontraden en ook tegengehouden waar mogelijk. Voor het gebruik van de module verwijzen we daarom naar de sjabloonbeschrijving van het sjabloon Opmaak.

Subpagina's

Omgevingen

Module Migratie
Sandbox		Development		Stage		Production
Module A Module B	→ test	Module A Module B	→ test	Module A Module B	→ test	Module A Module B

Opbouw

MVC Pattern
Model	View	Controller
Model Content Configuration Language Style	View	Layout Interface Library
Test

Deze module is gebouwd om via een interface de aanroeper door te sturen naar specifieke functionaliteit behorende bij het type Opmaak gegroepeerd onder Module:Layout/Production/View. Onder Module:Layout/Production/Test zijn alle testfuncties gebundeld. De library Module:Layout/Production/Library heeft verzameld alle functies die door meerdere modules worden gebruikt en geen andere modules aanroepen. Alle instellingen zoals de berichten en de structuur van deze module zijn ondergebracht bij Module:Layout/Production/Configuration. Ook is er een ontwikkelomgeving ingericht onder Module:Layout/Sandbox. Samengevat:

Hoofdmodules onder Layout
Hoofdmodule	Activiteit	Omschrijving
Module:Layout	inrichten	module die juiste omgeving voor het systeem inricht.
Module:Layout/Production/View	weergeven	modules die nieuwe wikibooks-objecten weergeven.
Module:Layout/Production/Interface	communiceren	modules die de communicatie tussen de aanroepende wikipagina en de module Layout afhandelen.
Module:Layout/Production/Library	opbouwen	modules die bouwstenen vormen voor andere modules.
Module:Layout/Production/Content	creëren	modules die de speciale inhoud van bepaalde wikibooks-objecten creëren.
Module:Layout/Production/Model	verrijken	modules die de bestaande gegevens verrijken zodat ze geschikt zijn voor wikibooks-objecten.
Module:Layout/Production/Configuration	configureren	modules die de werking van andere modules configureren.
Module:Layout/Production/Language	vertalen	modules die in de taal van de gebruiker communiceren.
Module:Layout/Production/Style	stijlen	modules die in de stijl van de weergave instellen.
Module:Layout/Production/Test	testen	modules die testen.

Hooks

Objecten

Om functionaliteit toe te voegen of aan te passen haken we de nieuwe of aan te passen module in met exact de naam (in Engels) van het wikiobject dat we toevoegen. Dat dient in ieder geval te gebeuren onder de view (we moeten toch iets laten zien). We moeten ook berichten in de geldende taal wat de naam van het wikiobject is door deze toe te voegen door de een module te zetten met dezelfde naam onder de language modules. Afgestemde inhoud zullen we meestal creëren door wederom met exact dezelfde naam (in het Engels) te plaatsen onder de topmodule content. Daarna kunnen we bij een nieuwe module in het configuratiebestand Configuratie/Hook een haakje zetten (een extra element toevoegen aan de tabel HOOK.OBJECT) zodat het systeem onze nieuwe module opneemt. Ook passen we de bijbehorende test aan of maken een nieuwe. Hetzelfde doen we voor de documentatie. Het aangepast of nieuwe object is zoveel mogelijk afgezonderd van andere objecten om onderlinge impact bij fouten te voorkomen.

Wiki-objecten toevoegen of Wijzigen
Configuratie/Hook (Vereist)	View (Vereist)	Language (Vereist)	Content (Optioneel)	Test (Vereist)	Sjabloon (Vereist)
Haak een nieuwe module of de gewijzigde module in de tabel HOOK.OBJECT	Koppel een nieuwe module of de gewijzigde module onder de bovenste module genaamd Weergave Gebruik de WikiObjectNaam	Voeg berichten toe in de juiste talen onder de bovenste module Taal Gebruik de WikiObjectNaam	Beheers de inhoud van het WikiObject door een module toe te voegen onder de bovenste module Inhoud	Voeg tests voor de nieuwe functionaliteit toe.	Beschrijf het gebruik van de nieuwe functionaliteit.

Parameters

Op dezelfde manier als bij de objecten kan men ook nieuwe parameters aanmaken of aanpassen. Indien mogelijk is het advies dat niet toe doen omdat dit wel meer impact heeft dan objecten en een te lange lijst van mogelijke parameters het overzichtelijk gebruik zal afremmen. Probeer zoveel mogelijk de bestaande parameters te gebruiken of de unnamed parameters. Als men toch een parameter nodig heeft dan haakt men die in eveneens in de configuratie module Module:Layout/Production/Configuration/Hook onder HOOK.PARAMETER. Zorg dat hij ook op de juiste plek in de language module komt (Module:Layout/Production/Language/Nl) in de naam van de geïnstalleerde taal. Daarna kan men door een functie aan te maken of aan te passen in Module:Layout/Production/Interface/Frisk de inhoud van deze parameter checken en de foutmelding met eventuele parameters teruggeven als return waarde. Bij een fout zal het programma vanzelf verder uitvoering voorkomen en op grond van ingestelde support een foutmelding weergeven. Daarna kan men de inhoud converteren en/of aanvullen zodat het voor verder gebruik veilig en volledig is als inventaris (Module:Layout/Production/Model/Inventory). Het streven is dat de gegevens uit het model zonder verdere modificatie zijn te gebruiken bij de weergave (view). Test de parameter zeer grondig als bouwsteen ook voor andere objecten en voeg de juiste documentatie toe aan het sjabloon.

Wiki-objecten toevoegen of Wijzigen
Configuratie/Hook (Vereist)	Frisk (Vereist)	Language (Vereist)	Inventory (Optioneel)	Test (Vereist)	Sjabloon (Vereist)
Haak een nieuwe parameter of de gewijzigde parameter in de tabel HOOK.PARAMETER	Koppel een nieuwe functie of de gewijzigde functie onder de veiligheidsmodule voor het fouilleren Gebruik de WikiObjectNaam	Voeg berichten toe in de juiste talen onder de bovenste module Taal Gebruik de WikiObjectNaam	Beheers de inhoud van de parameter door een functie toe te voegen onder de modelmodule voor de inventaris	Voeg tests voor de nieuwe functionaliteit toe.	Beschrijf het gebruik van de nieuwe functionaliteit.

Aanroep

De interface van de module vindt men onderin de code en gebeurt via de aanroep {{#Invoke:Layout|main|...}} en dan kiest of de gebruiker of het systeem zelf op grond van pagina-eigenschappen welke type pagina het is.

Tests

^{In Module:Layout/Production/Test worden de tests gespecificeerd die zijn uitgevoerd.}

Zie ook

Voor meer informatie over LUA modules zie de de extensie Scribunto.