Project:Wiki-opzet

Opzet van deze wiki

Voor alles wat met de organisatie van de thema-projecten te maken heeft gebruiken we de naamruimte Project. Deze pagina's hebben namen van de vorm Project:Pagename De hoofdnaamruimte gebruiken we voor de resultaten van deze projecten: het onderwijsmateriaal, voor leerlingen en docenten.

Er zijn enkele speciale uitbreidingen beschikbaar voor het maken van het onderwijsmateriaal, zoals Quiz en SyntaxHighlight.

Hoofdnaamruimte	Projectnaamruimte
Pagename	Project:Pagename
Resultaat	Proces, organisatie
Lesmateriaal	Discussies, motivatie
Concepten

Platte structuur

• een voorbeeld van een platte structuur is een opsomming;
• de encyclopedische pagina's van Wikipedia gebruiken een platte structuur
• voor de concepten (en de contexten) gebruiken we een platte structuur
• binnen deze platte structuur moeten namen uniek zijn

Hiërarchische structuur

Binnen een pagina gebruiken we meestal een hiërarchische structuur, met secties, subsecties, enzovoorts. Deze wordt weerspiegeld in de inhoudsopgave in de kop.

== Sectie 1 ==
=== subsectie 1.1 ===
=== subsectie 1.2 ===
== Sectie 2 ==
== Sectie 3 ==

Een voordeel van de hiërarchische organisatie is dat je alleen binnen eenzelfde niveau unieke namen hoeft te kiezen.

Je kunt dit vergelijken met de hiërarchische organisatie van een filesysteem, met directories (mappen) en bestanden.

Als een pagina te groot wordt, dan kun je subpagina's gebruiken om deze hiërarchische structuur vorm te geven.

• een link naar een subpagina van de huidige pagina heeft de vorm: [[/Pagename]].
• als je de "/" vergeet komt je pagina in de hoofdnaamruimte terecht - met een grote kans op een naamconflict.
  • zo'n vergissing kun je repareren door een pagina te hernoemen.
• een link naar een subpagina vanaf een andere plek bevat het hele (absolute) pad, bijvoorbeeld: [[Zandbak/Sub-zandbak2]]
• als je de "/" niet in de lopende tekst wilt zien, dan kun je de tekst daarvoor aanpassen, bijvoorbeeld [[/Pagename|paginamaam]]

Thema-projecten

Formulieren/sjablonen

Sjablonen voor de verschillende resultaten en formulieren:

• /Docentenhandleiding

Maak van een sjabloon een kopie voor je eigen thema-project.

Resultaten: onderwijsmateriaal

We hebben te maken met drie soorten resultaten:

• lesmateriaal (voor leerlingen)
• docenthandleidingen
• achtergrondmateriaal voor docenten en leerlingen

lesmateriaal

Het lesmateriaal bestaat bijvoorbeeld uit lesbrieven, opdrachten, toetsvragen, enz.

Uiteindelijk moet dit materiaal door docenten eenvoudig aangepast kunnen worden aan de eigen omstandigheden. Een omgeving als GitHub is dan mogelijk handiger dan een wiki. Voorlopig gebruiken we deze wiki voor een eerste versie van het materiaal.

Dit materiaal heeft een duidelijke organisatie, dit onder meer de volgorde en de dosering van het materiaal vastlegt.

Voor dit lesmateriaal gebruiken we per thema-module een pagina in de hoofdnaamruimte, met een boom van subpagina's met de lessen. Met behulp van navigatie-zijbalken kunnen we de structuur van het materiaal duidelijk maken.

Zie voor een voorbeeld: XXXX

docenthandleidingen

De docenthandleidingen kunnen we waarschijnlijk het beste onderdeel laten zijn van deze zelfde organisatie.

achtergrondmateriaal

Het achtergrondmateriaal bevat onder meer een beschrijving van de verschillende concepten, ongeveer als in Wikipedia. Hierbij kunnen we bijvoorbeeld de volgende structuur gebruiken:

• per concept e.d. een artikel (pagina) in de hoofdnaamruimte
• van eenvoudig en globaal naar gedetailleerd en wetenschappelijk, met verwijzingen.
  • dit is ongeveer de structuur van een krantenartikel: voor de meeste lezers geeft het eerste deel voldoende informatie. Degenen die meer willen weten lezen dan verder.

Speciale uitbreidingen

Deze wiki heeft een aantal speciale uitbreidingen:

• Quiz, voor het maken van allerlei soorten multiple-choicevragen.
  • Engelstalige handleiding (Wikiversity): https://en.wikiversity.org/wiki/Help:Quiz
  • Nederlandstaleige handleiding: https://nl.wikibooks.org/wiki/Handboek_MediaWiki/Extensies#Quiz
• Collection, voor het maken van "boeken" en PDF-documenten van een of meer wiki-pagina's
• Syntaxhighlight, voor het weergeven van programmafragmenten
  • Nederlandstalige handleiding: https://nl.wikibooks.org/wiki/Handboek_MediaWiki/Extensies#SyntaxHighlight
• Widgets - o.a. voor Google Docs

Collection: boeken

Voor het maken van een boek gebruik je het element in de linker zijbalk: "boek maken". Je kunt dan opgeven welke pagina's onderdeel van je boek zijn.

Deze uitbreiding gebruikt een externe dienst. Deze dienst is maar beperkt beschikbaar: het lukt niet altijd om het document te "renderen". Probeer het later nog eens.

Widgets: Google Docs

Met behulp van widgets kun je o.a. Google Docs embedden in een wiki-pagina. Je kunt dan de inhoud bekijken, en -als je voldoende rechten hebt- zelfs aanpassen.

• voor voorbeelden, zie https://infvo.nl/inf2019/index.php/Zandbak#Google_Docs
• je gebruikt in het widget de sharing-link van het Google document.