[StartPagina] [IndexVanTitels] [IndexVanWoorden] 

Werken met de wiki

Inhoud

  1. Werken met de wiki
    1. Wat is een wiki?
    2. Een account aanmaken
    3. Een nieuwe wiki-pagina aanmaken
    4. Wiki-syntax: de basis
      1. Koppen
      2. Plaatjes
      3. Links
      4. Inhoudsopgave
      5. Opmerkingen-velden
    5. Tips & Tricks
    6. Links

Als u deze pagina leest, bent u waarschijnlijk nieuwsgierig hoe u mee kunt helpen aan de Nederlandstalige documentatie voor Ubuntu, of wijzigingen kunt maken op andere community wikipagina's. Mooi zo! Op deze pagina zult u lezen hoe u een start kunt maken op deze wiki met het schrijven van documentatie.

Wat is een wiki?

De Nederlandstalige Ubuntu-documentatie wordt geschreven door verschillende mensen uit de Ubuntu-gemeenschap. Het systeem waarop we dit doen, wordt een wiki genoemd. Het principe van een wiki is gebaseerd op de open source gedachte: iedereen moet mee kunnen helpen. U dus ook!

Een account aanmaken

Om artikelen te kunnen bewerken op deze wiki, is een account nodig. Deze kunt u hier aanmaken. Door middel van het account kunnen lezers u tevens als schrijver of bewerker van artikelen identificeren. Het bevordert de samenwerking op de wiki, en maakt het ook makkelijker voor het documentatieteam om contact met u op te nemen, als dat nodig is.

Als u eenmaal een account geregistreerd hebt, zult u zien dat u alle pagina's in het /community gedeelte op de wiki aan kunt passen. U kunt dus al starten met het maken van verbeteringen en aanvullingen in bestaande artikelen, door gewoon op de Bewerken (Tekst)-link bovenin de pagina te klikken.

Een nieuwe wiki-pagina aanmaken

Wanneer u ingelogd bent kunt u een nieuwe pagina aanmaken door in de adresbalk de URL te kiezen van het artikel dat u aan wilt maken. 

http://wiki.ubuntu-nl.org/community/mijnnieuwepagina

Het gebruik van hoofdletters is effectief. Op deze manier is de naam van de pagina beter te lezen. 

http://wiki.ubuntu-nl.org/community/MijnNieuwePagina

Wanneer u een nieuwe titel hebt gekozen, verschijnt er op u scherm dat de pagina nog niet bestaat. Kies Bewerken (Tekst) of Een nieuwe pagina aanmaken en u kunt beginnen met schrijven! 

<<Include(Label/InAanbouw)>>

Uw artikel zal dan ook automatisch in de lijst op ArtikelenInAanbouw komen te staan.

Wiki-syntax: de basis

Nu u een wiki-pagina aan hebt gemaakt, wilt u waarschijnlijk weten hoe u opmaak en indeling toe kunt voegen aan uw pagina. Dit gebeurt met behulp van wiki-codes. Hieronder worden enkele veelgebruikte codes uitgelegd en gedemonstreerd.

Koppen

Om een duidelijke structuur in uw handleiding te krijgen, is het essentieel om hoofdstukken of koppen aan te maken. Hieronder vindt u een voorbeeldje van de code. 

= level 1 kop =
== level 2 kop ==
=== level 3 kop ===
==== level 4 kop ====
===== level 5 kop =====

De verschillende levels zorgen ervoor dat u ook sub-koppen aan kunt maken. Zo wilt u misschien in uw artikel "Werken met programma X" een kop "De eerste stappen" hebben, met daarin de sub-koppen "Download programma X" en "Installeer programma X". Dit kunt u op de volgende manier bereiken. 

= Werken met programma X =
Inleiding hier.

== De eerste stappen ==
Wat tekst hier.

=== Download programma X ===
Instructies hier.

=== Installeer programma X ===
Nog meer instructies hier.

== En eventueel nog een kop ==
De mogelijkheden zijn eindeloos!

Plaatjes

Om plaatjes in te voegen gebruikt u de volgende code (verander Afbeelding.png in een bestandsnaam die de afbeelding beschrijft). 

{{attachment:Afbeelding.png}}

Hierdoor zal er in het artikel een paperclip verschijnen. Als u op de paperclip klikt, kunt u de afbeelding opsturen.

Plaatjes die op meerdere pagina's gebruikt worden, zoals bijvoorbeeld iconen, kunt u toevoegen als bijlage aan de pagina Afbeeldingen.

Voor het maken van links maakt u gebruik van de [ en ].

De belangrijkste manieren om externe links te maken staan hieronder op een rijtje. 

http://www.ubuntu-nl.org/
[[http://www.ubuntu-nl.org/|Externe link]]
emailadres@website.org

Voor een verwijzing binnen de wiki hoeft u alleen de naam van de pagina op te schrijven (werkt alleen als de naam van het artikel meerdere hoofdletters bevat).

Mooier is om de link een linktekst te geven. 

[[VoorbeeldArtikel|Lees meer over dit onderwerp...]]

Geef nooit het gehele adres op bij interne links! Wilt u bijvoorbeeld naar deze pagina verwijzen dan doet u:
 [[community/WerkenMetDeWiki | WerkenMetDeWiki]]

en NIET:
[[http://wiki.ubuntu-nl.org/community/WerkenMetDeWiki | WerkenMetDeWiki]]


Wilt u voorkomen dat er automatisch verwezen wordt naar een wiki pagina, bijvoorbeeld bij het woord "MediaPlayer", plaats dan een uitroepteken voor het woord. 

!MediaPlayer

Inhoudsopgave

Het plaatsen van een inhoudsopgave is aan te raden, vooral voor langere artikelen. Voeg de code bij voorkeur bovenaan de pagina toe. 

||<tablestyle="float:right; font-size: 0.9em;"><<TableOfContents>>||

Opmerkingen-velden

Op de wiki kunt u op een gemakkelijke manier opmerkingen-velden plaatsen. Er worden de volgende soorten opmerkingen onderscheiden:

Om een opmerkingen-veld in te voegen, gebruikt u de volgende code. U kunt zo nodig in de code tip vervangen door een andere soort opmerking (zie het lijstje hierboven).

{{{#!wiki tip
Dit is een leuke tip.
}}}

Resultaat

Dit is een leuke tip.

Tips & Tricks

Voor meer informatie kunt u eens naar de volgende pagina's kijken.

Ook kunt u altijd vragen stellen aan het documentatieteam.

2022-09-08 16:56