Vertalingsoverzicht: Dit artikel is een gelocaliseerde versie van How to write a wiki page. De laatste vertaling is gedateerd 04/12/2023. U kunt meehelpen om de vertaling te synchroniseren, als er wijzigingen zijn geweest in de originele versie. |
Andere talen Deutsch ; English ; Español ; Français ; Nederlands ; Português (Portugal) ; Türkçe ; português brasileiro ; |
In het kort: Deze pagina is bedoeld om mensen te helpen die Mageia Wiki-pagina's willen schrijven, bewerken of vertalen. U zult lid moeten worden van Mageia's documentatie-team |
Contents
Introductie
Mageia gebruikt deze wiki om aan drie belangrijke behoeften te voldoen:
- De Mageia-teams te helpen bij het coördineren van hun acties (rapporten, planningen, regels, takenlijsten, ...). Al dergelijke pagina's behoren tot de categorie 'Document'.
- Informatie te geven over de nieuwe uitgaven aan de eindgebruikers van Mageia - meestal Erratas en Release Notes voor elke uitgave. Deze pagina's behoren tot de categorie "Mageia development".
- Te zorgen voor extra documentatie voor de Mageia-eindgebruikers. Al dergelijke pagina's behoren tot de categorie "Documentatie".
Tot nu toe is de wiki voornamelijk in het Engels, maar hopelijk zal er binnenkort een meertalige versie klaar zijn (zie ook de nog niet geschreven sectie onderaan) .
Vereisten
Algemeen
Om pagina's in de Mageia-wiki te kunnen schrijven, wijzigen of vertalen, volgt u deze eenvoudige regels:
- Vraag hier uw inloggegevens aan here
- Sluit u aan bij ons Documentatie-team, ook wel "docteam" genaamd, Mageia docteam. Wees u ervan bewust dat de onderlinge voertaal Engels is.
- Abonneer u op de mailinglijst doc-discuss@ml.mageia.org en zeg wat u van plan bent te doen. Het is de gemakkelijkste manier om onze acties te coördineren, ideeën uit te wisselen en hulp te krijgen. U kunt ook het IRC-kanaal gebruiken: #mageia-doc op Libera.Chat.
- Wees voorzichtig met uw schrijfwijze/spelling/syntaxis. Aarzel niet om hulp of advies te vragen als dat nodig is.
- Probeer een mooie lay-out te maken. Screenshots moeten leesbaar zijn, maar niet te groot (600px is vaak voldoende)
- Lees en respecteer de Gedragscode van Mageia Code of conduct
Waar de wiki voor wordt gebruikt
- Samenwerkingsdocumentatie van goede kwaliteit over de Mageia-projecten:
- Het Mageia-project onder de aandacht brengen, de geest en doelstellingen ervan, de meegeleverde gereedschappen, teams en interne processen.
- Het aanbieden van duidelijke technische documentatie over de installatie-/migratieprocessen en de configuratie voor zowel kleine als brede computerinfrastructuren.
- Het documenteren van gereedschappen en programma's die met Mageia worden meegeleverd of die op Mageia-pc's kunnen worden geïnstalleerd.
- Uitleg van de gemeenschapsstructuur; om bijdragers de mogelijkheid te bieden gemakkelijk deel te nemen, op basis van hun interesses, capaciteiten en behoeften.
- Nuttige informatie en tips in artikelen.
- Voor zowel eindgebruikers als gevorderde gebruikers/beheerders.
- Voor desktop- en servertoepassingen.
- Voor de gemeenschap.
Waar de wiki niet voor mag worden gebruikt
- Dupliceren van informatie uit bestaande bronnen, zoals:
- Mageia officiële website (http://www.mageia.org/) en blog (http://blog.mageia.org).
- Een nieuws-/blogkanaal, bijvoorbeeld Mageia planet {http://planet.mageia.org/.
- Pagina's voor informatie over individuele groepen.
- Een plek voor het hosten van de pagina's van individuele projecten.
- Een FAQ-, vraag- en antwoordsite of een ander ondersteuningsplatform (zie de officiële website of speciale website voor dergelijke tools).
- Officiële online of offline documentatie .
Kenmerken van een wikipagina
Voordat u inlogt
Zo ziet een Engelstalige wikipagina er uit voordat u inlogt:
Sleutels:
- De wikipagina zelf.
- De discussiepagina, waar schrijvers hun werk uitleggen, ideeën delen en hun problemen oplossen.
- Normale leesmodus.
- Bekijk de bron-opmaaktaal die is gebruikt om een bepaalde pagina te maken.
- Een chronologische lijst van alle bewerkingen aan de wiki, en de optie om ze ongedaan te maken.
- U moet ingelogd zijn op de wiki om wijzigingen te kunnen aanbrengen.
- De wiki-zoekmachine.
- In deze gereedschapskist is "Speciale pagina's" (Special pages) handig, omdat het veel statistieken biedt en de afdeling "Categorieën" alle bestaande categorieën opsomt (zie hieronder below hoe u categorieën aan een pagina toevoegt).
Na het inloggen
Zodra u uw login en wachtwoord heeft ingevoerd, zijn er nieuwe gereedschappen beschikbaar(beeld is Engelstalig):
Nummering:
- Configuratie-opties. <login> ("cmoifp" in de schermafbeelding) is uw eigen gebruikerspagina, een plek waar u zich kunt voorstellen - of als plek om uw wikiwerk te testen. "Mijn lezing" (My talk) is de discussiepagina van uw eigen pagina. Met "Mijn voorkeuren" (My preferences) kunt u de instellingen aanpassen (bijvoorbeeld de taal van uw voorkeur). De overige vermeldingen spreken voor zich.
- Vervolgkeuzelijst met twee opties: "Verplaatsen" (Move) en "Kijken"/"Niet kijken" (Watch/Unwatch).
- In de Toolbox (gereedschapskist) gebruikt u de optie "Bestand uploaden" (Upload file) om bestanden (meestal afbeeldingen of schermafbeeldingen) naar de wiki te uploaden. Het wordt sterk aanbevolen te lezen wat deze pagina vertelt.
Hoofdsyntaxis
Algemeen
Hier vindt u de basisopdrachten om een pagina te starten en/of enkele kleine wijzigingen aan te brengen. Voor meer informatie, zie links hieronder. Google.com of DuckDuckGo.com zijn uw vrienden. We herinneren u eraan dat deze wiki mogelijk wordt gemaakt door MediaWiki.
Koppen
In onze wiki verschijnt de naam van de pagina automatisch als titel (kop) van de pagina (momenteel als "Wiki »Paginanaam"). Als u echter een (enigszins) andere kop wilt, beperk dan het gebruik van het paragraafniveau 1 "=" tot alleen de paginatitel. Gebruik in dat geval het tweede niveau "==" en lager voor uw pagina-inhoud in plaats van het eerste niveau "=" en lager. Het is aan u of u witruimte gebruikt tussen de tags en de inhoud. De wiki negeert de spaties bij het weergeven van de pagina.
Wat u schrijft | Wat u krijgt |
---|---|
= Kopniveau één = alleen voor de titel van de pagina | |
== Kopniveau twee == | |
=== Kopniveau drie === | |
==== Kopniveau vier ==== | |
===== Kopniveau vijf ===== | |
====== Kopniveau zes ====== |
Tekstopmaak
Note: Er is speciale opmaak voor opdrachten, menu's, pakketten, programma's en bestanden. |
Wat u schrijft | Wat u krijgt | |
---|---|---|
' 'cursief' ' | cursief | |
' ' 'vet' ' ' | vet | |
' ' ' ' 'cursief en vet' ' ' ' ' | cursief en vet | |
tags <s> en </s> om de tekst door te halen | ||
{{cmd|commando-naam}} | commando-naam
| |
{{menu|menu -> submenu}} | menu -> submenu
| |
{{file|bestandsnaam}} | bestandsnaam
| |
{{prog|programma-naam}} | programma-naam
| |
{{core}} | core repositories
| |
{{media}} | Update Testing Debug
| |
{{nonfree}} | nonfree repositories
| |
{{tainted}} | tainted repositories
| |
{{pre|tekst in presenteermodus}} |
| |
De regels |
De regels
| |
<span style="color: red;">tekst in het rood</span> | tekst in rood | |
<span style="color: blue;">tekst in blauw</span> | tekst in blauw | |
<span style="color: green;">tekst in het groen</span> | tekst in het groen | |
<span style="color: orange;">'''tekst vetgedrukt en oranje'''</span> | tekst vetgedrukt en oranje | |
<span style="color:#FF00FF;">tekst in andere kleur</span> | tekst in andere kleur | |
Voeg de juiste tag <br> in, om een regeleinde te forceren | Voeg de juiste tag in om een regeleinde te forceren |
Links en ankers
Wat u kunt doen | Wat u schrijft | Wat u krijgt |
---|---|---|
Link naar een Mageia-wikipagina (bijvoorbeeld: de wiki-welkomstpagina). (1) Zonder naam (2) Met de naam "Welkom" |
[[Main_Page]] [[Main_Page|Welcome]] |
[1] Welcome |
Link naar een URL (bijvoorbeeld: het officiële Franse Mageia-document). (1) Zonder naam (2) Met de naam "Documentatie" |
[http://www.mageia.org/fr/doc/] [http://www.mageia.org/fr/doc/ Documentation] |
[2] Documentation |
Voeg een anker met de naam "anchor1" toe aan het woord "text" | enkele bestaande <span id="anchor1">tekst</span> op een pagina | een bestaande tekst op een pagina |
Maak een link naar "anchor1" | klik [[#anchor1|here]] om naar anchor1 te gaan | klik here om naar anker1 te gaan |
Maak een link naar het anker "Hardware" op de wikipagina "Documentatie" | zie [[Documentation#Hardware|here]] | zie here |
Note: Elke titel is standaard een anker. De naam is de titel zelf. |
Lijsten
Wat u schrijft | Wat u krijgt |
---|---|
* ongeordende lijst, eerste regel |
|
# geordende lijst, eerste regel |
|
Tabellen
Er zijn veel opties in MediaWiki voor het tekenen van tabellen (zie this page voor meer informatie). Voor een eenvoudige tabel kunt u echter dit voorbeeld hieronder gebruiken.
- Vervang in de eerste regel de "1" na "border=" door de gewenste randdikte (in pixels), vervang "center" door "left" of "right" (zonder de ") en vervang "800" door uw gewenste breedte.
- Op de tweede regel kunt u optioneel kolomtitels opnemen, gescheiden door "!!".
- Voeg in de rest tabelcellen toe of verwijder deze (aangeduid als "|"). De "|-" wordt gebruikt om een daadwerkelijke rij te maken.
'Wat u schrijft (u kunt kopiëren/plakken gebruiken om zo'n tabel op uw pagina te maken):
{|{{UsualTable}} ! Eerste kolom!! Tweede kolom!!Derde kolom |- |kolom1 - cel1 |kolom2 - cel1 |kolom3 - cel1 |- |kolom1 - cel2 |kolom2 - cel2 |kolom3 - cel2 |- |kolom1 - cel3 |kolom2 - cel3 |kolom3 - cel3 |} |
Wat u krijgt:
Eerste kolom | Tweede kolom | Derde kolom |
---|---|---|
kolom1 - cel1 | kolom2 - cel1 | kolom3 - cel1 |
kolom1 - cel2 | kolom2 - cel2 | kolom3 - cel2 |
kolom1 - cel3 | kolom2 - cel3 | kolom3 - cel3 |
Afbeeldingen
Note: We raden aan dat schermafbeeldingen 800 pixels breed zijn. Een fotobijschrift is zeer wenselijk. |
Sjablonen
Sjablonen kunnen onder andere worden gebruikt om iets belangrijks te markeren. Met sjablonen kunt u dit op een snelle en consistente manier doen.
Sjabloonnaam | Sjabloon-presentatie. | Sjabloongebruik |
---|---|---|
Sjabloon die alleen wordt gebruikt om het belang van het gebruik van sjablonen te markeren. | ||
Template-nl | Deze sjabloon wordt alleen gebruikt voor het ontwerpen van nieuwe sjablonen. | Template:template
|
Sjablonen om de pagina's in andere talen te introduceren en te vertalen. | ||
Multi language banner-nl | Deze sjabloon wordt gebruikt om pagina's in andere talen te presenteren. | Template:Multi language banner
|
TranslationOverview-nl | Deze sjabloon wordt gebruikt om de status van de vertaling weer te geven. | Template:TranslationOverview
|
Sjablonen om veelgebruikte informatie onder de aandacht te brengen. | ||
Introduction-nl | Deze sjabloon geeft een korte samenvatting van de pagina. | Template:Introduction
|
Note-nl | Deze sjabloon geeft algemene informatie weer. | Template:Note
|
Code-nl | Opgemaakte <code> </code> tags. | Template:Code
|
Pre-nl | Opgemaakte <pre> </pre> tags. | Template:Pre
|
Installation-nl | Deze sjabloon gebruikt u om snel de installatieprocedure van een pakket te tonen. | Template:Installation
|
Format text-nl | Deze sjabloon heeft u nodig om tekst in een sjabloon op te maken. | Template:format text
|
Wp-nl | Deze sjabloon biedt een snelle toegang naar een Wikipedia-pagina. | Template:Wp
|
Deze sjabloon bevat informatie om de aandacht van de gebruiker te trekken over een bepaald onderwerp. | ||
Warning-nl | Deze sjabloon toont informatie om de aandacht van de gebruiker te trekken. | Template:Warning
|
Sjablonen om de gebruiker te waarschuwen voor een riskante actie. | ||
Dragons-nl | Deze sjabloon waarschuwt de gebruiker voor een groot risico. | Template:Dragons
|
Sjablonen om artikelen te markeren die in bewerking zijn. | ||
Draft-nl | Deze sjabloon geeft aan dat een pagina wordt bewerkt. | Template:Draft
|
Fixme-nl | Deze sjabloon signaleert een verzoek om meer informatie over een bepaalde alinea. | Template:Fixme
|
Sjablonen die positieve en negatieve informatie in een tabel markeren. | ||
Yes-nl | Deze sjabloon gebruikt u om het antwoord "Ja" of om positieve informatie te markeren in een tabel. | Template:Yes
|
No-nl | Deze sjabloon gebruikt u om het antwoord "Nee" of om negatieve informatie te markeren in een tabel | Template:No
|
Sjablonen voor het markeren van een commandoregel of commandoregels voor invoer en uitvoer. | ||
command-nl | Toon één enkele commandoregel. | Template:command
|
output-nl | Toont één commandoregel voor invoer en uitvoer. | Template:output
|
Deze sjablonen tonen een commando-regel, een bestand, of een folder in een artikel. | ||
cmd-nl | Deze sjabloon markeert een commando-regel in een alinea. | Template:Cmd
|
File-nl | Deze sjabloon markeert een bestandsnaam in een alinea. | Template:File
|
Folder-nl | Deze sjabloon markeert een foldernaam in een alinea. | Template:Folder
|
Prog-nl | Deze sjabloon staat u toe de programma's te markeren. | Template:Prog
|
Menu-nl | Deze sjabloon toont de hiërarchie binnen een menu. | Template:Menu
|
Sjablonen om verschillende pakketdepots te markeren. | ||
Core-nl | Deze sjabloon benadrukt het core pakketdepot. | Template:Core
|
Nonfree-nl | Deze sjabloon benadrukt het Nonfree pakketdepot. | Template:Nonfree
|
Tainted-nl | Deze sjabloon benadrukt het Tainted pakketdepot. | Template:Tainted
|
Deze sjablonen zijn transparant voor de gebruikers, maar technisch noodzakelijk. | ||
withbr | Deze sjabloon bevat code om een afgebroken regel te forceren. | Template:withbr
|
= | Deze sjabloon stelt u in staat het =-teken toe te voegen in de argumenten van een sjabloon. | Template:=
|
Error-nl | Deze sjabloon waarschuwt de gebruiker dat de ingevoerde parameters niet precies genoeg zijn. | Template:error
|
Stop | Deze sjabloon heeft u nodig om andere sjablonen te ontwerpen. | Template:Stop
|
Categorieën
De speciale tag (label) die u het meest gebruikt, is een "Category"-tag:
Syntaxis: [[Category:categorienaam]] Voorbeeld:[[Category:Documentatie-nl]] |
De wiki is zo geconfigureerd dat als u die tag ergens in uw opmaak plaatst, er automatisch een link naar de indexpagina Documentatiecategorie onderaan uw wikipagina verschijnt, ingesloten in een mooi kader. Uw pagina verschijnt ook automatisch op de indexpagina "Documentatie-nl". Geen extra werk van uw kant nodig. We gebruiken "Doc" voor interne Doc Team-documenten, "Documentatie-nl" voor algemene openbare documenten, en er zijn ook verschillende subcategorieën. Het is het beste om altijd "Doc" of "Documentatie-nl" te gebruiken en indien nodig andere categorieën toe te voegen.
Note: Hoewel het mogelijk is de "Category"-tags overal te plaatsen, is het beter ze helemaal bovenaan te plaatsen - ja, bovenaan het document, met een beetje witruimte voordat u begint met het schrijven van de pagina. Dit is belangrijk omdat het voorkomt dat de tags per ongeluk worden verwijderd wanneer de pagina-inhoud wordt bewerkt en het gemakkelijker wordt om ze te vinden als u een lange wikipagina hebt. |
Gebruik zoveel zinvolle categorieën als nodig zijn. Een lijst met beschikbare categorieën kunt u hier vinden.
Ondertekening
Het is eigenlijk niet nodig een pagina te ondertekenen, omdat deze informatie allemaal in de bewerkingsgeschiedenis staat. Maar soms wilt u misschien iets aftekenen. Dat is bijvoorbeeld erg handig op het tabblad Discussie. Het is ook een handige manier om naar uw eigen Gebruikerspagina te linken (waar u uw pagina's kunt testen voordat u ze op de wiki vrijgeeft).
Wat u schrijft | Wat u krijgt |
---|---|
~~~ | lebarhon |
~~~~ | lebarhon 17:32, 23 juni 2014 (UTC) |
~~~~~ | 17:32, 23 juni 2014 (UTC) |
Nuttige links
http://en.wikipedia.org/wiki/Help:Wiki_markup
http://www.mediawiki.org/wiki/Help:Tables/fr
http://www.mediawiki.org/wiki/Help:Images
http://en.wikipedia.org/wiki/Help:Tabel
http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style
Een pagina wijzigen
Algemeen
Het enige wat u hoeft te doen is op de link Bewerken bovenaan de pagina te klikken (waardoor de hele pagina in één keer bewerkbaar wordt) of op Bewerken rechts van elke sectietitel te klikken (om alleen dat gedeelte te bewerken). Deze link brengt u naar de bewerkingspagina en toont u de wikicode van de huidige pagina.
Linksboven op de pagina vindt u een menu voor basisopmaak.
Er verschijnt een helpbericht wanneer u de muis over een pictogram beweegt.
Onderaan de pagina vindt u een sectie Samenvatting waarin u commentaar kunt geven op uw wijzigingen. Vul deze ruimte in, zodat andere bijdragers gemakkelijker kunnen volgen wat er in de geschiedenis van de pagina is gedaan.
U kunt ook twee opties opgeven:
- Dit is een kleine bewerking (minor edit) om anderen te laten weten dat de wijzigingen die u heeft aangebracht klein zijn (eigenlijk alles wat de betekenis of het uiterlijk van een pagina niet fundamenteel verandert).
- Met Bekijk deze pagina (Watch this page) wordt u per e-mail op de hoogte gehouden van wijzigingen in de pagina (behalve kleine wijzigingen).
En tenslotte 3 knoppen:
- Pagina opslaan (Save page) om uw werk op te slaan (sneltoets: Alt-Shift-S)
- Toon voorbeeld (Show preview) om een idee te krijgen hoe de pagina eruit zal zien voordat u deze opslaat (Alt-Shift-P)
- Wijzigingen weergeven (Show changes) om duidelijk de verschillen te zien tussen de opgeslagen pagina en de pagina die u aan het bewerken bent.
Het wordt ten zeerste aanbevolen om altijd een voorbeeld van uw pagina te bekijken VOORDAT u de wijzigingen opslaat die u zojuist hebt aangebracht, om fouten te voorkomen.
Aarzel niet om wat opmerkingen toe te voegen op het tabblad "Discussie".
Een wijziging annuleren en terugkeren naar een vorige status
Dit heet reverting.
Hoe maakt u een pagina aan
1. Zorg ervoor dat de pagina, of een soortgelijke pagina die kan worden uitgebreid/aangevuld, niet al bestaat
2. Informeer de mailinglijst - misschien heeft iemand aan zo'n pagina gewerkt of is van plan te werken
3. Zoek een goede titel (zie de subsectie hieronder). Dit is belangrijk, omdat het hernoemen van pagina's niet makkelijk is.
4. Log in op de wiki
5. Schrijf uw titel in het zoekgebied (nummer 7, zie hier: screen-shot) en klik op "Zoeken" (Search), accepteer om de pagina te maken met een klik op de titel.
6. De nieuwe pagina wordt geopend in de bewerkingsmodus. Als u wilt, kunt u dit voorbeeld kopiëren/plakken op de nieuwe pagina:
{{draft}} [[Categorie:Documentatie]] == Inleiding == |
7. Voeg indien nodig andere categorieën toe en/of verwijder "Documentatie"
8. Zorg altijd voor een sectie 'presentatie'/'Introductie' om uit te leggen waar de pagina over gaat
9. Zie How to modify a page
Naamgeving van pagina's en secties
- Probeer nauwkeurige zoekwoorden in de zoekmachines te plaatsen.
- Probeer paginatitels niet langer te maken dan nodig is.
- Schrijf de titel met de gebruikelijke spaties tussen de woorden (laat de wiki de " _ " beheren).
- Nest geen pagina's in submappen, b.v. Onderwerp/Veelgestelde vragen.
- Gebruik naamgeving in natuurlijke taal (in tegenstelling tot nesten).
- Gebruik alleen hoofdletters voor het eerste woord in een titel of sectietitel: "Zo".
- Uitzonderingen: eigennamen en de titels/hoofdstukken van formele, volledige documentatiehandleidingen die worden geconverteerd naar XHTML/XML.
- Voorbeelden: "Doe mee aan het Foo-project"; "USB-opstartmedia instellen"; "Veelgestelde vragen over SELinux".
Hoe een pagina te vertalen
Bij gebrek aan een meertalige wiki
In dit geval is er alleen de naamruimte [en] en bevat deze alle talen.
- Waarschuw de mailinglijst om te melden dat u een wikipagina gaat vertalen
- Create a new page met een titel die bestaat uit de vertaalde originele titel gevolgd door -xy. (xy zijn de symbolische letters van de taal, voor Nederlands dus: -nl)
- Voorbeeld: De titel voor deze pagina, vertaald in het Nederlands, zou "Hoe schrijf ik een wiki-pagona-nl" moeten zijn. In het Frans: "Comment écrire une page wiki-fr" moeten zijn, in het Duits "Erstellen einer Wiki Seite-de".
- Voeg een link toe van elke bestaande vertaalde pagina naar uw nieuwe vertaalde pagina en omgekeerd. Deze verschillende taalnamen moeten in hun eigen taal worden geschreven. Dat betekent bijvoorbeeld: English, español, français, Deutsch, ... Voor Engelse, Spaanse, Franse en Duitse pagina's bestaat er een banner.
- Maak schermafbeeldingen die zo dicht mogelijk bij de originele liggen. Voeg indien nodig tekst toe,
- Voeg de taal category toe als deze al bestaat, zo niet, vraag het aan de mailinglijst, en ook aan de andere categorieën.
Zodra we een meertalige wiki hebben
Te schrijven na een dergelijke wiki-update lebarhon 8 juni 2014 (UTC) 12:59
Wikibeheer
Te schrijven door een wikimanager lebarhon 13:00, 8 juni 2014 (UTC)
- Hoe een pagina archiveren?
- Hoe foto's verwijderen?
- Hoe hernoem ik een pagina?
- Over het onderhouden van de wiki:
- tips over hoe u kunt zien of een pagina ergens anders vandaan is geïmporteerd en hoe u de oorspronkelijke licentie kunt controleren.
- wanneer u een pagina moet verplaatsen of verwijderen.
- wat te doen met alle "Concept"-pagina's.