|
|
| Line 101: |
Line 101: |
|
| |
|
| Als u er voor kiest niets samen te vatten, dient dit echt een uitzondering te zijn. Een reden kan zijn dat het slechts een kleine aanpassing betreft. In dat geval dient u het hokje ''Dit is een kleine bewerking'' aan te vinken alvorens de pagina op te slaan. | | Als u er voor kiest niets samen te vatten, dient dit echt een uitzondering te zijn. Een reden kan zijn dat het slechts een kleine aanpassing betreft. In dat geval dient u het hokje ''Dit is een kleine bewerking'' aan te vinken alvorens de pagina op te slaan. |
|
| |
| == Editing with Mediawiki ==
| |
|
| |
| {{admon/note|Indien u hulp nodig hebt met syntax dat hier niet vermeld wordt, kijk dan op [http://www.mediawiki.org/wiki/Help:Contents Mediawiki Help] (Engels).}}
| |
|
| |
| === Basis Syntax ===
| |
| {|
| |
| ! Wat u typt !! Hoe het er uit ziet
| |
| |-
| |
| | <pre><nowiki>'''vet'''</nowiki></pre> || '''vet'''
| |
| |-
| |
| | <pre><nowiki>''schuin''</nowiki></pre> || ''schuin''
| |
| |-
| |
| | <pre><nowiki>'''''vet en schuin'''''</nowiki></pre> || '''''vet en schuin'''''
| |
| |-
| |
| | <pre><nowiki><code>Monospace text</code></nowiki></pre> || <code>Monospace text</code>
| |
| |}
| |
|
| |
| === Opsomming ===
| |
| {|
| |
| ! Wat u typt !! Hoe het er uit ziet
| |
| |-
| |
| | <pre><nowiki>* Een opsommingsregel
| |
| * Nog een opsommingsregel
| |
| ** Oh nee hè, weer een opsommingsregel!</nowiki></pre> ||
| |
| * Een opsommingsregel
| |
| * Nog een opsommingsregel
| |
| ** Oh nee hè, weer een opsommingsregel!
| |
| |-
| |
| | <pre><nowiki># Een genummerde regel
| |
| # Nog een genummerde regel
| |
| ## Sub regel
| |
| ## Meer sub regels
| |
| # Derde genummerde regel</nowiki></pre> ||
| |
| # Een genummerde regel
| |
| # Nog een genummerde regel
| |
| ## Sub regel
| |
| ## Meer sub regels
| |
| # Derde genummerde regel
| |
| |-
| |
| | <pre><nowiki>* Een opsommingsregel...
| |
| *# Met een genummerde sub-regel
| |
| *# Meer genummerde sub-regels
| |
| * Terug naar de eerste niveau opsommingsregel
| |
| *# Meer genummerde regels
| |
| *#* met eigen opsommingsregel</nowiki></pre> ||
| |
| * Een opsommingsregel...
| |
| *# Met een genummerde sub-regel
| |
| *# Meer genummerde sub-regels
| |
| * Terug naar de eerste niveau opsommingsregel
| |
| *# Meer genummerde regels
| |
| *#* met eigen opsommingsregel
| |
| |}
| |
|
| |
| {{anchor|Linking}}
| |
|
| |
| === Links ===
| |
| {|
| |
| ! Wat u typt !! Hoe het er uit ziet
| |
| |-
| |
| | <pre><nowiki>Bezoek [[DocsProject]] om meer te weten te komen over
| |
| Fedora's documentatie.</nowiki></pre> || Bezoek [[DocsProject]] om meer te weten te komen over
| |
| Fedora's documentatie.
| |
| |-
| |
| | <pre><nowiki>Ons [[Websites|websites team]] biedt vele
| |
| individuen die Fedora kunnen helpen.</nowiki></pre> || Ons [[Websites|websites team]] biedt vele
| |
| individuen die Fedora kunnen helpen.
| |
| |-
| |
| | <pre><nowiki>Lees [[Artwork#Join]] over hoe je aan te sluiten bij het Art Team.</nowiki></pre> || Lees [[Artwork#Join]] over hoe je aan te sluiten bij het Art Team.
| |
| |-
| |
| | <pre><nowiki>[[The weather in London]] is een
| |
| pagina die nog niet bestaat.</nowiki></pre> || [[The weather in London]] is een pagina die nog niet bestaat.
| |
| |-
| |
| | <pre><nowiki>http://fedoraproject.org/</nowiki></pre> || http://fedoraproject.org/
| |
| |-
| |
| | <pre><nowiki>Hier zijn enkele sites:
| |
| [http://www.deviantart.com]
| |
| [http://www.flickr.com]</nowiki></pre> || Hier zijn enkele sites: [http://www.deviantart.com] [http://www.flickr.com]
| |
| |-
| |
| | <pre><nowiki>[http://fedoraproject.org Onze home page]
| |
| staat vol met interessante informatie.</nowiki></pre> || [http://fedoraproject.org Onze home page] staat vol met interessante informatie.
| |
| |-
| |
| | <pre><nowiki>Gebruik een ':' in de link om te linken
| |
| naar een [[:Image:Growth_wide.jpg|afbeelding]].</nowiki></pre> || Gebruik een ':' in de link om te linken
| |
| naar een [[:Image:Growth_wide.jpg|afbeelding]].
| |
| |-
| |
| | <pre><nowiki>De [[:Category:Documentation]] somt alle
| |
| documentatie voor de eindgebruiker op.</nowiki></pre> || De [[:Category:Documentation]] somt alle
| |
| documentatie voor de eindgebruiker op.
| |
| |-
| |
| | <pre><nowiki>De [[Category:Documentation]] link plaatst
| |
| deze pagina in de opgesomde categorie; de link
| |
| verschijnt automatisch onderaan de pagina en niet binnenin de pagina.</nowiki></pre> || De <nowiki>[[Category:Documentation]]</nowiki> link plaatst
| |
| deze pagina in de opgesomde categorie; de link
| |
| verschijnt automatisch onderaan de pagina en niet binnenin de pagina.
| |
| |}
| |
|
| |
| {{admon/note|Er zijn twee manieren om de Category links te gebruiken| Vergewis u ervan dat de ':' '''voor''' het woord 'Category' staat indien de bedoeling is dat ''verwezen'' moet worden naar een categorie pagina. Laat de ':' weg indien de pagina geacht dient te worden bij die categorie ''te behoren''. Bekijk bovenstaande voorbeelden goed.}}
| |
|
| |
| === Tabellen ===
| |
| Tabellen dienen spaarzaam te worden gebruikt en uitsluitend indien noodzakelijk.
| |
|
| |
| Voor meer gevorderde tabellengebruik, lees [http://www.mediawiki.org/wiki/Help:Tables Mediawiki.org's page on tables] (Engels).
| |
|
| |
| {|
| |
| ! Wat u wilt !! Hoe u het krijgt
| |
| |-
| |
| | Begin een tabel || <pre>{|</pre>
| |
| |-
| |
| | Tabel Kop || <pre>! kolom 1 !! Kolom 2 !! Kolom 3</pre>
| |
| |-
| |
| | Nieuwe rij || <pre>|-</pre>
| |
| |-
| |
| | Tabel rij || <pre>| Cel 1 || Cel 2 || Cel 3</pre>
| |
| |-
| |
| | Eindig een tabel || <pre>|}</pre>
| |
| |}
| |
|
| |
| === IRC Logs ===
| |
| IRC logs kunnen hetzij worden ingesloten met <code><nowiki><pre></nowiki></code> tags, hetzij converteerd in MediaWiki pipe-tables met [http://mg.pov.lt/irclog2html/ irclog2html] en [http://ianweller.fedorapeople.org/irclog2html/ Ian's MediaWiki patch for irclog2html].
| |
|
| |
| {{Anchor|Structure_of_a_Wiki_Page}}
| |
|
| |
| == Structuur van een Wiki Pagina ==
| |
|
| |
| Deze sectie beschrijft de meest voorkomende structuur van een wiki pagina. Volg deze richtlijnen voor elke wiki pagina. Er zijn aanvullende regels die gebruikt worden voor officiele Fedora documentatie; behandeld in [[DocsProject/WritingUsingTheWiki]] ; die regels zijn alleen noodzakelijk voor inhoud waarbij bij het schrijven de procedures van de [[DocsProject| Fedora Documentation Project]] moeten worden gevolgd. Pagina's als sjablonen en die met standaard inhoud, bedoeld om in andere pagina's te worden opgenomen, kunnen een andere structuur hebben.
| |
|
| |
| {{admon/note|Kop 1 (h1) wordt afgeraden in opmaak|De kop 1 wordt gedefinieerd door de pagina titel. Bij het maken van nieuwe of bij het verplaatsen van pagina's, her-nest of herstructureer de pagina dusdanig dat er alleen nog maar kop 2 en lager in voorkomen.}}
| |
|
| |
| * De titel van een pagina is een kop van het eerste niveau. Deze wordt automagisch gecreëerd via de pagina titel.
| |
| * Secties ontstaan door isgelijktekens in paren:
| |
| <pre>
| |
| == Kop 2 ==
| |
| === Kop 3 ===
| |
| ==== Kop 4 ====
| |
| ===== En doe dit niet, 5 niveaus nesting betekent dat je een nieuwe pagina of drie nodig hebt=====
| |
| </pre>
| |
| * Een inhoudsopgave wordt automatisch gegenereerd op het moment dat de pagina groot genoeg geworden is.
| |
| * Ankers naar secties worden automatisch gegenereerd, met specifieke symbolen op de plek van leestekens en spaties.
| |
| <pre>
| |
| Deze pagina ==> Deze_pagina
| |
| Dit, dat, en de andere pagina ==> Dit%2C_dat%2C_en_de_andere_pagina
| |
| </pre>
| |
|
| |
|
| |
| {{admon/tip|U kunt .2C gebruiken in plaats van %2C voor ankers|De vervanging van '.' voor '%' werkt voor ankers aan een specifieke sectie.}}
| |
|
| |
| == Snelle Tips ==
| |
|
| |
| Dit was de basis van wat u dient te weten als u deze Wiki wilt bewerken.
| |
|
| |
| {{Admon/note | Voor meer informatie |betreffende het optekenen van documentatie op de Wiki leze men [[DocsProject/WritingUsingTheWiki| Writing Wiki Documentation]] (in Engels).}}
| |
|
| |
|
| |
| === Leer aan de hand van voorbeelden ===
| |
|
| |
| Eén van de betere manieren om te leren hoe je de wiki kan bewerken is het bekijken van code van bestaande pagina's. Dat is heel eenvoudig te doen:
| |
|
| |
| # Vind een pagina waarvan u de bron zou willen zien
| |
| # Klik boven aan pagina op de tab '''bewerken''' als u ingelogd bent of de tab '''view source''' indien u dat niet bent.
| |
|
| |
| De wiki toont u de brontekst van die pagina. Dit is erg waardevol als u sommige slimme truukjes van eerdere wiki bewerkers wilt leren en overnemen. Deze truukjes zijn echt waardevol omdat zij u in staat stellen niet vaak voorkomende, interessante, krachtige dingen te doen waarvan u niet dacht dat die mogelijk waren. Bekijkt u bijvoorbeeld eens de [[nl_NL/Hoofdpagina| Hoofdpagina]] van de Fedora wiki (liefst niets veranderen).
| |
|
| |
| {{Anchor|Admonitions}}
| |
|
| |
| === Aantekeningen, Tips, en Andere Admonitions ===
| |
|
| |
| Deze staan allen samen bekend onder de naam 'admonitions', en [http://docs.fedoraproject.org/documentation-guide/en_US/sn-xml-admon.html worden gebruikt in DocBook]. Om een paragraaf het uiterlijk te geven van een admonition, gebruikt u de speciale admonition sjabloon. Een korte titel en een wat langere beschrijving als paragraaf verdient de voorkeur.
| |
|
| |
| {|
| |
| ! '''Wat u typt''' !! '''Wat u ziet'''
| |
| |-
| |
| ||<pre>
| |
| {{admon/note|Een titel|Hier staat meer informatie
| |
| over deze tip, met informatie dat meer inzicht
| |
| geeft in de informatieve titel van de initiële
| |
| inleiding.}}
| |
| </pre>
| |
| ||{{admon/note|Een titel| Hier staat meer informatie over deze tip, met informatie dat meer inzicht geeft in de informatieve titel van de initiële inleiding.}}
| |
| |}
| |
|
| |
| Dit zijn de standaard types admonition:
| |
|
| |
| {|
| |
| ! '''Wat u typt''' !! '''Wat u ziet'''
| |
| |-
| |
| ||<pre><nowiki>{{admon/note|Dit is een aantekening|Informatieve
| |
| paragraaf welke vertelt wat er aan de hand is.}}</nowiki></pre>||{{admon/note|Dit is een aantekening|Informatieve paragraaf
| |
| welke vertelt wat er aan de hand is.}}
| |
| |-
| |
| ||<pre><nowiki>{{admon/tip|Dit is een tip|Informatieve paragraaf
| |
| welke vertelt hoe met een bepaalde situatie
| |
| omgegaan kan worden.}}</nowiki></pre>||{{admon/tip|Dit is een tip | Informatieve paragraaf welke vertelt hoe met een bepaalde situatie omgegaan kan worden.}}
| |
| |-
| |
| ||<pre><nowiki>{{admon/important|Dit is belangrijk|Informatieve
| |
| paragraaf met dringend advies.}}</nowiki></pre>||{{admon/important|Dit is belangrijk|
| |
| Informatieve paragraaf met dringend advies}}
| |
| |-
| |
| ||<pre><nowiki>{{admon/caution|Dit betekent opgepast|Informatieve
| |
| paragraaf welke wijst op gevaar of risico.}}</nowiki></pre>||{{admon/caution|Dit betekent opgepast|Informatieve
| |
| paragraaf welke wijst op gevaar of risico.}}
| |
| |-
| |
| ||<pre><nowiki>{{admon/warning|Dit is een waarschuwing|Informatieve
| |
| paragraaf met duidelijke waarschuwing.}}</nowiki></pre>||{{admon/warning|Dit is een waarschuwing|Informatieve
| |
| paragraaf met duidelijke waarschuwing.}}
| |
| |}
| |
|
| |
|
| |
|
| |
| ==== Admonitions Voorbeelden ====
| |
|
| |
| Voorbeelden van context waarbinnen deze admonitions worden gebruikt:
| |
|
| |
| {{admon/note|Afgronden kunnen heel diep zijn|[http://en.wikipedia.org/wiki/Cliff Wikipedia kan dit bevestigen].}}
| |
| {{admon/tip|Niet te dicht bij de rand van de afgrond komen is een manier om er niet in te vallen|Voor meer informatie, lees de <code>HoeOverleefIkWandelenMetMijnVrouw(1)</code> man pagina.}}
| |
| {{admon/important|Houd uw kinderen weg bij de rand van de afgrond|Kinderen rennen van hot naar her en hebben daardoor de neiging in afgronden te vallen. U doet er goed aan hun hand vast te houden. Of juist niet.}}
| |
| {{admon/caution|U komt steeds dichter bij de rand van de afgrond|Zoals eerder vermeld kunnen afgronden heel diep zijn. Er in vallen wordt afgeraden.}}
| |
| {{admon/warning|U staat op het punt in de afgrond te vallen|Maak u zo snel mogelijk in de juiste richting uit de voeten. Even denken voordat u gaat rennen dus.}}
| |
|
| |
| Lees de Fedora Documentation Guide voor beschrijvingen van admonition types: http://docs.fedoraproject.org/documentation-guide/en_US/sn-xml-admon.html
| |
|
| |
| {{Anchor|MarkingTechnicalTerms}}
| |
| {{Anchor|Marking_Technical_Terms}}
| |
|
| |
| === Opmaak van Technische Termen ===
| |
|
| |
| Gebruik de ''code'' (<nowiki><code></code></nowiki>) opmaak om namen van applicaties, bestanden, mappen, softwarepaketten, gebruikersaccounts en andere woorden met een speciale technische betekenis te markeren. Dit zal deze begrippen laten zien in <code>monospace</code>.
| |
|
| |
| Gebruik twee enkele quotes <code>(<nowiki>''[name of menu]''</nowiki>)</code> om namen van menu items en andere elementen van een grafische interface te markeren. Dit vertoont de markeerde woorden in ''italic''.
| |
|
| |
| {| border="1" align="center"
| |
| ! Term !! Opmaak !! Opmaak voorbeeld
| |
| |-
| |
| | Namen van GUI applicaties || <pre> '''vet gedrukt''' </pre> || '''Firefox'''
| |
| |-
| |
| | Bestanden, mappen || <pre> <code>inline code tags</code> </pre> || <code>/usr/bin/firefox</code>
| |
| |-
| |
| | Software pakketten || <pre> <code>pakket naam</code> </pre> || <code>firefox-1.2.3</code>
| |
| |-
| |
| | Gebruikersaccounts || <pre> <code>gebruikersnaam</code> </pre> || <code>gebruikersnaam</code>
| |
| |-
| |
| | Andere woorden met een specifieke technische betekenis || <pre> <code>technische term</code> </pre> || ... de klasse <code>org.fedora.someJava.classname</code> ...
| |
| |-
| |
| | Grafische menus en menu-onderdelen || <pre> ''Menu naam'' </pre> || ''Applicaties > Internet > Firefox Web Browser''
| |
| |-
| |
| | Andere GUI of WebUI interface elementen || <pre> ''twee single-ticks'' </pre> || ... klik de ''Verzend'' knop ...
| |
| |-
| |
| | Inline commando's en daemons || <pre> <code>commando -optie</code> <code>daemon</code></pre> || ... draai <code>ps -ef | grep httpd</code> om de PIDs van lopende <code>httpd</code> processen te zien.
| |
| |-
| |
| | '''Stukken''' code, configuratie bestanden, etc. || <pre> <pre>witruimte behouden< /pre> </pre> || <pre>
| |
| witruimte
| |
| is hier
| |
| behouden
| |
| </pre>
| |
| |-
| |
| | '''Inline''' stukken van code, configuratie bestanden, etc. || <pre> <code> set() /path/to/org/dev108/classname </code> </pre> || ... Pas vervolgens de variabelen voor <code>set()</code> in <code>/path/to/org/dev108/classname</code> aan ...
| |
| |-
| |
| | Eerste term, glossy term || <pre> ''term'' </pre> || ... '''Firefox''' is een voorbeeld van een ''grafische gebruikersinterface'' ofwel ''GGI''.
| |
| |-
| |
| | Toetsaanslagen || <pre> '''[Toets]''' </pre> || Druk op '''[Enter]''' ...
| |
| |}
| |
|
| |
| Mooi voorbeeld:
| |
|
| |
| <pre>
| |
| Het <code>thunderbird</code> pakket installeert de '''Mozilla Thunderbird'''
| |
| e-mail applicatie. Om '''Thunderbird''' te starten, selecteer:
| |
| ''Applicatie > Internet > Thunderbird Email''.
| |
| </pre>
| |
|
| |
| geeft als resultaat:
| |
|
| |
| Het <code>thunderbird</code> pakket installeert de '''Mozilla Thunderbird''' e-mail applicatie. Om '''Thunderbird''' te starten, selecteer: ''Applicatie > Internet > Thunderbird Email''.
| |
|
| |
| {{Anchor|Writing_Example_Commands}}
| |
|
| |
| === Notatie van Voorbeelden van Computeropdrachten ===
| |
|
| |
| Voorbeelden van opdrachten zijn één of meerdere opdrachten die los van de tekst waarin zij worden uitgelegd worden opgeschreven. Gebruik geen prompt-symbolen of andere informatie betreffende machinenaam, gebruiker, mappen etc (hetgeen informatie is uit de $PS1 variabelen).
| |
|
| |
| Omvat elke opdracht met <code><nowiki><pre></pre></nowiki></code> tags:
| |
|
| |
| <pre>
| |
| <pre>
| |
| su -c "yum install geweldige-applicatie"
| |
| </pre>
| |
|
| |
| Voer het <code>root</code>-wachtwoord in wanneer erom wordt gevraagd.
| |
| </pre>
| |
|
| |
| Wat oplevert:
| |
|
| |
| <pre>
| |
| su -c "yum install geweldige-applicatie"
| |
| </pre>
| |
|
| |
| Voer het <code>root</code>-wachtwoord in wanneer erom wordt gevraagd.
| |
|
| |
|
| |
| {{admon/note|Opdracht Voorbeelden en Root|Veel opdrachten vereisen <code>root</code> privileges. De lezer dient niet op zijn systeem te zijn ingelogd als <code>root</code>, daarom dient u ofwel <code>su -c</code> ofwel <code>su -</code> aan te geven wanneer er sprake is van opdrachten die <code>root</code> privileges vereisen.}}
| |
|
| |
| Indien de opdracht elementen in zich heeft die moeten worden gequote, dient nesting te gebeuren met enkele aanhalingstekens omgeven door één paar dubbele aanhalingstekens, dus zo:
| |
|
| |
| <pre>su -c "command -o 'Enige tekst' -file 'Hier ook wat tekst' foo/bar"
| |
| </pre>
| |
|
| |
| If you need to have a series of commands or <code>su -c</code> is not responding as expected, have the user switch to <code>root</code> and warn the user to return to a normal user shell afterward.
| |
|
| |
| Indien een aantal opdrachten achter elkaar als root gegeven dient te worden of <code>su -c</code> reageert niet als verwacht, zorg dan dat de gebruiker wisselt naar <code>root</code> en '''waarschuw de gebruiker naar de gebruikersshell terug te keren als hij klaar is'''. Terugkeren kan door <code>exit</code> te typen of op '''[Ctrl]''' + '''[d]''' te drukken.
| |
|
| |
| <pre>su -
| |
| Wachtwoord:
| |
| service food stop
| |
| cp /etc/foo.d/foo.conf /etc/foo.d/foo.conf.backup
| |
| vi /etc/foo.d/foo.conf
| |
| food --test-config
| |
| ...
| |
| service food start
| |
| exit
| |
| </pre>
| |
|
| |
| ==== Voorbeeld van opdracht-output ====
| |
|
| |
| Wanneer het voorbeeld een opdracht toont tezamen met de output naar het scherm, mag u een opdrachtprompt laten zien ter onderscheiding van opdracht en output.
| |
|
| |
| <pre>
| |
| $ su -c "ls -l /root"
| |
| Wachtwoord:
| |
| total 148
| |
| -rw------- 1 root root 1961 2007-09-21 02:46 anaconda-ks.cfg
| |
| -rw-r--r-- 1 root root 46725 2007-09-21 02:46 install.log
| |
| -rw-r--r-- 1 root root 6079 2007-09-21 02:42 install.log.syslog
| |
| -rw-r--r-- 1 root root 3699 2008-07-28 17:24 scsrun.log
| |
| -rw-r--r-- 1 root root 45038 2008-01-10 10:21 upgrade.log
| |
| -rw-r--r-- 1 root root 1317 2008-01-10 10:20 upgrade.log.syslog
| |
| </pre>
| |
|
| |
| === Probeer het zelf eens uit ===
| |
| Probeer nieuwe dingen in de [[WikiSandBox| Fedora Wiki Sandbox]] . Het is ook een goede plek om kleine voorbeelden te aanschouwen.
| |
|
| |
| === Nieuwe pagina's maken in de Wiki ===
| |
|
| |
| De Fedora Project Wiki is uitgebreid, dus is het noodzakelijk een strakke hiërarchie en organisatie aan te houden. De beste manier om hiervan kennis te nemen is [[Help:Subpages]] en [[Help:Categories]] te lezen, en daarna de bestaande structuur van de wiki te bekijken.
| |
|
| |
| Overcomplete namen (zoals <code>Foo/FooBar/FooBarGrue</code>) moeten worden vermeden. Bedenk goed dat 'Fedora' in de naam van de pagina opnemen niet nodig is. Ook hebben grote Fedora projecten niet de aanduiding 'Project' in hun paginanaam nodig. Het Fedora Websites Project heeft bijvoorbeeld als paginanaam 'Websites', en niet 'FedoraWebsitesProject'.
| |
|
| |
| Over het algemeen moeten pagina's worden gegroepeerd als subpagina's van de projecten of programma's waar zij een deel van zijn. Categorieën zullen over het algemeen worden gecreëerd voor verschillende projecten en programma's, en dienen mondjesmaat te worden aangemaakt. De meeste pagina's die u gaat aanmaken zullen deel moeten maken van een categorie, en vele dienen ook de toepasselijke tags te hebben. Indien u overweegt een nieuwe categorie of tag te creëren, overleg dan eerst met het [[Websites]] team.
| |
|
| |
| Indien u vragen hebt, stel deze gerust aan het [[Websites]] team.
| |
|
| |
| === Belangrijke Pagina's ===
| |
|
| |
| Kernpagina's, zoals de Hoofdpagina, dienen slechts spaarzaam te worden bewerkt. Veranderingen aan zulke pagina's dienen over het algemeen worden besproken op de mailing-list of op IRC voordat zij worden toegepast. Sommige delen van de wiki hebben afwijkende permissies. De [[DocsProject]] heeft bijvoorbeeld een sectie waar pagina's moeilijker kunnen worden aangemaakt of bewerkt dan de rest van de wiki. Indien u op zulke pagina's toestemming om te bewerken wilt verkrijgen, dient u bijkomende stappen te nemen. Over het algemeen staan instructies daartoe op diezelfde pagina's.
| |
|
| |
| == Hulp Krijgen ==
| |
|
| |
| Wanneer u maar een vraag hebt over het bewerken van de Fedora Project wiki, of indien u hulp nodig hebt, neem dan gerust contact op met het [[Websites]] team. Zij hebben een IRC channel (#fedora-websites op freenode) en een mailing list ([http://www.redhat.com/mailman/listinfo/fedora-websites-list fedora-websites-list])
| |
|
| |
| Indien u graag veel bewerkingen op de wiki wilt doen, overweeg dan u [[Websites/Join|aan te sluiten bij het Websites team]]. U bent van harte welkom. Veel plezier!
| |
|
| |
|
| [[Category:Documentation]] | | [[Category:Documentation]] |
Richtlijnen en Wiki Etiquette
Er zijn een aantal eenvoudige punten die u moet aanhouden wanneer u veranderingen aanbrengt aan de wiki. Hierna staan een aantal voorbeelden. In het algemeen, wees beleefd en gebruik uw gezond verstand. Deze richtlijnen negeren en problemen veroorzaken zijn zeer goede manieren om uw edit-priveleges in te laten trekken. Indien u vragen hebt, kunt u die stellen op #fedora-websites op freenode.
Introduceer uzelf
Voordat u een pagina gaat bewerken, weest u dan zo vriendelijk u voor te stellen door informatie over u toe te voegen op uw wiki pagina. Nadat u zich hebt ingelogd met uw FAS-naam en uw FAS-wachtwoord verkrijgt u automagisch ;) een persoonlijke pagina op de lokatie http://fedoraproject.org/wiki/User:<username>, waarbij <username> is vervangen door uw FAS-naam (uw Fedora Account System account naam). Deze usernaam kunt u vervolgens linken naar een nieuwe pagina met uw uitgeschreven voornaam aan elkaar geschreven met uw volle achternaam (bijvoorbeeld JanJansen) als titel. Op deze laatste pagina stelt u zich voor. U kunt als u bent ingelogd snel bij uw FAS-wiki-pagina komen door boveraan rechts van het midden van elke wiki pagina op uw usernaam te klikken.
Voor voorbeelden kijk eens naar JeroenVanMeeuwen, BartDeSoete, GeertWarrink of RichardvanderLuit.
Oude gebruikerspagina's van MoinWij verzoeken u vriendelijk doch dringend (oude) FirstnameLastname style pagina's van Moin om te zetten naar het (nieuwe) MediaWiki formaat.
Indien u zich net hebt aangesloten bij het Fedora Project en hebt gelezen dat u de (oude) FirstnameLastname formaat dient te gebruiken,
informeer dan alstublieft Ian waar u dit hebt gelezen, opdat het kan worden aangepast.
Vermeld in ieder geval uw email-adres en, indien u veel op irc zit, uw IRC nick en kanalen waar u vaak te vinden bent.
Houdt de pagina's die u maakt of bewerkt altijd in de gaten
Het is belangrijk dat u de veranderingen op de pagina's die u heeft gemaakt of gecreëerd goed in de gaten houdt, opdat u de inhoud met anderen die aan de wiki werken kunt coördineren. Wiki bewerkers voegen vaak aantekeningen toe om informatie uit te wisselen als een methode van samenwerking, en dat helpt goed om dergelijke veranderingen in de gaten te houden.
U kunt de Volgen link in de tab bar rechts boven in een wiki pagina vinden indien u bent ingelogd.
Wees stoutmoedig
Verander gerust pagina's, wees niet bang. Wiki veranderingen worden gevolgd en teruggedraaid indien nodig. Dit betekent echter niet dat u roekeloos kunt zijn, zeker niet indien u grote veranderingen maakt in kerndocumenten.
Voor meer informatie over stoutmoedigheid (being bold in engels), neem een engels kijkje op be bold editing guideline on Wikipedia.
Vermijd onnodige veranderingen aan pagina's die rechtenkwesties aansnijden
Dat soort pagina's zijn zeer zorgvuldig samengesteld, en de woorden erin zijn stuk voor stuk afgewogen. Indien u deze pagina's toch wilt veranderen moet u om een review van een ander vragen alvorens de veranderingen door te voeren. U kunt in dat geval het best de Fedora Advisory Board benaderen voor hulp in deze.
Geef geen details omtrent verboden zaken
Voeg geen enkele informatie toe strijdig met de wet. Onthoud dat het Fedora Project een entiteit is in de Verenigde Staten, en daarom onderworpen aan haar wetten. Vermijd linken naar of toevoegen van informatie over niet vrije open source software of software dat wettelijk beschermd is. Indien u denkt dat u zich in een uitzonderlijke positie bevindt, breng dat dan onder de aandacht van het Websites team voor discussie. Zie ook de ForbiddenItems pagina's voor voorbeelden van gevallen die moeten worden vermeden.
Voor vragen hieromtrent wendt u zich to het Websites team. Indien noodzakelijk, kunnen zij een officieel standpunt achterhalen.
Wees voorzichtig wanneer u belangrijke gidsen of belangrijke pagina's aanpast
Grote en belangrijke gidsen, zoals de Packaging Guidelines, worden over het algemeen onderhouden door een bepaald persoon of een bepaald groepje. Het beste kunt u met hen contact opnemen indien u vindt dat daarin iets moet worden aangepast.
Belangrijke pagina's, zoals de FedoraMain of Download pagina's, zijn pagina's die vaak door menig bezoeker als eerste worden gezien.
Veranderingen aan dergelijke pagina's moeten in het algemeen aan ervaren bewerkers worden overgelaten. Indien u vindt dat er iets aan dit soort pagina's moet worden aangepast, neem dan daarover contact op met het Websites team om dat te bespreken.
Verander geen pagina's puur om het veranderen zelf
Zinloze veranderingen dienen te worden vermeden. Een verandering maken om slechts in het edit-log te komen is onacceptabel. Er zijn genoeg pagina's (de meeste om precies te zijn) met echte corrigeerbare fouten. In plaats van zinloze veranderingen te maken, zoals het weghalen of toevoegen van spatieruimte of links veranderen als fedoraproject.org in www.fedoraproject.org (de eerste vorm verdient de voorkeur), kunt u beter spel- of taalfouten zoeken en corrigeren. Denk er ook aan "Dit is een kleine bewerking" onder aan de editpagina aan te vinken indien u een kleine fout corrigeert.
Vermijd hernoemen van pagina's of verplaatsen van inhoud zonder overleg
Naar alle Wiki pagina's wordt over het algemeen wel verwezen door of naar gelinkt van diverse andere lokaties. Het is daarom belangrijk dat u goed met de juiste groepen afstemt alvorens u pagina-inhoud naar elders verplaatst of bestaande pagina's hernoemt. Het verdient de aanbeveling dit slechts te doen als het echt niet anders kan. Indien u verplaatsing van een bepaald item wenst, dient u dit te bespreken met het Websites team.
Verwijderen van pagina's
Wiki pagina's die niet langer nodig zijn dienen te worden gemerkt voor verwijdering door {{Delete|Reden in het Engels}} aan het begin van de pagina toe te voegen. Dit geeft de Wiki Administrators de mogelijkheid zich te verzekeren dat er geen belangrijke of te archiveren inhoud verloren gaat.
Volg de idealen die Fedora hoog in het vaandel heeft staan
Bijvoorbeeld, probeer desktop-neutraal te zijn en gebruikersvriendelijk, helemaal voor niet-technische gebruikers waarvoor Linux en Fedora nieuw zijn. Gebruikers kunnen gebruik maken van GNOME, KDE, de console of een andere omgeving. Probeer dat voor ogen te houden wanneer u instrukties schrijft. Verwittig u ervan dat Fedora's toewijding voor gratis en open bron technologie eveneens netjes wordt uitgedragen.
Teken uw bijlagen
Wanneer u een bestand aan een wiki pagina toevoegt, dient u met uw GPG-sleutel een losse handtekening aan te maken. Sommige bestandsformaten, zoals RPM-paketten, ondersteunen GPG-sleutels. In zo'n geval hoeft u geen losse handtekening te maken, een handtekening in het bestand zelf is dan voldoende. Een losse handtekening kan worden toegevoegd aan de pagina tezamen met het oorspronkelijke bestand, of kan in de pagina zelf worden opgenomen.
GPG-handtekeningen staan anderen die uw bestand willen downloaden in staat te verifieren dat het inderdaad van u afkomstig is en niet tussentijds is veranderd of verminkt. GPG-handtekeningen schenden op geen enkele manier uw privacy, zij stellen slechts anderen in staat vertrouwen te hebben in de afkomst van het bestand.
Afbeeldingen en eenvoudige documenten kunnen gerust zonder handtekening, maar het kan nooit kwaad indien men kan zien dat u inderdaad de auteur ervan bent.
Indien u nog geen GPG-sleutel hebt of er meer van wilt weten, ga dan naar de Cryptography pagina.
Kijk uw werk na op fouten
Of u nu een volleerd schrijver bent, of niet, nodig iemand uit om na te lezen wat u hebt geschreven. Goedgeschreven documenten zijn belangrijk voor Fedora's imago. Zelfs de beste schrijvers zien typefouten en andere missers over het hoofd. Neem de tijd om uw veranderingen na te lezen om die vervelende kleine foutjes eruit te halen. Gebruik de Bewerking ter controle bekijken knop onderaan de edit-pagina om uw tekst te controleren. Sla pas na controle de pagina op.
Fedora is een gemeenschap
Wanneer u dingen schrijft, voor de wiki of elders, onthoud dan dat Fedora een gemeenschap is. Wij treden op als één groep, op weg naar gemeenschappelijke doelen. Wij hebben er geen behoefte aan een groep of klasse daarbinnen te onderscheiden van een andere. Er is bijvoorbeeld geen noodzaak onderscheid te maken tussen medewerkers die in dienst zijn van Red Hat en zij die dat niet zijn. Alle medewerkers zijn onderdeel van dezelfde gemeenschap. Er zullen gevallen zijn waarbij classificatie nu eenmaal nodig is, maar het kan en zal zoveel mogelijk worden vermeden.
Als u iets niet weet, aarzel dan niet het te vragen
Andere leden van de gemeenschap zullen u graag helpen. Het #fedora-websites channel op freenode is de perfecte plaats om de wiki of andere Fedora websites te bespreken.
Houd uw pagina's in de gaten, en andere pagina's ook
Twee facetten maken een wiki succesvol als middel om samen te werken aan een open inhoud. Ten eerste dat u de inhoud van pagina's waarvoor u verantwoordelijk bent in de gaten houdt, opdat de bedoeling van de pagina gewaarborgd blijft. Ten tweede dat u in staat bent in de gaten te houden dat andere pagina's ontwikkelen, groeien en nu en dan uw hulp nodig hebben.
Om welke pagina op de wiki dan ook in de gaten te houden klikt u -na inloggen- de volgen tab boven aan elke pagina aan. Het moet dan veranderen in niet volgen. Als een pagina niet volgen boven aan heeft, bent u deze pagina aan het volgen. U kunt niet volgen aanklikken om de pagina niet meer te volgen. De tab verandert dan weer in volgen.
Om emails te ontvangen bij elke verandering, ga naar mijn voorkeuren (bovenaan de pagina bij uw naam) en vergewis u er van dat de juiste opties zijn aangevinkt bij de tab gebruikersprofiel, onder E-mail.
Volglijst (Special:Watchlist) Gebruiken
Special:Watchlist (beschikbaar via volglijst boven aan elke pagina wanneer u bent ingelogd) toont de pagina's die u op dat moment aan het volgen bent. Voor meer informatie hoe u deze speciale pagina moet gebruiken , zie de Engelse handleiding op Mediawiki.org.
Maak een samenvatting van uw veranderingen -- dit is de regel
We moeten allen in staat zijn even de ogen te laten dwalen over een verandering om gelijk de kern ervan te weten. Een volledige vergelijking met de oude tekst is niet altijd beschikbaar. U dient een opsomming te maken van uw veranderingen (Samenvatting: veld als u aan het bewerken bent). Het is als een changelog-bericht. Verklaar wat u deed en waarom, alsmede andere toepasselijke links en en details.
Als u er voor kiest niets samen te vatten, dient dit echt een uitzondering te zijn. Een reden kan zijn dat het slechts een kleine aanpassing betreft. In dat geval dient u het hokje Dit is een kleine bewerking aan te vinken alvorens de pagina op te slaan.
