Praktijkgids · Voor beginners

Je webpagina's
bewerken zonder stress

Tekst aanpassen, afbeeldingen vervangen, PDF's vernieuwen — en je wijzigingen online zetten. Alles wat je nodig hebt om je mini-sites zelfstandig te onderhouden.

Tekst · Afbeeldingen · PDF's · Publiceren

Scroll om te beginnen

Wat heb je nodig?

Drie tools die allemaal gratis zijn. GitHub Desktop heb je al staan. De andere twee installeer je één keer en dan heb je alles wat nodig is.

Essentieel
Een tekst-editor
Aanbevolen: VS Code (Windows · macOS · Linux)

Hiermee open je de HTML-bestanden en pas je tekst aan. VS Code toont de code mooi gekleurd, waardoor fouten makkelijker op te sporen zijn.

code.visualstudio.com
Essentieel
GitHub Desktop
Windows · macOS

Hiermee stuur je je wijzigingen naar de live website. Dit heb je al geïnstalleerd uit de vorige tutorial.

desktop.github.com
Optioneel
Een browser
Chrome, Firefox of Safari

Om je pagina te bekijken vóórdat je publiceert: dubbelklik op het HTML-bestand op je computer. Zo zie je meteen of alles goed oogt.

Al geïnstalleerd
Optioneel
Squoosh
Werkt in de browser — geen installatie

Verkleint afbeeldingen zonder zichtbaar kwaliteitsverlies. Essentieel om je site snel te houden. Gewoon bestand erin slepen.

squoosh.app

Wat doet elk bestand?

Voordat je gaat bewerken: weten wat elk type bestand doet, voorkomt veel verwarring. Dit is de rolverdeling binnen je mini-site.

.html

De inhoud en structuur

Hier staat alle tekst, koppen, knoppen en links. Dit is het bestand dat je het vaakst zult openen. Denk aan index.html als "de pagina zelf".

.css

Hoe het eruitziet

Kleuren, lettertypen, afstanden, kaders — alles visueel. In onze infographics staat de CSS meestal ingebed in het HTML-bestand zelf, bovenaan tussen <style> tags.

.js

Wat er beweegt of reageert

Uitklapbare secties, hover-effecten, de progressiebalk bovenaan. Meestal hoef je hier niets aan te doen — laat dit staan zoals het is.

.jpg · .png

De afbeeldingen

Staan in assets/images/. Vervangen doe je door simpelweg een bestand met dezelfde naam in dezelfde map te zetten.

.pdf

Downloadbare documenten

Staan in assets/pdfs/. Bezoekers kunnen deze openen of downloaden via een link in je pagina.

Tekst bewerken

Tekst staat altijd tussen twee tags — de haakjes met een woord erin. De tag vertelt de browser wat de tekst is: een kop, een alinea, een link. Jouw taak: de tekst ertussen wijzigen, de tags laten staan.

De regel van de tags

Elke stuk tekst in een webpagina zit tussen een open-tag en een sluit-tag. De sluit-tag heeft een schuine streep erin. Daartussen staat de tekst die je mag aanpassen.

Voor
<h1>Welkom op onze pagina</h1> <p>Dit is de oude tekst.</p>
Na
<h1>Welkom bij De Baak</h1> <p>Dit is de nieuwe tekst.</p>
!
Belangrijk Raak de haakjes < > niet aan. Als je per ongeluk een haakje verwijdert, raakt de pagina "in de war" en zul je het even moeten terugzetten.

De tags die je het vaakst tegenkomt

Je hoeft geen programmeur te zijn. Deze zes herken je steeds. Meer dan dit heb je zelden nodig.

<h1>Hoofdtitel van de pagina
<h2>Sectiekop
<h3>Subkop
<p>Paragraaf / alinea
<li>Item in een lijst
<strong>Vetgedrukt voor nadruk

Een link aanpassen

Links zien er iets anders uit. De zichtbare tekst staat tussen de tags, en de bestemming staat tussen de aanhalingstekens in href.

Voor
<a href="https://oude-site.nl">Oude link tekst</a>
Na
<a href="https://debaak.nl">Bezoek De Baak</a>
Werkvolgorde Maak altijd een kopie van het HTML-bestand voordat je grote wijzigingen maakt. Noem de kopie bijvoorbeeld index-backup.html. Gaat er iets mis? Dan heb je altijd een werkende versie om naar terug te keren.

Afbeeldingen vervangen en toevoegen

Werk je met bestaande afbeeldingen, dan is het vervangen kinderspel. Wil je een nieuwe afbeelding toevoegen, dan komt er één regel code bij. Beide scenario's hieronder.

Scenario A — Een bestaande afbeelding vervangen

De snelste route: gebruik precies dezelfde bestandsnaam als de oude afbeelding. Dan hoef je in de HTML helemaal niets te wijzigen.

1

Zoek de oude naam

Bijvoorbeeld screenshot.png in de map assets/images/

2

Hernoem je nieuwe bestand

Geef je nieuwe afbeelding exact dezelfde naam

3

Zet er overheen

Sleep naar de map, bevestig "vervangen"

4

Publiceer

Commit en push — klaar

Scenario B — Een nieuwe afbeelding toevoegen

Twee stappen: het bestand in de map zetten, en in de HTML vertellen waar de afbeelding moet komen.

In de map zetten
project-a/ └── assets/ └── images/ ├── screenshot.png └── team-foto.jpg ← nieuw
In de HTML
<img src="assets/images/team-foto.jpg" alt="Ons team op De Horst">
Vul altijd alt-tekst in De alt="" is geen extraatje. Mensen met een schermlezer horen deze tekst voorgelezen, en zoekmachines gebruiken hem ook. Schrijf kort wat er op de afbeelding staat.

Welk bestandsformaat kies je?

Kies bewust. Een verkeerd formaat maakt je pagina onnodig traag of je afbeelding lelijk.

Formaat Gebruik voor Tip
.jpg Foto's met veel kleurvariatie Beste keuze voor portretten, landschappen, sfeerbeelden
.png Logo's, iconen, screenshots met tekst Ondersteunt transparante achtergrond
.webp Alles — moderne allesdoener Kleiner dan jpg én png, zelfde kwaliteit
.svg Logo's en simpele illustraties Altijd scherp, onafhankelijk van grootte
!
Comprimeer voor je uploadt Foto's uit je telefoon zijn vaak 3-8 MB. Dat is veel te veel voor een webpagina. Sleep ze eerst door squoosh.app — meestal kun je ze 80-90% kleiner maken zonder zichtbaar kwaliteitsverlies.

PDF's bijwerken

PDF's werken bijna identiek aan afbeeldingen: bestand in de map, en een link in de HTML die er naartoe wijst.

Een nieuwe PDF toevoegen

Zet je PDF in assets/pdfs/ en voeg een link toe in je HTML. Het target="_blank" zorgt dat de PDF in een nieuw tabblad opent — zo verliest de bezoeker je pagina niet.

In de map zetten
project-a/ └── assets/ └── pdfs/ ├── handout-a1.pdf └── werkboek-2026.pdf
Link in de HTML
<a href="assets/pdfs/werkboek-2026.pdf" target="_blank"> Download het werkboek </a>
Gebruik eenvoudige bestandsnamen Geen spaties, geen hoofdletters, geen speciale tekens zoals é, ü, & of #. Gebruik streepjes: werkboek-2026.pdf in plaats van Werkboek 2026.pdf.

Je wijzigingen publiceren

Alle bewerkingen die je hebt gemaakt staan nu op je computer. Deze vier stappen zetten ze op de live website. Pages werkt automatisch bij — meestal binnen een minuut.

1

Sla op in je editor

In VS Code: Ctrl+S (Windows) of Cmd+S (Mac). Een bestand met een rond bolletje in het tabblad betekent: nog niet opgeslagen.

2

Open GitHub Desktop

Je ziet links alle bestanden die je hebt aangepast. Rechts verschijnen de exacte regels: groen = toegevoegd, rood = verwijderd. Neem een seconde om te checken of dit klopt.

3

Schrijf een commit-boodschap

Onderin: een kort zinnetje dat uitlegt wat je hebt gedaan. Bijvoorbeeld "Team-foto vervangen op project-a". Klik op Commit to main.

4

Push naar GitHub

Bovenin: klik op Push origin. Binnen 1-2 minuten staan je wijzigingen live. Ververs je website in de browser (Ctrl+F5 of Cmd+Shift+R) om het resultaat te zien.

Vaste gewoonte Maak kleine commits in plaats van één grote. Pas je drie dingen aan? Maak dan drie commits met elk een duidelijke boodschap. Gaat er iets fout, dan weet je precies waar je moet terugdraaien.

Veelvoorkomende problemen

Klik op een vraag om de oplossing te zien. Negen van de tien problemen staan hieronder beschreven.

Mijn wijzigingen zijn niet zichtbaar op de website
+
Eerste check: heb je op Push origin geklikt na de commit? Een commit blijft lokaal totdat je pusht.

Tweede check: ververs de pagina hard met Ctrl+F5 (Windows) of Cmd+Shift+R (Mac). Je browser bewaart soms een oude versie.

Derde check: geef het een minuut of twee. GitHub Pages is niet direct — publicatie duurt gemiddeld 30-90 seconden.
Mijn afbeelding is gebroken (rood kruis of niets te zien)
+
Hoofdletters zijn belangrijk. Foto.jpg is niet hetzelfde als foto.jpg. Op GitHub Pages is het bestandssysteem hoofdlettergevoelig, ook al is dat op jouw computer misschien niet zo.

Controleer het pad. Staat het bestand daadwerkelijk in assets/images/? En klopt de spelling in je HTML src="" exact met de bestandsnaam?

Geen spaties in bestandsnamen. Zet streepjes: team-foto.jpg werkt, team foto.jpg geeft problemen.
De opmaak ziet er plotseling vreemd uit
+
Meestal is er per ongeluk een < of > weggehaald, of een sluit-tag verdwenen. Open GitHub Desktop en kijk naar de rood gemarkeerde regels — daar staat wat er verwijderd is. Zet het terug.

Nog geen push gedaan? Dan kun je altijd de laatste opgeslagen versie terugzetten via Discard changes in GitHub Desktop. Je verliest dan je wijzigingen, maar de pagina werkt weer.
GitHub Desktop geeft een conflict-melding
+
Dit gebeurt als er elders (bijvoorbeeld via github.com) ook wijzigingen zijn gemaakt. Klik eerst op Fetch origin bovenin, dan Pull origin. Dat haalt de nieuwste versie op.

Werk je alleen op één computer? Dan kom je dit zelden tegen. Maar als je meerdere apparaten gebruikt, maak er dan een gewoonte van om elke sessie met een Fetch origin te beginnen.
De PDF-link werkt niet
+
Is de PDF daadwerkelijk gepusht? Open GitHub Desktop en controleer of het bestand in de laatste push zat. PDF's zijn groter dan tekst, dus soms vergeet je ze te committen.

Klopt de padverwijzing? Vanuit project-a/index.html linken naar een PDF wordt assets/pdfs/bestand.pdf, niet /assets/pdfs/bestand.pdf. Die eerste schuine streep breekt de link.
Ik weet niet zeker of ik het juiste bestand bewerk
+
Kijk naar het pad bovenin je editor. Werk je aan project-a/index.html, dan moeten je wijzigingen verschijnen op https://gebruikersnaam.github.io/learning-lab/project-a/.

Verkeerde mini-site? Sluit het bestand zonder op te slaan (of klik op "Don't save"), navigeer naar de juiste map en open het juiste bestand.

Oefening baart kunst — maar minder dan je denkt

De eerste paar keer voelt het spannend. Na drie of vier rondes bewerken, committen en pushen is het een vaste gewoonte. En weet: alles is terug te draaien. Er bestaat niets dat je niet kunt herstellen.