Project:Wiki-opzet

Uit Inf2019
Naar navigatie springen Naar zoeken springen

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.

Subpagina's

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]]

Zie voor een voorbeeld: Project:Netwerken, en natuurlijk de Zandbak van deze wiki.

Deze subpagina-structuur gebruiken we ook voor het lesmateriaal: zie verderop.

Verwijzingen

Naast de platte en de hiërarchische structuur gebruiken we in een wiki ook pagina-verwijzingen (links).

Via de "Verwijzingen naar deze pagina" vind je de pagina's die naar de huidige pagina verwijzen.

Navigatie

Deze verwijzingen kunnen we ook gebruiken om onze eigen navigatie te maken, bijvoorbeeld naar alle pagina's met concepten van het huidige thema. Hiervoor gebruik je meestal een navigatie-zijbalk rechts. Deze kun je aanmaken als een speciaal Sjabloon (template). Voorbeeld:

Een dergelijk sjabloon gebruik je ("roep je aan") op een andere pagina door de constructie: {{Sjabloon:sjabloon-naam}}, bijvoorbeeld: {{Zijbalk Netwerken}}

Een sjabloon kan eventueel ook parameters hebben. Voor een uitgebreidere beschrijving van Sjablonen, zie Project:Handleiding sjablonen.

Semantische verwijzingen

De normale wiki-links geven al enige structuur aan je pagina's, maar zo'n link geeft niet aan wat de aard (betekenis) van de verwijzing is. In een semantische verwijzing kun je deze betekenis wel aangeven. Dit is mogelijk dankzij de uitbreiding "Semantic Mediawiki". Enkele voorbeelden van semantische verwijzingen:

  • [[gebruikt-voorkennis::Netwerken/Web0]]
  • [[gebruikt-concept::IP-address]]

Dankzij deze semantische verwijzingen kun je bijvoorbeeld bij een concept automatisch (via een query) een lijst opnemen van alle contexten waarin dit concept gebruikt wordt. Je hoeft daar niet zelf naar te zoeken.

Categorieën

P.M.

Thema-projecten

Vaste onderdelen (SLO formulieren)

Voor enkele vaste onderdelen van het resultaat gebruiken we de structuur van de formulieren van SLO. De onderstaande pagina(s) kun je kopiëren naar je eigen thema-projectpagina:

Je maakt een kopie van deze pagina voor je eigen project met Kopieer/Plak (Copy/Paste):

  1. ga naar je eigen project-pagina (bijvoorbeeld: Project/Netwerken-thema).
  2. maak daar op de geschikte plaats een subpagina-link voor het betreffende onderdeel, bijvoorbeeld: [[/Docentenhandleiding]]. Vergeet de "/" aan het begin niet: dit geeft aan dat het een subpagina is. Bewaar de verandering.
  3. klik op deze link: je krijgt dan een lege pagina "in bewerking"
  4. ga in een andere tab van je browser naar de pagina die je wilt kopiëren (bijvoorbeeld: Project:Wiki-opzet/Docentenhandleiding).
  5. open dit origineel voor "Bewerken" (tab bovenin)
  6. Selecteer en kopieer de inhoud (Ctrl-A Ctrl-C of Cmd-A Cmd-C)
  7. ga naar de lege pagina (bestemming) en plak de gekopieerde tekst (Ctrl-V of Cmd-V)
  8. bewaar de aangemaakte pagina.

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:

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.

Overgenomen van "http:///inf2019/index.php?title=Project:Wiki-opzet&oldid=399"