Help:Tekstopmaak

Uit Cultureel Erfgoed Standaardentoolbox
Naar navigatie springen Naar zoeken springen

Hier lees je hoe je een tekst kunt structureren en opmaken.

Suggestie: houd deze pagina in een apart venster bij de hand tijdens het schrijven van teksten. Wellicht wil je deze pagina bookmarken of toevoegen aan je favorieten. Uitproberen van de tekstopmaak kan in de zandbak.

Intro

Naast de korte inleidende tekst is er in deze eerste alinea ruimte voor achtereenvolgens een infobox, positiekaart, zijbalk, afbeelding en een inhoudsopgave. In de introductietekst probeer je het lemma vooraan in de openingszin te zetten en geef je deze vetgedrukt weer.

Semantisch sjablooon

Nuvola single chevron right.svg Zie Gebruik van sjablonen voor het hoofdartikel over dit onderwerp.

Aan pagina's uit de categorieën Richtlijn, Standaard, Software, Publicatie en Glossarium wordt een semantisch sjabloon toegevoegd dat toelaat om bepaalde eigenschappen aan het artikel toe te kennen. Deze eigenschappen kunnen dan door externe applicaties (bv. API's) ingelezen en begrepen worden. Het toevoegen van de sjablonen kan op twee manieren: het sjabloon kan in de brontekst worden toegevoegd of via een semantisch formulier. Het gebruik van dit formulier wordt aangeraden.

Pagina's die al beschikken over een semantisch sjablonen tonen de link [bewerken met formulier]. Door op deze link te klikken kan je de pagina meteen bewerken met het correcte formulier.

Inhoudsopgave

Bij vier of meer koppen komt er automatisch een inhoudsopgave zoals bovenaan deze pagina. In uitzonderlijke gevallen kun je de inhoudsopgave ook verplaatsen, verbergen of juist tonen in geval van drie of minder secties, maar in gewone artikelen wordt dit niet gewaardeerd.

  • Verplaatsen doe je door __TOC__ op de betreffende plaats te typen. (TOC staat voor Table of Contents)
  • Verbergen doe je door __NOTOC__ bovenaan in het artikel te plaatsen.
  • Forceren kan met __FORCETOC__.

Pagina-indeling

Koppen en secties

Nieuwe secties worden voorafgegaan door koppen die je maakt met het =-teken. De eerstegraads kop is altijd de paginatitel (lemma), die hoef je dus niet in het bewerkingsvenster te typen. Voor het maken van tweedegraads koppen type je == Tweedegraads kop ==. Zo kun je de tekst in de ontstane sectie (of paragraaf) verder onderverdelen van === Derdegraads kop === tot aan ====== Zesdegraads kop ======. Houd vanwege de opmaak de rangorde van koppen aan en gebruik dus een derdegraads kop alleen als er een tweedegraads kop is. Gebruik spaties tussen de =-tekens en de inhoud van de kop en begin de kop met een hoofdletter.

Als de link [bewerken] (rechts van de sectietitel) storend werkt, kun je deze verbergen met de code __NOEDITSECTION__.

Alinea's en regeleinden

Alinea's maak je door in het bewerkingsvenster een witregel tussen twee alinea's te laten. Dit is beter dan <br />, dat je wel kunt gebruiken om binnen een alinea op een nieuwe regel te beginnen.

Horizontale scheidingslijn

Een horizontale scheidingslijn creëer je door in de knoppenbalk boven het bewerkingsvenster te klikken op het desbetreffende icoontje of door ---- aan het begin van een regel te plaatsen.

Lettertype, lettergrootte

Lettertype

Technische termen worden weergegeven met de tt-tags. 'Management Controller' wordt dan <tt>Management Controller</tt>, wat resulteert in Management Controller.

Toepassing:

  • Technische termen

Voor een niet-proportioneel lettertype voeg je een spatie toe aan het begin van de tekst. Bij grote stukken tekst kun je de tekst ook tussen <pre> en </pre> zetten.

Er is geen terugloop, denk aan regeleinden. Toepassing:

  • Het plakken van voorgeformatteerde tekst
  • Algoritmische beschrijvingen
  • ASCII-kunst
  • Broncode

Om broncode te typen binnen een regel typ je <code>echo "Hoi";</code>, dat wordt echo "Hoi"; (zoals hier in deze handleiding ook veel gebruikt). Voor andere inline-teksten kun je <tt> en </tt> gebruiken, bijvoorbeeld <tt>Wikipedia</tt> resulteert in Wikipedia.

Wanneer tekst in een ander lettertype moet komen te staan (hetgeen in de encyclopedische naamruimte echter sterk wordt afgeraden), dan kan bijvoorbeeld volgende code worden gebruik:

<span style="font-family:'Times New Roman', 'Times Roman', Times, Palatino, serif; font-size:1.2em; white-space:nowrap;">Tekst in ander lettertype</span>

Dit levert:

Tekst in ander lettertype

Lettergrootte

In koppen en sjablonen wordt de lettergrootte vanzelf bepaald. Verdere toepassingen van verschillende lettergroottes zijn er nagenoeg niet.

Tekst kan eventueel groter en kleiner dan normaal worden geschreven. Typ vóór een woord <big> en erna </big> om het woord groter weer te geven, zoals hier het geval is. Hetzelfde geldt voor het kleiner maken van tekst: <small> en </small> zullen het gewenste effect geven, zoals hier het geval is.

Toepassing:

  • (nagenoeg) niet: het gebruik wordt afgeraden

Letteropmaak

Boven het bewerkingsvenster staan voor de meest toegepaste opmaak een aantal knoppen waarmee je tekst kunt vet maken of cursiveren, een in- of externe link kunt maken, een afbeelding of mediabestand kunt invoegen, een wiskundeformule kunt toepassen of een tabel kunt aanmaken. Merendeels voor het gebruik op overlegpagina's staat de handtekening en de code 'nowiki' ter beschikking met een simpele klik op de knop. Voor alle opmaakkenmerken geldt: wees spaarzaam in het toepassen ervan. Kies bij benadrukken van een woord daarom ook eerst voor cursief en dan pas voor vet.

Het gebruik van deze Wiki-syntaxis verdient de voorkeur, hoewel standaard HTML-codes als <b>, <i>, <em>, <cite> en <strong> ook werken.

Vet

Een vet lettertype krijg je door links en rechts van een woord drie rechte apostrofs te plaatsen of door simpelweg op desbetreffende knop boven het bewerkingsvenster te klikken. '''vetgedrukt lettertype''' resulteert in: vetgedrukt lettertype

Toepassing:

  • Als je een nieuwe pagina aanmaakt, dan dien je de eerste keer dat de onderwerpsterm voorkomt deze vet te maken: dus door middel van '''onderwerpsterm'''.
  • In het algemeen wordt vet in een artikel gereserveerd voor de te definiëren term, en eventueel voor in het artikel gemelde synoniemen daarvan.
  • NB: niet gebruiken om zelf koppen in een artikel te maken

Cursief

Een cursief lettertype krijg je door links en rechts van een woord twee rechte apostrofs te plaatsen of door simpelweg op desbetreffende knop boven het bewerkingsvenster te klikken. ''cursief lettertype'' resulteert in: cursief lettertype

Toepassing:

  • nadruk leggen op een woord, waarbij een accentstreep niet passend is
  • titels van op zichzelf staande werken zoals cd-titels (onderdelen zoals nummers van een cd krijgen daarentegen apostrofs)

Onderstrepen

Aangezien links nagenoeg altijd zijn onderstreept, wordt het zelf onderstrepen van woorden afgeraden. Is het toch nodig om een tekst te onderstrepen dan kan dit met de codes <u> en </u> om de tekst heen te zetten. <u>Belangrijke tekst maar linke soep</u> resulteert in: Belangrijke tekst maar linke soep

Toepassing:

  • (nagenoeg) niet: het gebruik wordt afgeraden

Doorstrepen

Het doorstrepen van tekst gaat met de codes <s> en </s>: <s>Boodschappen doen</s> resulteert in: Boodschappen doen

Toepassing:

  • Doorstrepen wordt veelal gebruikt op overlegpagina's om aan te geven dat men afstand neemt van een eerder gedane bijdrage.

Nadruk leggen

Gebruik zo min mogelijk nadruk, indien mogelijk, met andere woorden: gebruik liever ''Hoi'' dan '''Hoi'''.

In het algemeen wordt vet in een artikel gereserveerd voor de te definiëren term, en eventueel voor in het artikel gemelde synoniemen daarvan, worden woorden of zinnen in een vreemde taal in a foreign language cursief geplaatst en worden Nederlandstalige titels geaccentueerd door deze 'tussen enkele aanhalingstekens' te plaatsen.

Tekstkleur, achtergrondkleur

Om een tekst een kleur te geven typ je voor een woord <font color="red"> en erna </font> wat resulteert in een rood woord zoals dat hier het geval is.

Om een achtergrond van een tekst te kleuren typ je voor de tekst <div style="background-color:lightgrey;"> en erna </div> wat resulteert in

hetgeen hier het geval is.

Een andere optie is <span style="background-color:lightgrey;"> en erna </span> wat resulteert in hetgeen hier het geval is.

Kleuren vul je in met hun Engelse benaming of met hexadecimale kleurgetallen waarmee vele tinten mogelijk zijn.

Toepassing:

  • in tabellen en sjablonen
  • verder (nagenoeg) niet: het gebruik wordt in de encyclopedieteksten afgeraden

Superscript, subscript

In het venster 'Speciale tekens' onder het bewerkingsvenster staan enkele tekens voor superscript: °, ¹, ², ³, ©, ® en ™.

Voor andere toepassingen kun je tekst plaatsen tussen <sup> en </sup> of tussen <sub> en </sub>, wat resulteert in respectievelijk superscript of subscript.

Kapitalen, kleine kapitalen

Voor het benadrukken van een woord geen kapitalen gebruiken, maar eerder een cursief lettertype.

Regelopmaak

Uitlijnen

Het uitlijnen (links, gecentreerd of rechts weergeven) kan als volgt worden gedaan:

Typ voor een sectie of alinea <div style="text-align:left;"> en erna </div> om deze links uit te lijnen.
Typ voor een sectie of alinea <div style="text-align:center;"> en erna </div> om deze te centreren.
Typ voor een sectie of alinea <div style="text-align:right;"> en erna </div> om deze rechts uit te lijnen.

Lijsten

Er zijn ongeordende lijsten waarin jezelf de volgorde kunt bepalen, maar ook genummerde lijsten die zelf automatisch doornummeren. Definitielijsten moeten ook handmatig worden geordend. Ook kunnen opsommingen op volgorde worden getoond met een code.

Ongeordende lijsten

Ongeordende lijsten maak je door een * aan het begin van de regel te plaatsen. Sublijsten maak je door ** te gebruiken, en ook daarbinnen kun je sublijsten maken door middel van ***. Hieronder een voorbeeld:

Invoer:

* Groente en fruit
** Paprika
*** Rode paprika
*** Groene paprika
** Tomaat
** Sinaasappel
* Snoep
* Drank

Resultaat:

  • Groente en fruit
    • Paprika
      • Rode paprika
      • Groene paprika
    • Tomaat
    • Sinaasappel
  • Snoep
  • Drank

Genummerde lijsten

Genummerde lijsten maak je op dezelfde manier als ongeordende lijsten, maar dan door een # te plaatsen. Hieronder een voorbeeld:

Invoer:

# Familie Blaat
# Familie Van de Loo
## Frank
## Gonny
## Mickey
## Max
## Jolene
## Bob
# Familie Melp

Resultaat:

  1. Familie Blaat
  2. Familie Van de Loo
    1. Frank
    2. Gonny
    3. Mickey
    4. Max
    5. Jolene
    6. Bob
  3. Familie Melp


Bij meer dan één enter tussen de opeenvolgende #-tekens begint de telling opnieuw:

Invoer:

# Familie Blaat
# Familie Van de Loo

## Frank
## Gonny
## Mickey
## Max
## Jolene
## Bob
# Familie Melp

Resultaat:

  1. Familie Blaat
  2. Familie Van de Loo
    1. Frank
    2. Gonny
    3. Mickey
    4. Max
    5. Jolene
    6. Bob
  1. Familie Melp


De nummering van de items in de met wiki-code opgestelde lijst begint altijd met 1. Om hiervan af te wijken (b.v. wanneer een genummerde lijst over meer kolommen verdeeld moet worden) is HTML-code nodig:

Invoer:

<ol start="5">
<li>aap</li>
<li>noot</li>
<li>mies</li>
</ol>

Resultaat:

  1. aap
  2. noot
  3. mies

Definitielijsten

Definitielijsten voor het weergeven van betekenissen maak je met de puntkomma. Die methode wordt aanbevolen boven *'''term''':definitie omdat dit een duidelijkere html tot gevolg heeft waardoor de pagina toegankelijker wordt voor alternatieve browsers (blinden, surfen via gsm).

Voorbeeld 1:

Invoer:

;term:definitie 

Resultaat:

term
definitie

Voorbeeld 2:

Invoer:

;appel: zoet of zuur fruit, geel, groen of rood van kleur, van een appelboom
;tomaat: meestal rode vrucht van een tomatenplant
;aardappel: wortelknol van een aardappelplant

Resultaat:

appel
zoet of zuur fruit, geel, groen of rood van kleur, van een appelboom
tomaat
meestal rode vrucht van een tomatenplant
aardappel
wortelknol van een aardappelplant


Voorbeeld 3 (term met meerdere definities):

Invoer:

;saté
:stokje met kleine (0,5 cm dik) stukjes vlees aangeregen (Nederland)
:stokje met grote kubussen vlees en groenten aangeregen (België)

Resultaat:

saté
stokje met kleine (0,5 cm dik) stukjes vlees aangeregen (Nederland)
stokje met grote kubussen vlees en groenten aangeregen (België)

Voorbeeld 4 (meerdere termen met eenzelfde betekenis):

Invoer:

;ds
;dossier
:in samenvattingsregel, aanmaak of aanvulling van vandalismedossier

Resultaat:

ds
dossier
in samenvattingsregel, aanmaak of aanvulling van vandalismedossier

Inspringen

Inspringen doe je door een dubbele punt toe te voegen aan het begin van een regel. Meerdere dubbele punten betekent meer inspringen.

Invoer:

:Ik
::Spring
:::Steeds
::::Verder
:::::In.

Resultaat:

Ik
Spring
Steeds
Verder
In.

Speciale tekens

Onder de bewerkingspagina staan ook de meest voorkomende speciale tekens. Door er op te klikken worden deze in de tekst ingevoegd.

Bestanden

Bestanden kan je op twee manieren in je tekst opnemen:

Voorbeeld 1: als je '[[Bestand:' gebruikt, zal de lezer worden doorverwezen naar de Wiki-pagina van het bestand

Invoer:

Voor de gebruikte GRELfuncties in Open Refine zie 
[[Bestand:20150430_Handout_Open_Refine_workshop.pdf|Handout Open Refine workshop]]

Resultaat:

Voor de gebruikte GRELfuncties in Open Refine zie Bestand:20150430 Handout Open Refine workshop.pdf


Voorbeeld 2: als je '[[Media:' gebruikt, zal de lezer rechtstreeks naar het eigenlijke bestand worden doorverwezen

Invoer:

Voor de gebruikte GRELfuncties in Open Refine zie 
[[Media:20150430_Handout_Open_Refine_workshop.pdf|Handout Open Refine workshop]]

Resultaat:

Voor de gebruikte GRELfuncties in Open Refine zie Handout Open Refine workshop

Afsluitingen

Aan het eind van een artikel staan vaak de achtereenvolgende paragrafen 'Zie ook', 'Externe links' en 'Bronnen, voetnoten, referenties', gevolgd door navigatiebalken en categorieaanduidingen. Geheel onderaan in het bewerkingsscherm komt de verwijzing naar het artikel in een andere taal wat in een kolom links van het artikel zichtbaar wordt.


Zie ook

Nuvola single chevron right.svg Deze tekst is geheel of gedeeltelijk overgenomen van de Nederlandstalige Wikipedia en valt onder CC-BY-SA. Zie Help:Tekstopmaak voor een overzicht van de belangrijkste auteurs.