PmWiki's basisbewerkingen
auteurs (basis) De pagina's op deze site zijn wiki-gebaseerd, wat betekent dat ze gemaakt en bewerkt kunnen worden door meerdere auteurs. Om een pagina te bewerken klik je op de Bewerk-link die ergens op de pagina staat, meestal in de koptekst of in de voettekst. Sommige pagina's kunnen beveiligd zijn met wachtwoorden (en), afhankelijk van de beveiligingsrichtlijnen van de website, maar veel wiki-systemen laten toe om het merendeel van hun pagina's te wijzigen.
PmWiki is niet WYSIWYG (en) - Als je een pagina bewerkt zie je opmaak tekst naast de inhoud van de pagina. De basisbewerkingen voor pagina-opmaak zijn eenvoudig:
- Gebruik een blanco regel om met een nieuwe alinea te starten meer.
- Voor een lijst, begin elke regel met een # (voor een genummerde lijst) of een * (voor een ongenummerde lijst) meer.
- Voor een kop, begin een regel met twee of meer uitroeptekens (!); !! voor een kop, !!! voor een subkop meer.
- Om tekst te benadrukken omsluit het met 2 of 3 enkele aanhalingstekens;
''tekst''
voor cursief of'''tekst'''
voor vet meer. - Om een link naar een andere pagina te maken moet je de paginanaam omsluiten met dubbele rechte haken; bijvoorbeeld
[[basic editing]]
verwijst naar deze pagina. Om een link te maken naar een andere website, schrijf je het adres; zoals http://example.com/ meer.
Wil je experimenteren met het wijzigen van een pagina, probeer het dan in de WikiSandbox. Je kan de Wiki Zandbak wijzigen zonder iets belangrijk van deze site aan te tasten. Op overlegpagina's en bij discussies is het beleefd om je bijdragen te ondertekenen door het schrijven van 4 tildes: ~~~~. Die handtekening bestaat uit de naam die je hebt ingevuld in het Auteur-veld op het bewerk formulier en het tijdstip van je bijdrage.
Voorbeelden van opmaak
De tabellen hieronder demonstreren de meest voorkomende opmaakregels voor het vormgeven van pagina's. De linkerkolom toont wat je schrijft om een effect te bereiken, de rechterkolom toont het resultaat van deze opmaak. Voor meer details zie pagina Tekst opmaakregels (en) en andere documentatie pagina's. Een complete lijst van de standaard opmaakregels is beschikbaar in de opmaak hoofdindex (en).
Alinea's
Als je schrijft |
Is het resultaat |
Opeenvolgende regels zullen worden samengevoegd tot dezelfde alinea. Een of meer blanco regels zullen een nieuwe alinea starten. | Opeenvolgende regels zullen worden samengevoegd tot dezelfde alinea. Een of meer blanco regels zullen een nieuwe alinea starten. |
Twee schuine strepen naar achter aan het einde van de regel\\ forceren een nieuwe regel. Of gebruik deze opmaak: [[<<]] om een nieuwe regel te forceren. | Twee schuine strepen naar achter aan het einde van de regel Of gebruik deze opmaak: |
Verder lezen:
- Tekst opmaakregels#alinea's (en) voor meer informatie over opmaak van alinea's en regels.
- Wiki stijlen (en) voor gecentreerd of rechts uitlijnen van alinea's, "zwevende" tekst(boxen), randen en veel meer.
Lijsten
Begin elke regel met # voor genummerde (geordende) lijsten of met * voor ongenummerde (ongeordende) lijsten:
Als je schrijft |
Is het resultaat |
* Ongenummerde lijst * Een ander puntje ** Meer asterisken geven sub-puntjes ** etc. |
|
# Genummerde lijst # Een ander puntje ## Meer hekjes geven sub-puntjes |
|
# Lijsttypes # kunnen worden gemengd ** een genummerde lijst met ongenummerde sub-lijst |
|
Verder lezen:
- Tekst opmaakregels#lijsten om meer te leren over lijsten (inclusief definitie lijsten)
- Lijst stijlen
Koppen
Koppen helpen om een pagina goed te "structureren". Gebruik ze niet om tekst groot te maken.
Als je schrijft |
Is het resultaat |
!! Grote Kop !!! Kleine Kop !!!! En meer !!!!! Subkoppen | Grote KopKleine KopEn meerSubkoppen |
Tekst benadrukken
Om tekst te benadrukken omsluit het met afkappingstekens (enkele aanhalingstekens), niet met dubbele aanhalingstekens.
Als je schrijft |
Is het resultaat |
* ''Benadruk'' (cursief) * '''sterk''' (vet) * '''''zeer sterk''''' (vet cursief) |
|
Links
Om een link naar een andere pagina te maken, omsluit je de paginanaam met dubbele rechte haken.
Als je schrijft |
Is het resultaat |
Oefenen met opmaken in de [[wiki sandbox]] Met gewijzigde linktekst: [[wiki sandbox | oefenzone]] | Oefenen met opmaken in de wiki sandbox Met gewijzigde linktekst: oefenzone |
Merk op dat in de gegenereerde link de woorden van de paginanaam automatisch worden samengevoegd en dat de eerste letter van elk woord een hoofdletter wordt. De link verwijst dus naar pagina WikiSandbox.
Linken naar een pagina in een andere Wiki groep (en):
toon groep + paginanaam: [[Main.Wiki Sandbox]] toon enkel de paginanaam: [[Main/Wiki Sandbox]] | toon groep + paginanaam: Main.Wiki Sandbox toon enkel de paginanaam: Wiki Sandbox |
Linken naar een externe website:
Enkel de URL: http://www.pmwiki.org Met gewijzigde linktekst: [[http://www.pmwiki.org | PmWiki home]] | Enkel de URL: http://www.pmwiki.org Met gewijzigde linktekst: PmWiki home |
Linken naar een niet-bestaande pagina? wordt speciaal weergegeven, om anderen uit te nodigen deze pagina aan te maken.
Verder lezen:
- Links PmWiki ondersteunt nog meer linktypes en andere weergave-opties.
Wiki opmaak onderdukken
Soms is het gewenst om Wiki opmaak geheel of gedeeltelijk te onderdrukken.
Monospace tekst wordt weergegeven in een lettertype met vaste breedte (monospace) en genereert geen nieuwe regels, enkel wanneer expliciet ingegeven. Merk op dat zeer lange regels van zulke tekst de pagina te breed kunnen maken.
Als je schrijft |
Is het resultaat |
Monospace tekst met alle Wiki opmaak onderdrukt: omsluit het met [@ @]. Dit kan ook inline gebruikt worden.
[@ Tekst op deze manier omsloten krijgt de HTML ''code'' opmaak. @] | Tekst op deze manier omsloten krijgt de HTML ''code'' opmaak. |
Monospace tekst waarbij enkel de "benadruk" opmaak wordt verwerkt: start elke regel met een spatie.
Regels die beginnen met een spatie worden opgemaakt zoals je ze schrijft in lettertype met '''vaste breedte''' | Regels die beginnen met een spatie worden opgemaakt zoals je ze schrijft in lettertype met vaste breedte |
Alle Wiki opmaak onderdrukt behalve de regels opmaak: omsluit het met [= =]
. Dit kan ook inline gebruikt worden.
[= Wiki opmaak wordt ''niet'' verwerkt. Maar de regels worden opgemaakt, zonder het monospace lettertype. =] | Wiki opmaak wordt ''niet'' verwerkt. Maar de regels worden opgemaakt, zonder het monospace lettertype. |
Horizontale lijn
Als je schrijft |
Is het resultaat |
4 of meer streepjes aan het begin van de regel ---- geven een "Horizontale lijn" | 4 of meer streepjes aan het begin van de regel geven een "Horizontale lijn" |
Eenvoudige tabellen
Eenvoudige tabellen gebruiken dubbele verticale strepen om cellen apart te houden:
Als je schrijft |
Is het resultaat |
|| border=1 ||! kop 1 ||! kop 2 ||! kop 3 || || cel 1 || cel 2 || cel 3 || |
|
Verder lezen, om meer te leren over de rijke functionaliteit van PmWiki tabellen:
- Tabellen (en) voor eenvoudige tabellen
- Tabel declaraties (en) voor complexe tabellen
Afbeeldingen
Zie Afbeeldingen
Letteropmaak
Als je schrijft |
Is het resultaat |
* @@Monospace tekst@@ * Tekst met '^superscript^' * Tekst met '_subscript_' * Verwijderde {-doorgestreepte-} tekst * Toegevoegde {+onderstreepte+} tekst * [+Groot+], [++grotere++] tekst * [-Klein-], [--kleinere--] tekst |
|
Verder lezen:
- Zie Wiki stijlen (en) hoe de tekst kleur te veranderen.
Eenvoudige declaraties
Als je schrijft |
Is het resultaat |
De (:Title:)
declaratie verandert de paginatitel naar iets anders dan zijn paginanaam.
(:Title PmWiki's basisbewerkingen:) De naam van deze pagina is "{$Name}", en zijn titel is "{$Title}". | De naam van deze pagina is "BasicEditing", en zijn titel is "PmWiki's basisbewerkingen". |
De (:Description:)
declaratie definieert de pagina omschrijving. De omschrijving wordt gebruikt door zoek motoren, en kan getoond worden in zoekresultaten en paginalijsten (en).
(:Description Overzicht PmWiki's basisbewerkingen:) De omschrijving van deze pagina is "{$Description}". | De omschrijving van deze pagina is "Overzicht PmWiki's basisbewerkingen". |
Veelgestelde vragen
PmWiki is nieuw voor mij. Waar kan ik hulp vinden om van start te gaan?
Pagina Basisbewerkingen is een goede start. Vanaf daar kan je boven of onderaan de pagina de navigatie links volgen (ze worden Wiki Trails (en) genoemd) naar vervolg pagina's, of naar de Documentatie index. Deze overzichtspagina verschaft een index naar de essentiƫle documentatie pagina's, gerangschikt van beginners naar gevorderd.
Hoe kan ik speciale tekens zoals Copyright (©) en Trademark (® of ™) op mijn wiki-pagina's plaatsen?
Zie pagina Speciale tekens (en) hoe je speciale tekens kan invoegen die niet op uw toetsenbord voorkomen.
Waarom worden aparte regels tekst in de opmaak in een enkele lijn getoond op de pagina?
Opeenvolgende tekstregels worden door PmWiki standaard als een alinea beschouwd, en worden daarom samengevoegd bij het tonen van de pagina. Dit is consistent met de meeste andere wiki-pakketten. Een auteur kan gebruik maken van de (:linebreaks:)
declaratie om aparte regels in de opmaaktekst ook als aparte regels te tonen op de pagina. Of een wiki-beheerder kan hetzelfde bereiken voor de gehele site met een instelling in config.php: $HTMLPNewline
= '<br/>';
Kan ik rechtstreeks HTML invoeren?
Standaard (en zo ontworpen) heeft PmWiki geen ondersteuning voor het gebruik van HTML-elementen in de bewerkbare opmaak voor wiki-pagina's. Hiervoor zijn er een aantal redenen, beschreven in PmWiki filosofie en doelpubliek (en). Het toelaten van HTML opmaak binnen wiki-pagina's in een samenwerkende omgeving, zou sommige potentiƫle auteurs kunnen uitsluiten om pagina's te kunnen bewerken. Het geeft ook aanleiding tot een aantal weergave en veiligheidsproblemen. Maar een wiki-beheerder kan het Cookbook:Enable HTML (en) recept gebruiken, om HTML opmaak toch toe te laten in pagina's.
Waar vind ik meer documentatie?
Zie pagina's Documentatie index en opmaak hoofdindex (en).
Vertaling van originele pagina PmWiki.BasicEditing naar
PmWikiNl.BasicEditing - Backlinks
Laatste wijzigingen (Zie ook Status vertaling):
PmWikiNl.BasicEditing: September 10, 2011, at 10:56 AM
PmWiki.BasicEditing: January 07, 2022, at 10:17 PM
Er is mogelijk op pmwiki.org een meer recente BasicEditing, en een Engelse en/of Nederlandse overleg pagina.