(→Invullen van Resource Description-formulier)
|
(Toelichting voor hyperlinks op een navigatiepagina toegevoegd.)
|
||
(36 tussenliggende versies door 3 gebruikers niet weergegeven) | |||
Regel 1: | Regel 1: | ||
− | |||
De DeltaExpertise-site is een site waarvoor eenieder die geautoriseerd is tekst en beeld aan kan leveren. Om geautoriseerd te worden en vervolgens de site te kunnen wijzigen, kan gebruik worden gemaakt van het hangslot-icoontje rechtsboven in beeld. |
De DeltaExpertise-site is een site waarvoor eenieder die geautoriseerd is tekst en beeld aan kan leveren. Om geautoriseerd te worden en vervolgens de site te kunnen wijzigen, kan gebruik worden gemaakt van het hangslot-icoontje rechtsboven in beeld. |
||
− | Onderstaand vind je informatie met betrekking tot het aanvullen/wijzigen van de site, waaronder aanwijzingen om de leesbaarheid van teksten en de eenheid in stijl en opmaak te bevorderen. |
+ | Onderstaand vind je informatie met betrekking tot het aanvullen/wijzigen van de site, waaronder aanwijzingen om de leesbaarheid van teksten en de eenheid in stijl en opmaak te bevorderen.
|
+ | |||
+ | De informatie hieronder is aangevuld met informatie uit de EMM-cursus en verwerkt tot een overzichtelijke [[Manual EMM VN|gebruikershandleiding]]. |
||
+ | |||
+ |
Door middel van deze gebruikershandleiding kan iedereen die de EMM-cursus succesvol heeft afgerond zelfstandig kennis en expertise verwerken en opslaan op de DeltaExpertise-site. |
||
== Gebruikershandleidingen beheersomgeving == |
== Gebruikershandleidingen beheersomgeving == |
||
Regel 34: | Regel 37: | ||
*Vermijd bij voorkeur het woordje ‘men’. Vervang men door een meer specifieke beschrijving van het onderwerp. |
*Vermijd bij voorkeur het woordje ‘men’. Vervang men door een meer specifieke beschrijving van het onderwerp. |
||
*Vermijd [http://nl.wikipedia.org/wiki/Tangconstructie tangconstructies]. |
*Vermijd [http://nl.wikipedia.org/wiki/Tangconstructie tangconstructies]. |
||
− | *Hulpwerkwoorden als zullen en kunnen maken een zin moeilijker leesbaar. Als je ze weglaat, gaat de betekenis van de zin vaak niet verloren. |
+ | *Hulpwerkwoorden als zullen en kunnen maken een zin moeilijker leesbaar. Als je ze weglaat, gaat de betekenis van de zin vaak niet verloren. |
== Aantrekkelijkheid teksten == |
== Aantrekkelijkheid teksten == |
||
Regel 47: | Regel 50: | ||
Ten slotte nog een aantal aanwijzingen om tot een (bijna) foutloze tekst te komen: |
Ten slotte nog een aantal aanwijzingen om tot een (bijna) foutloze tekst te komen: |
||
*Schrijf je tekst in Word en gebruik daarvan de automatische spellingscontrole. |
*Schrijf je tekst in Word en gebruik daarvan de automatische spellingscontrole. |
||
− | *Maak de tekst op in Word met de regels van de [http://en.wikipedia.org/wiki/Help: |
+ | *Maak de tekst op in Word met de regels van de [http://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup]. Een verkorte versie van de ''Cheatsheet'' is de [https://www.deltaexpertise.nl/images/7/71/Wiki_markup_quick_reference.pdf Wiki markup quick reference]. Je hoeft daarna alleen nog maar de tekst te kopiëren en te plakken in de pagina. |
*Doe niet mee aan de zogenaamde ‘Engelse ziekte’: samenstellingen schrijf je in het Nederlands aan elkaar. Onze Taal biedt een pagina met achtergrondinformatie over het fenomeen [https://onzetaal.nl/taaladvies/advies/samenstelling| samenstelling]. |
*Doe niet mee aan de zogenaamde ‘Engelse ziekte’: samenstellingen schrijf je in het Nederlands aan elkaar. Onze Taal biedt een pagina met achtergrondinformatie over het fenomeen [https://onzetaal.nl/taaladvies/advies/samenstelling| samenstelling]. |
||
*Aan elkaar of niet, gebruik van hoofdletters, leestekens… Als je het niet zeker weet zoek je het op. De website van Onze Taal biedt een uitstekende mogelijkheid om te zoeken naar [https://onzetaal.nl/taaladvies taaladvies]. Daarnaast biedt de Taalunie je de mogelijkheid om te zoeken in de [http://woordenlijst.org Woordenlijst Nederlandse taal]. |
*Aan elkaar of niet, gebruik van hoofdletters, leestekens… Als je het niet zeker weet zoek je het op. De website van Onze Taal biedt een uitstekende mogelijkheid om te zoeken naar [https://onzetaal.nl/taaladvies taaladvies]. Daarnaast biedt de Taalunie je de mogelijkheid om te zoeken in de [http://woordenlijst.org Woordenlijst Nederlandse taal]. |
||
==Speciale tekens en opmaak== |
==Speciale tekens en opmaak== |
||
− | + | *Niet onderstrepen: werkt verwarring in de hand, omdat verwijzingen ook onderstreept zijn en onderstrepen een ouderwetse zogenaamde ‘typemachine-typografie’ is. |
|
− | *Niet onderstrepen: werkt verwarring in de hand, omdat verwijzingen ook onderstreept zijn en onderstrepen |
+ | *Superscript schrijf je op deze manier: <nowiki>X<sup>2</sup></nowiki> wordt: X<sup>2</sup> |
− | *Superscript schrijf je op deze manier: X<sup>2</sup> |
+ | *Subscript schrijf je zo: <nowiki>H<sub>2</sub>O</nowiki> wordt: H<sub>2</sub>O |
− | *Subscript schrijf je zo: H<sub>2</sub>O |
+ | *Een <strike>doorgestreepte tekst</strike> ziet er zo uit: <nowiki><strike>doorgestreepte tekst</strike</nowiki>
|
− | *Een <strike>doorgestreepte tekst</strike> ziet er zo uit |
||
Zie voor meer voorbeelden van speciale opmaak de pagina [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Wikitext examples]. |
Zie voor meer voorbeelden van speciale opmaak de pagina [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Wikitext examples]. |
||
Regel 65: | Regel 67: | ||
<table class="wikitable"> |
<table class="wikitable"> |
||
<caption>Bijschrift bij de tabel</caption> |
<caption>Bijschrift bij de tabel</caption> |
||
− | |||
<tr> |
<tr> |
||
− | <th> |
+ | <th>kop</th> |
− | <th> |
+ | <th>kop</th> |
− | <th> |
+ | <th>kop</th> |
</tr> |
</tr> |
||
− | + | <tr><td>cel</td><td>cel</td><td>cel</td></tr> |
|
− | <tr><td> |
+ | <tr><td>Cel</td><td>cel</td><td>cel</td></tr> |
− | + | <tr><td>Cel</td><td>cel</td><td>cel</td></tr> |
|
− | <tr><td> |
||
</table> |
</table> |
||
Regel 112: | Regel 112: | ||
==Het beschrijven van achtergrondmateriaal (resources)== |
==Het beschrijven van achtergrondmateriaal (resources)== |
||
Informatiemateriaal zoals pdf, documenten, boeken, artikelen, websites, etc. worden resources genoemd. De inhoud van een resource wordt beschreven door middel van metadata (titel, auteur, uitgever, etc.). Dit doen we in de Wiki met ‘Resource Descriptions’. |
Informatiemateriaal zoals pdf, documenten, boeken, artikelen, websites, etc. worden resources genoemd. De inhoud van een resource wordt beschreven door middel van metadata (titel, auteur, uitgever, etc.). Dit doen we in de Wiki met ‘Resource Descriptions’. |
||
− | Bijvoorbeeld een boek kan worden beschreven door een Resource Description aan te maken. Zie |
+ | Bijvoorbeeld een boek kan worden beschreven door een Resource Description aan te maken. Zie voor de standaardmanier waarmee pagina's, en in dit geval Resource Descriptions, worden aangemaakt [[EMM Bronnen en beeldmateriaal van meta-data voorzien VN|deze pagina]]. |
Op dezelfde manier kunnen ook websites worden beschreven. In dit geval moet in het veld hyperlink de URL worden ingevoerd. |
Op dezelfde manier kunnen ook websites worden beschreven. In dit geval moet in het veld hyperlink de URL worden ingevoerd. |
||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===Refereren in de tekst=== |
===Refereren in de tekst=== |
||
− | Met alle Resource |
+ | Met alle Resource descriptions wordt in feite een database opgebouwd met literatuurbeschrijvingen. In wiki-pagina's gebruiken we die om eraan te refereren. Dat gebeurt via de ‘Cite template’ of de 'Nocite template': |
+ | Als je in de tekst verwijst naar een document doe je dat met de Cite template: |
||
<nowiki>{{Cite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}}</nowiki> ziet er in de tekst uit als: {{Cite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}} |
<nowiki>{{Cite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}}</nowiki> ziet er in de tekst uit als: {{Cite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}} |
||
− | + |
In de VN-pagina verschijnt deze verwijzing in de 'Referenties' onderaan de pagina. |
|
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Als je aan het eind van een pagina een literatuurverwijzing opneemt, zonder een eerdere verwijzing in de tekst zelf, ziet diezelfde verwijzing er zo uit: |
|
+ |
<nowiki>{{Nocite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}}</nowiki> De extra informatie, name en optional kunnen eventueel blijven staan, maar hoeft niet. In de pagina zelf zie je nu niets, maar in de VN-pagina wordt deze verwijzing opgenomen in de 'Referenties' onderaan de pagina, net als bij de verwijzing in de tekst met de Cite template. Je moet de VN-pagina soms wel tweemaal saven om het zichtbaar te maken. Het maakt in principe niet uit waar je de 'Nocite template' gebruikt, maar voor de herkenbaarheid en de vindbaarheid is het beter om die in een aparte alinea (zonder titel) op te nemen aan het eind van de pagina. |
||
− | + |
Een voorbeeld zie je hier: [[PBZ onderzoek en innovatie scheve golven|een pagina zonder de verwijzingen zichtbaar]] en [[PBZ onderzoek en innovatie scheve golven VN|dezelfde pagina, maar dan de VN]]
|
|
− | |||
− | + |
Voor meer informatie zie [[EMM Wiki-mark-up VN|deze pagina]]. |
|
− | |||
− | |||
− | |||
− | |||
== Afbeeldingen == |
== Afbeeldingen == |
||
*Gebruik uitsluitend beeld waarvan zeker is dat dit auteursrechtelijk is toegestaan. |
*Gebruik uitsluitend beeld waarvan zeker is dat dit auteursrechtelijk is toegestaan. |
||
− | *Een afbeelding of foto voer je op de volgende manier in: in de alinea van de tekst die naar de afbeelding verwijst en het ziet er zo uit: [[File:Noordwaard Figuur 3.2-a.PNG|thumb|right|200px|Figuur 3.2: Golfhoogtereductie voor een griend van 80 meter.]] |
+ | *Een afbeelding of foto voer je op de volgende manier in: in de alinea van de tekst die naar de afbeelding verwijst en het ziet er zo uit: <nowiki>[[File:Noordwaard Figuur 3.2-a.PNG|thumb|right|200px|Figuur 3.2: Golfhoogtereductie voor een griend van 80 meter.]]</nowiki> En het resultaat staat hiernaast.
|
+ | [[File:Noordwaard Figuur 3.2-a.PNG|thumb|right|200px|Figuur 3.2: Golfhoogtereductie voor een griend van 80 meter.]] |
||
Het voordeel van deze manier is dat je de grootte van de afbeelding kunt aangeven met behulp van het getal dat voor "px" (=aantal pixels) staat en dat je een onderschrift kunt toevoegen. |
Het voordeel van deze manier is dat je de grootte van de afbeelding kunt aangeven met behulp van het getal dat voor "px" (=aantal pixels) staat en dat je een onderschrift kunt toevoegen. |
||
=== Alternatieve teksten === |
=== Alternatieve teksten === |
||
Regel 179: | Regel 140: | ||
*Voeg geen informatie aan de alt-tekst toe die de afbeelding zelf niet bevat, zoals de naam van een plaats of persoon, tenzij die algemeen bekend en dus visueel herkenbaar is, zoals de Eiffeltoren. |
*Voeg geen informatie aan de alt-tekst toe die de afbeelding zelf niet bevat, zoals de naam van een plaats of persoon, tenzij die algemeen bekend en dus visueel herkenbaar is, zoals de Eiffeltoren. |
||
*“Afbeeldingen die geen extra informatie bevatten, krijgen een leeg alt-attribuut (alt=""). Dat voorkomt dat de bestandsnaam wordt getoond of voorgelezen.” (Interdepartementale werkgroep Stijlgids, 2006) |
*“Afbeeldingen die geen extra informatie bevatten, krijgen een leeg alt-attribuut (alt=""). Dat voorkomt dat de bestandsnaam wordt getoond of voorgelezen.” (Interdepartementale werkgroep Stijlgids, 2006) |
||
+ | |||
+ | == Hyperlinks == |
||
+ | In de vakken op de navigatiepagina’s kunnen – met tussenkomst van de beheerder – hyperlinks worden opgenomen. Doel van de hyperlinks – snelkoppelingen – in de navigatievakjes is om de optimale information scent te bieden voor de dieper gelegen niveau’s. Het gaat er met andere woorden om dat mensen geholpen worden om hun routekeuze adequaat te maken. Daarnaast dienen ze soms tevens – maar niet primair – een attenderingsdoel. Voor de keuze van deze hyperlinks gelden daarom de volgende criteria: |
||
+ | * De set hyperlinks in een blokje is geselecteerd aan de hand van de volgende criteria: ze zijn representatief en/of belangrijk (voor gebruiker en/of afzender) en/of actueel en/of veel geraadpleegd en in sommige gevallen uitzonderlijk/moeilijk te vinden. Met dat laatste criterium maak je dat ook delen van de rubriek die men er niet zou verwachten en er toch mee geassocieerd worden. |
||
+ | * Zijn er naast dieper gelegen navigatiepagina’s, dan vormen de geselecteerde hyperlinks daar een subset van. |
||
== Practices en Experiences aanmaken == |
== Practices en Experiences aanmaken == |
||
* '''Practices''' (Processen) zijn Situaties en nadrukkelijk geen Rollen. Voor elke Situatie moet een Practice worden aangemaakt: <nowiki>[[Category:Practice]]</nowiki> en kies bij het veld Practice type: Practice. |
* '''Practices''' (Processen) zijn Situaties en nadrukkelijk geen Rollen. Voor elke Situatie moet een Practice worden aangemaakt: <nowiki>[[Category:Practice]]</nowiki> en kies bij het veld Practice type: Practice. |
||
* Voor '''Experiences''' (Cases) geldt hetzelfde als voor Practices: Experiences zijn Situaties op het niveau van Cases. Voor elke Situatie moet een Experience worden aangemaakt: <nowiki>[[Category:Practice]]</nowiki> en kies bij het veld Practice type: Experience. |
* Voor '''Experiences''' (Cases) geldt hetzelfde als voor Practices: Experiences zijn Situaties op het niveau van Cases. Voor elke Situatie moet een Experience worden aangemaakt: <nowiki>[[Category:Practice]]</nowiki> en kies bij het veld Practice type: Experience. |
||
− | * De Experience is een ''onderdeel van'' (ofwel: een instantie van) een Practice en moet als dusdanig worden aangemaakt |
+ | * De Experience is een ''onderdeel van'' (ofwel: een instantie van) een Practice en moet als dusdanig worden aangemaakt. |
=== Cases (''instantie van'') toevoegen aan de DeltaExpertise-site === |
=== Cases (''instantie van'') toevoegen aan de DeltaExpertise-site === |
||
Regel 189: | Regel 155: | ||
* Contexten van Cases invoeren: ga naar de bijbehorende Context_VN-pagina. Kies: Bewerken en voeg toe: <nowiki>{{Case Context VN}}</nowiki> en kies SAVE. Kies vervolgens Edit with Form en verwijder <nowiki>{{Context VN show}}</nowiki> en kies SAVE. |
* Contexten van Cases invoeren: ga naar de bijbehorende Context_VN-pagina. Kies: Bewerken en voeg toe: <nowiki>{{Case Context VN}}</nowiki> en kies SAVE. Kies vervolgens Edit with Form en verwijder <nowiki>{{Context VN show}}</nowiki> en kies SAVE. |
||
* Het hoofdschema van een Case heeft geen supercontext. |
* Het hoofdschema van een Case heeft geen supercontext. |
||
− | |||
− |
De DeltaExpertise-site is een site waarvoor eenieder die geautoriseerd is tekst en beeld aan kan leveren. Om geautoriseerd te worden en vervolgens de site te kunnen wijzigen, kan gebruik worden gemaakt van het hangslot-icoontje rechtsboven in beeld.
Onderstaand vind je informatie met betrekking tot het aanvullen/wijzigen van de site, waaronder aanwijzingen om de leesbaarheid van teksten en de eenheid in stijl en opmaak te bevorderen.
De informatie hieronder is aangevuld met informatie uit de EMM-cursus en verwerkt tot een overzichtelijke gebruikershandleiding.
Door middel van deze gebruikershandleiding kan iedereen die de EMM-cursus succesvol heeft afgerond zelfstandig kennis en expertise verwerken en opslaan op de DeltaExpertise-site.
Semantic MediaWiki Gebruikershandleiding
Hieronder vind je een aantal aanwijzingen om te komen tot een eenheid in stijl van de pagina's:
Hieronder staat een aantal punten die de leesbaarheid van de tekst bevorderen.
Deze punten helpen je om een tekst aantrekkelijker te maken:
Ten slotte nog een aantal aanwijzingen om tot een (bijna) foutloze tekst te komen:
Zie voor meer voorbeelden van speciale opmaak de pagina Wikitext examples.
Gebruik voor een eenvoudige tabel de onderstaande opmaak. Je ziet de opmaak als je deze pagina opent in de 'edit' modus. Je kopieert dan de opmaak naar het Wordbestand waarin je de pagina aan het schrijven bent of rechtstreeks naar de op te maken Wikipagina. Een uitgebreide uitleg van over het maken van tabellen vind je op de MediaWiki-helppagina Tables.
kop | kop | kop |
---|---|---|
cel | cel | cel |
Cel | cel | cel |
Cel | cel | cel |
Hieronder een voorbeeld van een meer ingewikkelde tabel, waarbij een aantal cellen zijn samengevoegd.
Stage | Trait |
---|---|
Colonization | r-selected life history strategy:
|
Generalists:
| |
Gregarious behavior | |
Genetic variability and phenotypic plasticity | |
Ability to recolonize after population crash | |
Establishment | Lack of natural enemies |
Ecosystem engineering | |
Association with humans | |
Repeated introductions | |
Genetic variability and phenotypic plasticity | |
Competitiveness | |
Natural range expansion | Traits of successful colonists (see above) |
Dispersability |
Informatiemateriaal zoals pdf, documenten, boeken, artikelen, websites, etc. worden resources genoemd. De inhoud van een resource wordt beschreven door middel van metadata (titel, auteur, uitgever, etc.). Dit doen we in de Wiki met ‘Resource Descriptions’. Bijvoorbeeld een boek kan worden beschreven door een Resource Description aan te maken. Zie voor de standaardmanier waarmee pagina's, en in dit geval Resource Descriptions, worden aangemaakt deze pagina. Op dezelfde manier kunnen ook websites worden beschreven. In dit geval moet in het veld hyperlink de URL worden ingevoerd.
Met alle Resource descriptions wordt in feite een database opgebouwd met literatuurbeschrijvingen. In wiki-pagina's gebruiken we die om eraan te refereren. Dat gebeurt via de ‘Cite template’ of de 'Nocite template':
Als je in de tekst verwijst naar een document doe je dat met de Cite template: {{Cite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}} ziet er in de tekst uit als: Projectplan (pagina 2–4)
In de VN-pagina verschijnt deze verwijzing in de 'Referenties' onderaan de pagina.
Als je aan het eind van een pagina een literatuurverwijzing opneemt, zonder een eerdere verwijzing in de tekst zelf, ziet diezelfde verwijzing er zo uit: {{Nocite|resource=File:CoE Projectplan Kennismanagement v20130620.docx |name=Projectplan|optional=pagina 2–4}} De extra informatie, name en optional kunnen eventueel blijven staan, maar hoeft niet. In de pagina zelf zie je nu niets, maar in de VN-pagina wordt deze verwijzing opgenomen in de 'Referenties' onderaan de pagina, net als bij de verwijzing in de tekst met de Cite template. Je moet de VN-pagina soms wel tweemaal saven om het zichtbaar te maken. Het maakt in principe niet uit waar je de 'Nocite template' gebruikt, maar voor de herkenbaarheid en de vindbaarheid is het beter om die in een aparte alinea (zonder titel) op te nemen aan het eind van de pagina.
Een voorbeeld zie je hier: een pagina zonder de verwijzingen zichtbaar en dezelfde pagina, maar dan de VN
Voor meer informatie zie deze pagina.
Het voordeel van deze manier is dat je de grootte van de afbeelding kunt aangeven met behulp van het getal dat voor "px" (=aantal pixels) staat en dat je een onderschrift kunt toevoegen.
In de vakken op de navigatiepagina’s kunnen – met tussenkomst van de beheerder – hyperlinks worden opgenomen. Doel van de hyperlinks – snelkoppelingen – in de navigatievakjes is om de optimale information scent te bieden voor de dieper gelegen niveau’s. Het gaat er met andere woorden om dat mensen geholpen worden om hun routekeuze adequaat te maken. Daarnaast dienen ze soms tevens – maar niet primair – een attenderingsdoel. Voor de keuze van deze hyperlinks gelden daarom de volgende criteria: