Documentatie
Bij het maken van een vrij besturingssysteem van hoge kwaliteit hoort ook het schrijven van technische handleidingen die de werking en het gebruik van programma's beschrijven. Het Debian-project stelt alles in het werk om alle gebruikers te voorzien van goede documentatie in een gemakkelijk toegankelijke vorm. Deze pagina bevat een aantal links die leiden naar installatiehandleidingen, HOWTO's, veelgestelde vragen, opmerkingen bij de release, onze Wiki en meer.
Snel aan de slag
Als Debian nieuw voor u is, raden we u aan te beginnen met de volgende twee handleidingen:
Zorg ervoor dat u deze documenten bij de hand heeft wanneer u uw eerste installatie van Debian uitvoert. Waarschijnlijk zullen ze veel vragen beantwoorden en u helpen bij het werken met uw nieuw Debian-systeem.
Later zult u mogelijk de volgende documenten willen raadplegen:
- Debian Reference (Debian Naslagwerk): een beknopte gebruikershandleiding met de klemtoon op de shell-commandoregel (nog niet naar het Nederlands vertaald)
- Notities bij de release: meestal gepubliceerd bij updates van Debian, gericht op gebruikers die een opwaardering van de distributie uitvoeren
- Debian Wiki: officiële Debian-wiki (beperkt aantal pagina's in het Nederlands)
Handleidingen
Het grootste deel van de documentatie die is opgenomen in Debian, werd geschreven voor GNU/Linux in het algemeen, maar er is ook documentatie die specifiek voor Debian is geschreven. In principe worden de documenten ingedeeld in de volgende categorieën:
- Handleidingen: deze gidsen lijken op boeken, omdat ze belangrijke onderwerpen uitgebreid beschrijven. Veel van de hieronder vermelde handleidingen zijn zowel online als in Debian-pakket beschikbaar. In feite zijn de meeste handleidingen op de website uit hun respectievelijk Debian-pakket gehaald. Kies hieronder een handleiding voor de pakketnaam en/of de link naar de online versie.
- HOWTO's: zoals de naam aangeeft, beschrijven de HOWTO-documenten hoe u een bepaalde zaak moet doen, d.w.z. zij geven gedetailleerd en praktisch advies over de manier waarop iets moet worden gedaan.
- FAQ's: we hebben verschillende documenten samengesteld waarin veelgestelde vragen worden beantwoord. Debian-gerelateerde vragen worden beantwoord in de Debian FAQ. Daarnaast is er een aparte FAQ over Debian USB/cd/dvd-images, waarin allerlei vragen over installatiemedia worden beantwoord.
- Andere (kortere) documenten: bekijk ook de lijst met beknopte instructies.
Veel van de hier vermelde handleidingen zijn zowel online als in Debian-pakket beschikbaar; in feite zijn de meeste handleidingen op de website uit hun respectievelijk Debian-pakket gehaald. Kies hieronder een handleiding voor de naam van het pakket en/of de link naar de online versie.
Handleidingen die specifiek zijn voor Debian
Handleidingen voor gebruikers
- The Debian Bookworm beginner’s handbook (Debian Bookworm handboek voor beginners - nog niet in het Nederlands)
- Debian GNU/Linux FAQ (veelgestelde vragen)
- Debian Installatiehandleiding
- De Debian Notities bij de Release
- Debian Naslagkaart
- Het Debian Beheerdershandboek
- Debian Reference (Debian naslagwerk - nog niet in het Nederlands)
- Securing Debian Manual (Handleiding voor het beveiligen van Debian - nog niet in het Nederlands)
- Gebruikershandleiding voor aptitude
- APT User's Guide (Gebruikershandleiding voor APT - nog niet in het Nederlands)
- Debian GNU/Linux and Java FAQ (De FAQ over Debian GNU/Linux en Java - nog niet in het Nederlands)
- Debian Hamradio Maintainer’s Guide (Debian handleiding voor onderhouders van amateurradio-pakketten)
Handleidingen voor ontwikkelaars
- Debian Policy Manual (Het Debian Beleidshandboek - nog niet in het Nederlands)
- Debian Developer's Reference (Het naslagwerk voor ontwikkelaars van Debian - nog niet in het Nederlands)
- Guide for Debian Maintainers (Handleiding voor pakketbeheerders van Debian - nog niet in het Nederlands)
- Introduction to Debian packaging (Inleiding in het maken van Debian-pakketten - nog niet in het Nederlands)
- Debian Menu System (Uitleg over het Debian menusysteem - nog niet in het Nederlands)
- Debian Installer internals (Achter de schermen van het Debian installatiesysteem - nog niet in het Nederlands)
- Guide for database using package maintainers (Handleiding voor beheerders van pakketten die databases gebruiken - nog niet in het Nederlands)
- Policy for packages using databases (Richtlijnen voor pakketten die databases gebruiken - nog niet in het Nederlands)
Andere (beknoptere) documenten
De volgende documenten bevatten snelle, korte instructies:
- Man-pagina’s
- Vanouds worden alle UNIX programma's gedocumenteerd in
zogenaamde
manpages
(man-pagina’s). Dit zijn naslaghandleidingen die u kunt oproepen door middel van het commando man. Ze zijn meestal niet gericht op beginners, maar ze documenteren alle eigenschappen en functies van een commando. Het volledige archief van alle man-pagina’s die in Debian beschikbaar zijn, staat online: https://manpages.debian.org/. - info-bestanden
- Veel software van GNU is gedocumenteerd in info-bestanden in plaats van in man-pagina’s. Deze bestanden bevatten uitgebreide informatie over het programma zelf, opties en voorbeelden. Ze zijn beschikbaar via het commando info.
- README-bestanden
- README-bestanden (lees-mij-bestanden) zijn eenvoudige tekstbestanden die één enkel onderwerp beschrijven, meestal een specifiek pakket. U kunt veel van deze bestanden vinden in de onderliggende mappen van /usr/share/doc/ op uw Debian-systeem. Naast het README-bestand bevatten sommige van die mappen configuratievoorbeelden. Houd er rekening mee dat de documentatie van grotere programma's doorgaans in een apart pakket wordt geleverd (met dezelfde naam als het oorspronkelijke pakket, maar eindigend op -doc).