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:

  1. Gebruik een blanco regel om met een nieuwe alinea te starten meer.
  2. Voor een lijst, begin elke regel met een # (voor een genummerde lijst) of een * (voor een ongenummerde lijst) meer.
  3. Voor een kop, begin een regel met twee of meer uitroeptekens (!); !! voor een kop, !!! voor een subkop meer.
  4. Om tekst te benadrukken omsluit het met 2 of 3 enkele aanhalingstekens; ''tekst'' voor cursief of '''tekst''' voor vet meer.
  5. 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
forceren een nieuwe regel.

Of gebruik deze opmaak:
om een nieuwe regel te forceren.

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.
  • Ongenummerde lijst
  • Een ander puntje
    • Meer asterisken geven sub-puntjes
    • etc.
# Genummerde lijst
# Een ander puntje
## Meer hekjes geven sub-puntjes
  1. Genummerde lijst
  2. Een ander puntje
    1. Meer hekjes geven sub-puntjes
# Lijsttypes
# kunnen worden gemengd
** een genummerde lijst met ongenummerde sub-lijst
  1. Lijsttypes
  2. kunnen worden gemengd
    • een genummerde lijst met ongenummerde sub-lijst

Verder lezen:

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 Kop

Kleine Kop

En meer

Subkoppen

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)
  • 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 ||
kop 1kop 2kop 3
cel 1cel 2cel 3

Verder lezen, om meer te leren over de rijke functionaliteit van PmWiki 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
  • Monospace tekst
  • Tekst met superscript
  • Tekst met subscript
  • Verwijderde doorgestreepte tekst
  • Toegevoegde onderstreepte tekst
  • Groot, grotere tekst
  • Klein, kleinere tekst

Verder lezen:

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: 10-09-2011, 12:56 da tarde
PmWiki.BasicEditing: 03-07-2022, 10:33 da manhã

Er is mogelijk op pmwiki.org een meer recente BasicEditing, en een Engelse en/of Nederlandse overleg pagina.