Aan de slag: verschil tussen versies
(→referenties) |
(→tabellen) |
||
| (34 tussenliggende versies door 2 gebruikers niet weergegeven) | |||
| Regel 7: | Regel 7: | ||
==Filosofie== | ==Filosofie== | ||
===Samen schrijven=== | ===Samen schrijven=== | ||
| − | Samen teksten schrijven, veranderen vraagt een open en eerlijke houding. De wiki laat je alles zien, de brontekst, de laatste wijzigingen die gebeurd zijn,... en laat toe om steeds te wijzigen. Het is echter niet de bedoeling zomaar stukken te wijzigen, maar hier echt over te babbelen, te | + | Samen teksten schrijven, veranderen vraagt een open en eerlijke houding. De wiki laat je alles zien, de brontekst, de laatste wijzigingen die gebeurd zijn,... en laat toe om steeds te wijzigen. |
| − | + | * Het is echter niet de bedoeling zomaar stukken te wijzigen, maar hier echt over te babbelen, te discussiëren en samen op zoek te gaan naar verbetering, aanvulling. Je gaat dus niet zomaar aan de bewoordingen van een collega aanpassingen maken<ref>https://www.mediawiki.org/wiki/Help:Talk_pages</ref>. | |
| − | + | * Wil je toch aanpassingen uitvoeren, geef dit eerst aan op het tabblad discussie op elke pagina. | |
| + | * Een bijlage is een bijlage. Dynamische gegevens plaats je dus niet in een PDF als bijlage, maar maak je best op de wiki aan. Grote datasets kunnen we importeren. Daarvoor vraag je best hulp. | ||
===Open kennis delen=== | ===Open kennis delen=== | ||
Alles op de wiki is er voor iedereen en kan door iedereen gebruikt worden. enkele tips: | Alles op de wiki is er voor iedereen en kan door iedereen gebruikt worden. enkele tips: | ||
| − | * Let dus ook dat de gegevens die je oplaadt publiek zijn. | + | * Let dus ook dat de gegevens die je oplaadt publiek mogen zijn. |
| − | * | + | * Hanteer steeds een neutraal standpunt. Schrijf alsof je een buitenstaander bent. |
| + | * Hanteer volle namen en vermijdt afkortingen. | ||
| + | ** Een voornaam als bron is dus niet voldoende. | ||
| + | ** verbind afkortingen met de volledige term. | ||
| + | |||
===Van algemeen naar detail=== | ===Van algemeen naar detail=== | ||
| − | Wikipedia, de | + | Wikipedia, de bekendste mediawiki, hanteert het principe dat kennis pas interessant wordt als die voor een grote groep mensen interessant is<ref>https://en.wikipedia.org/wiki/Wikipedia:Notability</ref>. Dat verwacht dat je dus kort schrijft en vooral begint vanuit wat zo algemeen mogelijk is. |
===Bronnen, bronnen, bronnen=== | ===Bronnen, bronnen, bronnen=== | ||
| + | Een wiki is niet de plaats voor origineel werk, voor een biografie, voor lange teksten die nog niet gepubliceerd werden,... Net zoals wikipedia proberen we steeds bronnen te hebben voor wat we beweren.<ref>https://en.wikipedia.org/wiki/Wikipedia:Verifiability</ref> | ||
==Pagina's== | ==Pagina's== | ||
===Een nieuwe pagina aanmaken=== | ===Een nieuwe pagina aanmaken=== | ||
| − | Een nieuwe pagina aanmaken kan op verschillende manieren. Best vertrek je vanuit een bestaande pagina. | + | Een nieuwe pagina aanmaken kan op verschillende manieren. |
| + | * Je kunt een nieuwe pagina aanmaken, door op een rode link te klikken, ergens in de tekst. | ||
| + | * Best vertrek je vanuit een bestaande pagina. Je kunt ook op een bestaande pagina (maar wel op een relevante plek) zelf vierkante haken in een tekst aanbrengen, om zo een nieuwe bladzijde te beginnen: <nowiki>[[titel]]</nowiki>. | ||
| + | Plaats je daar een <nowiki>[[onderwerp]]</nowiki>, dan verschijnt die als rood mocht er nog geen passende pagina zijn. Als je dus een link hebt waarvoor geen pagina bestaat, dan kan je daar op klikken zal de wiki je vragen of je een nieuwe pagina wil aanmaken. | ||
| + | * gebruik de zoekbox rechtsboven en tik de naam in van de pagina. de wiki zal je vertellen dat de pagina nog niet bestaat. Opnieuw kan je hier starten om een pagina aan te maken. | ||
| + | |||
===Een pagina bewerken=== | ===Een pagina bewerken=== | ||
Wil je een pagina bewerken? Klik op '''bewerken''' naast de titel. Je komt automatisch op een pagina met bewerkingsveld terecht. | Wil je een pagina bewerken? Klik op '''bewerken''' naast de titel. Je komt automatisch op een pagina met bewerkingsveld terecht. | ||
| Regel 29: | Regel 40: | ||
===Structuur=== | ===Structuur=== | ||
| − | Start je pagina altijd met een inleidende zin. | + | * Start je pagina altijd met een inleidende zin. |
| + | * links en info kan je in de bronvermelding opnemen, en je kan steeds met voetnoten werken. | ||
| + | * deel je werk op in niet al te lange paragrafen. | ||
| + | * plaats bestanden om je info te delen | ||
| + | * plaats links op de juiste plaats. | ||
| + | * is je pagina af? dan kan je hem ook volgen (sterretje bovenaan) en zo blijvend info toevoegen, samen met anderen. | ||
==Schrijven met syntaxen== | ==Schrijven met syntaxen== | ||
| − | In een Wiki wordt gebruik gemaakt van syntaxen om de tekst te structureren en op te maken. We geven hieronder een overzicht van de belangrijkste syntaxen. Het spiekbriefje kan je best naast je leggen bij het aanpassen. Vind je hier iets niet terug, dan kan je steeds het | + | In een Wiki wordt gebruik gemaakt van syntaxen om de tekst te structureren en op te maken. We geven hieronder een overzicht van de belangrijkste syntaxen. Het spiekbriefje kan je best naast je leggen bij het aanpassen. Vind je hier iets niet terug, dan kan je steeds het [https://nl.wikibooks.org/wiki/Handboek_MediaWiki|wikibooks.org Mediawiki handboek] raadplegen. |
===Tekstopmaak=== | ===Tekstopmaak=== | ||
| Regel 49: | Regel 65: | ||
| '''''vet en cursief lettertype''''' | | '''''vet en cursief lettertype''''' | ||
|} | |} | ||
| + | |||
| + | ===Alinea=== | ||
| + | Gebruik een dubbele enter om naar de volgende lijn te gaan. | ||
===Koppen=== | ===Koppen=== | ||
| Regel 57: | Regel 76: | ||
|- | |- | ||
| <code><nowiki>==Kop niveau 2==</nowiki></code> | | <code><nowiki>==Kop niveau 2==</nowiki></code> | ||
| − | | | + | | Grote titel |
|- | |- | ||
| <code><nowiki>===Kop niveau 3===</nowiki></code> | | <code><nowiki>===Kop niveau 3===</nowiki></code> | ||
| − | | | + | | Ondertitel |
|- | |- | ||
| <code><nowiki>====Kop niveau 4====</nowiki></code> | | <code><nowiki>====Kop niveau 4====</nowiki></code> | ||
| − | | | + | | Sub-ondertitel |
|} | |} | ||
| Regel 122: | Regel 141: | ||
Tabellen in een wiki invoegen vraagt enige oefening. | Tabellen in een wiki invoegen vraagt enige oefening. | ||
Wel zijn er handige [http://mlei.net/shared/tool/csv-wiki.htm tools] , die toelaten je info uit excel te kopiëren. | Wel zijn er handige [http://mlei.net/shared/tool/csv-wiki.htm tools] , die toelaten je info uit excel te kopiëren. | ||
| + | Een voorbeeld van hoe een eenvoudige tabel in wikisyntax er uit ziet: | ||
| + | |||
| + | Een voorbeeld van hoe een eenvoudige tabel in wikisyntax er uit ziet: | ||
| + | <pre> | ||
| + | {| class="wikitable sortable" | ||
| + | ! hoofd 1 | ||
| + | ! hoofd 2 | ||
| + | ! hoofd 3 | ||
| + | |- | ||
| + | | Cel 1 | ||
| + | | Cel 2 | ||
| + | | Cel 3 | ||
| + | |- | ||
| + | | Cel 4 || Cel 5 || Cel 6 | ||
| + | |}</pre> | ||
| + | |||
| + | Door de tekst in een cel weg te laten wordt er een lege cel gecreëerd. | ||
| + | |||
| + | Dit geeft volgend resultaat | ||
| + | {| class="wikitable" | ||
| + | ! hoofd 1 | ||
| + | ! hoofd 2 | ||
| + | ! hoofd 3 | ||
| + | |- | ||
| + | | Cel 1 | ||
| + | | Cel 2 | ||
| + | | Cel 3 | ||
| + | |- | ||
| + | | Cel 4 || Cel 5 || Cel 6 | ||
| + | |} | ||
===afbeeldingen=== | ===afbeeldingen=== | ||
| + | ====bestanden beschikbaar maken==== | ||
| + | Bestanden, bijvoorbeeld afbeeldingen, voor gebruik in artikelen moeten altijd geüpload worden naar de wiki, bestanden kunnen niet direct gebruikt worden. Klink hiervoor links in de navigatiebalk op <b>bestand uploaden</b>. | ||
| + | ====een bestand plaatsen==== | ||
| + | Er is een groot aantal mogelijkheden om een bestand in een artikel te plaatsen. Hieronder worden de meest gebruikte methoden uitgelegd, met daarbij steeds de code om een bestand te genereren en daarna het resultaat. | ||
| + | |||
| + | Let er op dat bij voorkeur de afbeeldingen of andere bestanden rechts worden geplaatst. Soms heeft plaatsing aan de linkerkant de voorkeur, bijvoorbeeld een portret van iemand die naar rechts kijkt. | ||
| + | |||
| + | Een geschikte plaats is niet aan het begin van het artikel maar na de inleiding, vóór de eerste tussenkop. Op die plek wordt namelijk de automatische inhoudsopgave ingevoegd en het plaatje komt dan in de lege ruimte rechts van de inhoudsopgave. | ||
| + | |||
| + | Het bestand wordt over het algemeen geplaatst door een link te plaatsen, met daarachter optioneel een aantal opties. | ||
| + | * dit is de basis | ||
| + | ::<code><nowiki>[[Bestand:bestandnaam.jpg|optie1|optie2|optie3|...]]</nowiki></code>. | ||
| + | * gebruik een verkleinde versie waarop de bezoeker eventueel kan klikken. | ||
| + | ::<code><nowiki>[[Bestand:bestandnaam.jpg|thumb|bijschrift]]</nowiki></code>. | ||
| + | * wil je een bestand beschikbaar maken voor download, dan doe je dit zo: | ||
| + | ::<code><nowiki>[[Media:bestandnaam.jpg|thumb|bijschrift]]</nowiki></code>. | ||
| + | |||
===referenties en noten=== | ===referenties en noten=== | ||
Plaats steeds een referentie, dit kan je via <nowiki>"<ref>jouw referentie</ref>"</nowiki>. Onderaan de pagina kan je vervolgens een hoofding tovevoegen en <nowiki><references/></nowiki> plaatsen. Op die manier wordt onderaan een lijst van voetnoten opgebouwd. | Plaats steeds een referentie, dit kan je via <nowiki>"<ref>jouw referentie</ref>"</nowiki>. Onderaan de pagina kan je vervolgens een hoofding tovevoegen en <nowiki><references/></nowiki> plaatsen. Op die manier wordt onderaan een lijst van voetnoten opgebouwd. | ||
| − | <ref>zie https://www.mediawiki.org/wiki/Help:Editing_pages</ref> | + | Meer info over de opmaak van refenties vind je hier<ref>zie https://www.mediawiki.org/wiki/Help:Editing_pages</ref>. |
===je teksten verrijken en verbinden=== | ===je teksten verrijken en verbinden=== | ||
| Regel 137: | Regel 203: | ||
| <code><nowiki>[[Categorie:categorie-term]]</nowiki></code> | | <code><nowiki>[[Categorie:categorie-term]]</nowiki></code> | ||
|} | |} | ||
| + | de gebruikte categorieën vind je hier terug: | ||
| + | |||
| + | http://wiki.ksa.be/index.php?title=Speciaal:Categorie%C3%ABn | ||
===Semantische wiki=== | ===Semantische wiki=== | ||
| − | Om in de bomen het bos te zien en snelle overzichten te creëeren bevat deze wiki ook semantische gegevens. Door het gebruik van volgende werkwijze geef je een pagina of thema eigenschappen. | + | Om in de bomen het bos te zien en snelle overzichten te creëeren bevat deze wiki ook semantische gegevens. |
| − | + | ||
| + | Dit is al voor gevorderden. Door het gebruik van volgende werkwijze geef je een pagina of thema eigenschappen. Voorlopig gebruiken we [http://wiki.ksa.be/index.php?title=Speciaal:GewensteEigenschappen volgende eigenschappen] | ||
| + | |||
| + | Eindig de pagina met <code><nowiki>_SHOWFACTBOX_</nowiki></code>. In deze tabel zie je een overzicht van de semantisch toegevoegde gegevens. | ||
===Aan de slag=== | ===Aan de slag=== | ||
Neem het [https://upload.wikimedia.org/wikipedia/commons/0/05/Cheatsheet-en.pdf spiekbriefje] bij de hand! | Neem het [https://upload.wikimedia.org/wikipedia/commons/0/05/Cheatsheet-en.pdf spiekbriefje] bij de hand! | ||
| + | |||
==meer info== | ==meer info== | ||
<references/> | <references/> | ||
Huidige versie van 10 sep 2017 om 04:41
Deze pagina legt je uit hoe de Wiki werkt. Meeschrijven aan de geschiedenis van de VKSJ is eenvoudig, iedereen kan meehelpen. Fouten maken is niet erg, dit kan makkelijk terug hersteld worden.
Start
Om aan deze wiki bij te dragen heb je een login nodig. Die kan je opvragen bij jouw contactpersoon van de VKSJ-werkgroep. Aanmelden kan via de knop aanmelden bovenaan rechts op de pagina.
Filosofie
Samen schrijven
Samen teksten schrijven, veranderen vraagt een open en eerlijke houding. De wiki laat je alles zien, de brontekst, de laatste wijzigingen die gebeurd zijn,... en laat toe om steeds te wijzigen.
- Het is echter niet de bedoeling zomaar stukken te wijzigen, maar hier echt over te babbelen, te discussiëren en samen op zoek te gaan naar verbetering, aanvulling. Je gaat dus niet zomaar aan de bewoordingen van een collega aanpassingen maken[1].
- Wil je toch aanpassingen uitvoeren, geef dit eerst aan op het tabblad discussie op elke pagina.
- Een bijlage is een bijlage. Dynamische gegevens plaats je dus niet in een PDF als bijlage, maar maak je best op de wiki aan. Grote datasets kunnen we importeren. Daarvoor vraag je best hulp.
Open kennis delen
Alles op de wiki is er voor iedereen en kan door iedereen gebruikt worden. enkele tips:
- Let dus ook dat de gegevens die je oplaadt publiek mogen zijn.
- Hanteer steeds een neutraal standpunt. Schrijf alsof je een buitenstaander bent.
- Hanteer volle namen en vermijdt afkortingen.
- Een voornaam als bron is dus niet voldoende.
- verbind afkortingen met de volledige term.
Van algemeen naar detail
Wikipedia, de bekendste mediawiki, hanteert het principe dat kennis pas interessant wordt als die voor een grote groep mensen interessant is[2]. Dat verwacht dat je dus kort schrijft en vooral begint vanuit wat zo algemeen mogelijk is.
Bronnen, bronnen, bronnen
Een wiki is niet de plaats voor origineel werk, voor een biografie, voor lange teksten die nog niet gepubliceerd werden,... Net zoals wikipedia proberen we steeds bronnen te hebben voor wat we beweren.[3]
Pagina's
Een nieuwe pagina aanmaken
Een nieuwe pagina aanmaken kan op verschillende manieren.
- Je kunt een nieuwe pagina aanmaken, door op een rode link te klikken, ergens in de tekst.
- Best vertrek je vanuit een bestaande pagina. Je kunt ook op een bestaande pagina (maar wel op een relevante plek) zelf vierkante haken in een tekst aanbrengen, om zo een nieuwe bladzijde te beginnen: [[titel]].
Plaats je daar een [[onderwerp]], dan verschijnt die als rood mocht er nog geen passende pagina zijn. Als je dus een link hebt waarvoor geen pagina bestaat, dan kan je daar op klikken zal de wiki je vragen of je een nieuwe pagina wil aanmaken.
- gebruik de zoekbox rechtsboven en tik de naam in van de pagina. de wiki zal je vertellen dat de pagina nog niet bestaat. Opnieuw kan je hier starten om een pagina aan te maken.
Een pagina bewerken
Wil je een pagina bewerken? Klik op bewerken naast de titel. Je komt automatisch op een pagina met bewerkingsveld terecht. Klik na het aanpassen eerste op Bewerking ter controle bekijken. Hierdoor worden de nieuwe wijzigingen nog niet direct opgeslagen, je kan eerst controleren als de lay-out juist zit, alles correct is en de aanpassingen gepubliceerd kunnen worden. Is alles oké? Klik vervolgens op Wijzigingen opslaan. De nieuwe gegevens zijn nu toegevoegd aan de pagina. Wil je enkel een deel van de pagina bewerken, dan kan dit ook. Naast elke titel zie je bewerken staan waardoor je dit deel van de tekst kan aanpassen.
Structuur
- Start je pagina altijd met een inleidende zin.
- links en info kan je in de bronvermelding opnemen, en je kan steeds met voetnoten werken.
- deel je werk op in niet al te lange paragrafen.
- plaats bestanden om je info te delen
- plaats links op de juiste plaats.
- is je pagina af? dan kan je hem ook volgen (sterretje bovenaan) en zo blijvend info toevoegen, samen met anderen.
Schrijven met syntaxen
In een Wiki wordt gebruik gemaakt van syntaxen om de tekst te structureren en op te maken. We geven hieronder een overzicht van de belangrijkste syntaxen. Het spiekbriefje kan je best naast je leggen bij het aanpassen. Vind je hier iets niet terug, dan kan je steeds het Mediawiki handboek raadplegen.
Tekstopmaak
De tekst kan je opmaken door gebruik te maken van onderstaande syntaxen.
| Wikitekst | Resultaat |
|---|---|
''cursief lettertype''
|
cursief lettertype |
'''vet lettertype'''
|
vet lettertype |
'''''vet en cursief lettertype'''''
|
vet en cursief lettertype |
Alinea
Gebruik een dubbele enter om naar de volgende lijn te gaan.
Koppen
Een tekst kan je structureren door gebruik te maken van koppen.
| Wikitekst | Resultaat |
|---|---|
==Kop niveau 2==
|
Grote titel |
===Kop niveau 3===
|
Ondertitel |
====Kop niveau 4====
|
Sub-ondertitel |
Linken leggen
Een link leggen kan naar een ander artikel op deze wiki of naar een externe website.
| Wikitekst | Resultaat |
|---|---|
[[Interne link naar een ander artikel op de Wiki]]
|
Interne link naar een ander artikel op de Wiki |
[[Interne link naar een ander artikel op de Wiki|Naam van de linkl]]
|
Naam van de link |
http://www.erfgoedzuidwest.be
|
http://www.erfgoedzuidwest.be |
[http://www.erfgoedzuidwest.be erfgoed zuidwest]
|
erfgoed zuidwest |
Lijsten en nummers
Op de wiki kan je een ongenummerde of genummerde lijsten toevoegen. Ook kan je tekst laten inspiringen, zonder bullets of nummers.
| Wikitekst | Resultaat |
|---|---|
* een
* twee
* drie
|
|
# een
# twee
# drie
|
|
: een
:: twee
:# drie
|
|
tabellen
Tabellen in een wiki invoegen vraagt enige oefening. Wel zijn er handige tools , die toelaten je info uit excel te kopiëren. Een voorbeeld van hoe een eenvoudige tabel in wikisyntax er uit ziet:
Een voorbeeld van hoe een eenvoudige tabel in wikisyntax er uit ziet:
{| class="wikitable sortable"
! hoofd 1
! hoofd 2
! hoofd 3
|-
| Cel 1
| Cel 2
| Cel 3
|-
| Cel 4 || Cel 5 || Cel 6
|}
Door de tekst in een cel weg te laten wordt er een lege cel gecreëerd.
Dit geeft volgend resultaat
| hoofd 1 | hoofd 2 | hoofd 3 |
|---|---|---|
| Cel 1 | Cel 2 | Cel 3 |
| Cel 4 | Cel 5 | Cel 6 |
afbeeldingen
bestanden beschikbaar maken
Bestanden, bijvoorbeeld afbeeldingen, voor gebruik in artikelen moeten altijd geüpload worden naar de wiki, bestanden kunnen niet direct gebruikt worden. Klink hiervoor links in de navigatiebalk op bestand uploaden.
een bestand plaatsen
Er is een groot aantal mogelijkheden om een bestand in een artikel te plaatsen. Hieronder worden de meest gebruikte methoden uitgelegd, met daarbij steeds de code om een bestand te genereren en daarna het resultaat.
Let er op dat bij voorkeur de afbeeldingen of andere bestanden rechts worden geplaatst. Soms heeft plaatsing aan de linkerkant de voorkeur, bijvoorbeeld een portret van iemand die naar rechts kijkt.
Een geschikte plaats is niet aan het begin van het artikel maar na de inleiding, vóór de eerste tussenkop. Op die plek wordt namelijk de automatische inhoudsopgave ingevoegd en het plaatje komt dan in de lege ruimte rechts van de inhoudsopgave.
Het bestand wordt over het algemeen geplaatst door een link te plaatsen, met daarachter optioneel een aantal opties.
- dit is de basis
[[Bestand:bestandnaam.jpg|optie1|optie2|optie3|...]].
- gebruik een verkleinde versie waarop de bezoeker eventueel kan klikken.
[[Bestand:bestandnaam.jpg|thumb|bijschrift]].
- wil je een bestand beschikbaar maken voor download, dan doe je dit zo:
[[Media:bestandnaam.jpg|thumb|bijschrift]].
referenties en noten
Plaats steeds een referentie, dit kan je via "<ref>jouw referentie</ref>". Onderaan de pagina kan je vervolgens een hoofding tovevoegen en <references/> plaatsen. Op die manier wordt onderaan een lijst van voetnoten opgebouwd. Meer info over de opmaak van refenties vind je hier[4].
je teksten verrijken en verbinden
Categorieën
deze wiki gebruikt categorieën om types pagina's te groeperen en eenvoudig overzichten te maken. De wiki doet dit voor groepen, termen, secretariaten, personen, organisaties,... Om een pagina tot een categorie te maken kan je op elke mogelijke plek in de wikitekst volgend element intikken.
| Wikitekst |
|---|
[[Categorie:categorie-term]]
|
de gebruikte categorieën vind je hier terug:
http://wiki.ksa.be/index.php?title=Speciaal:Categorie%C3%ABn
Semantische wiki
Om in de bomen het bos te zien en snelle overzichten te creëeren bevat deze wiki ook semantische gegevens.
Dit is al voor gevorderden. Door het gebruik van volgende werkwijze geef je een pagina of thema eigenschappen. Voorlopig gebruiken we volgende eigenschappen
Eindig de pagina met _SHOWFACTBOX_. In deze tabel zie je een overzicht van de semantisch toegevoegde gegevens.
Aan de slag
Neem het spiekbriefje bij de hand!
