Aspecten/acties
Persoonlijke instellingen
Help:Inhoud
Uit PHPWiki
Inhoud |
Nieuwe artikelen aanmaken
Het aanmaken van een nieuw artikel kan op twee verschillende manieren, namelijk via de url en via de zoekfunctie. Ga dus niet op zoek naar een knopje om een nieuwe pagina aan te maken, want dat zul je echt niet vinden.
Via de url
Stel dat je een pagina met de naam 'Nieuwe Pagina' aan wilt maken, verander dan de url naar http://wiki.phptuts.nl/Nieuwe_Pagina. PHPWiki zal je vervolgens vertellen dat deze pagina nog niet bestaat en je de mogelijkheid geven om deze pagina te bewerken. Kies daarvoor en de nieuwe pagina is wordt aangemaakt.
Via de zoekfunctie
Typ de naam van de pagina die je wilt aanmaken in in de zoekfunctie van PHPWiki. Als de pagina niet bestaat zal de wiki je daar een melding van geven en ook hier krijg je de mogelijkheid om de pagina aan te maken.
Categorieën
Als je een nieuw artikel aanmaakt, zorg er dan voor dat je het artikel in de juiste (sub-)categorie plaatst. Om een artikel in een categorie te plaatsen, plaats je onder aan je artikel de volgende regel:
[[Category:Naam_van_categorie]]
In het geval van de categorie 'Functies' zou dat dus worden:
[[Category:Functies]]
Zie ook de MediaWiki handleiding over categorieën.
Opmerking: Je kunt alleen nieuwe pagina's aanmaken als je ingelogd bent. Ga dus eerst naar Aanmelden om in te loggen of je aan te melden als je dat nog niet gedaan hebt.
Functies
Op dit moment een vast template voor de PHP functies. Op die manier komen alle functiebeschrijvingen er hetzelfde uit te zien: Functie Template.
Bestaande artikelen wijzigen
Open het artikel dat je wilt wijzigen en kies voor 'Bewerken' uit het menu aan de rechterkant van de pagina. Om enkel een bepaald onderdeel van een pagina te wijzigen, kun je ook op het betreffende 'Bewerken' linkje achter de titel van dat gedeelte klikken.
Opmerking: Je kunt alleen pagina's wijzigen als je ingelogd bent. Ga dus eerst naar Aanmelden om in te loggen of je aan te melden als je dat nog niet gedaan hebt.
Artikelen verwijderen
Het is niet mogelijk om artikelen te verwijderen, deze functie is enkel weggelegd voor beheerders. Wil je toch dat een bepaald artikel verwijderd wordt, dan kun je zelf al alle verwijzigen naar het betreffende artikel verwijderen. Vervolgens kun je een mailtje sturen waarin je vraagt of het artikel verwijderd kan worden.
Layout/Opmaak
Tekst opmaak
Voor de layout van je tekst kun je gebruik maken van de standaard wiki mogelijkheden tot het opmaken van teksten. Kijk naar de broncode van andere artikelen om te zien hoe anderen dat gedaan hebben of neem een kijkje in de MediaWiki handleiding over het opmaken van teksten.
Code layout
Voor het netjes weergeven van stukken (PHP) code, heb je de volgende mogelijkheden:
Script zonder regelnummers
<php><?php echo 'Hello World!'; ?></php>
Resultaat:
<?php echo 'Hello World!'; ?>
Script met regelnummers
<php LINES=1><?php echo 'Hello World!'; ?></php>
Resultaat:
Richtlijnen
Omdat PHPWiki in principe door iedereen te bewerken is, volgen hier een paar eenvoudige richtlijnen om te zorgen dat het overzicht binnen de wiki bewaard blijft.
Plaats je artikel in de juiste categorie
Een artikel over een PHP functie hoort natuurlijk niet thuis tussen de artikelen over een SQL database, maar gewoon in de categorie PHP. Zoek dus voordat je een artikel plaatst even uit in welke categorie een artikel thuis hoort.
Mocht je artikel in geen van de bestaande categorieën thuis horen, dan kun je hem ook in een nog niet bestaande categorie plaatsen. De categorie zal dan nog in het rood verschijnen maar kan vervolgens aangemaakt worden.
Taalgebruik
Probeer zoveel mogelijk in helder, duidelijk Nederlands te schrijven. Dat wil zeggen met juist gebruik van leestekens, duidelijke zinsbouw en zoveel mogelijk Nederlandse woorden. Natuurlijk is het niet overal mogelijk of zelfs gewenst om een Engels woord te vertalen (denk aan 'echo' of 'array'), maar als er een heldere Nederlandse vertaling beschikbaar is, gebruik die dan.
Scripts
Zorg ervoor dat de code van de scripts die je plaatst leesbaar en begrijpbaar is.
Wat betreft de leesbaarheid is het handig als je je aan een stijl van inspringen zoals de K&R of de Allman stijl. Om er daarnaast voor te zorgen dat je code begrijpbaar is, is het zaak om je code te voorzien van duidelijk commentaar. Vooral in grotere scripts is dit geen overbodige luxe!
