PDF-metadata

Zo gebruik je de PDF-metadata

Belangrijkste functies van de PDF-metadata

Over de PDF-metadata

PDF-metadata opent het bestand met pdf-lib, leest de titel, auteur, onderwerp en trefwoorden uit de Info dictionary van het document, en schrijft je wijzigingen terug voordat het bestand wordt opgeslagen. De producer en de wijzigingsdatum zijn niet bewerkbaar: pdf-lib stelt de producer in op zijn eigen naam en de wijzigingsdatum op het moment van opslaan, en behoudt de creator en de aanmaakdatum als het bestand die al heeft.

Dit is handig om een gescande of geëxporteerde PDF een goede titel te geven, zodat de meeste PDF-viewers van browsers hem in het tabblad tonen, om een auteursnaam aan een document toe te voegen voordat je het verstuurt, of om de oude titel en trefwoorden van een sjabloon uit een daarop gebaseerd bestand te wissen. Er is een beperking: alleen de Info dictionary verandert. Een PDF die ook XMP-metadata bevat, behoudt zijn XMP-waarden, en een lezer die XMP verkiest, kan nog steeds de oude titel tonen.

Wanneer gebruik je de PDF-metadata?

Een PDF staat op het punt om op een website te worden gepubliceerd. Wanneer een bezoeker het bestand rechtstreeks opent, tonen de meeste ingebouwde browserviewers de titel van het bestand in het tabblad als die er is, en anders de bestandsnaam, dus ‘Jaarverslag 2026’ leest prettiger dan ‘final_v3.pdf’. Stel hier de titel, auteur en het onderwerp in voordat je het bestand naar de site uploadt.

Een document dat is geëxporteerd vanuit een tekstverwerker draagt de naam van wie de oorspronkelijke sjabloon heeft gemaakt als auteur, vaak een oud-collega of iemand buiten het bedrijf. Vervang de auteur door de huidige naam of de organisatie voordat het bestand naar een klant gaat.

Een reeks opleverdocumenten gaat naar een documentbeheersysteem dat de Info dictionary indexeert. Vul het onderwerp met de projectcode en de trefwoorden met de termen waarop het systeem zoekt, dan is elk bestand in de set op dezelfde manier te vinden.

Sommige wijzigingen zijn geen metadata. Gebruik de PDF-editor of Tekst toevoegen om de titel te wijzigen die op de eerste pagina staat afgedrukt. Gebruik PDF zwartlakken om een naam van de pagina's zelf te verwijderen. En als het bestand beveiligd is met een wachtwoord, verwijder dat wachtwoord dan eerst met PDF ontgrendelen, want deze tool kan geen versleuteld bestand openen.

Tips en probleemoplossing

• Trefwoorden worden bij het opslaan op komma's gesplitst, maar met spaties aan elkaar opgeslagen, zoals pdf-lib ze wegschrijft. ‘belasting, 2026, aangifte’ wordt opgeslagen als ‘belasting 2026 aangifte’ en komt zo terug als je het bestand hier opnieuw opent, waardoor een trefwoord van twee woorden niet te onderscheiden is van twee losse trefwoorden.
• Als de pagina na het kiezen van een bestand ‘Dit bestand kan niet worden geopend’ toont, is het bestand beveiligd met een wachtwoord, beschadigd, of geen PDF. Verwijder eventueel het wachtwoord met PDF ontgrendelen en laad de pagina daarna opnieuw.
• Bij elke keer opslaan wordt de producer ingesteld op de eigen naam van pdf-lib en de wijzigingsdatum op het moment van opslaan. De creator en de aanmaakdatum blijven behouden als het bestand die heeft, en worden anders op dezelfde waarden gezet.
• Tekst met accenten en niet-Latijnse tekens is geen probleem. De vier waarden worden opgeslagen als UTF-16-tekst, dus een titel in het Grieks, Hindi of Japans wordt precies zo geschreven en weer uitgelezen als je hem hebt getypt.
• De resultaatregel toont ‘Metadata van het document bijgewerkt.’, ook als je niets hebt gewijzigd, omdat het bestand hoe dan ook opnieuw wordt geschreven. De uitvoer krijgt de naam metadata_ gevolgd door de oorspronkelijke bestandsnaam.
• Het hele document wordt geparsed en opnieuw geserialiseerd om deze paar velden te wijzigen, dus een groot bestand heeft even nodig om op te slaan. Pagina's, afbeeldingen, lettertypen en formuliervelden komen ongewijzigd door.
• Voorbeeld bekijken opent het resultaat in de eigen PDF-viewer van je browser. Om de waarden zelf te controleren, open je het gedownloade bestand hier opnieuw en lees je de vier vakken.
• Metadata is een van de plekken waar een document meer zegt dan de pagina's laten zien. De gids kan een zwartgelakte PDF weer leesbaar worden gemaakt? noemt de andere, zoals opmerkingen, bijlagen en eerdere versies die in het bestand bewaard blijven.
• Om de XMP-kopie van deze gegevens en de andere informatie die deze tool niet aanraakt te wissen, lees je hoe je metadata uit een PDF verwijdert.

Zo werkt de PDF-metadata in je browser

Wanneer je een bestand kiest, wordt het met de File API in het geheugen geladen en door pdf-lib verwerkt tot een objectmodel van het hele document. De tool vraagt dat model om de titel, auteur, onderwerp en trefwoorden, die pdf-lib uitleest uit de Info dictionary van de trailer, en zet de waarden in de vier vakken; een veld dat het bestand niet heeft, wordt getoond als een leeg vak.

Wanneer je op PDF opslaan en downloaden klikt, worden de vier waarden via de functies setTitle, setAuthor, setSubject en setKeywords van pdf-lib teruggeschreven, elk opgeslagen als een UTF-16-tekenreeks in de Info dictionary, en serialiseert pdf-lib het document naar bytes, waarbij het onderweg zijn eigen producernaam en de huidige tijd als wijzigingsdatum stempelt. De bytes worden voor de downloadknop in een Blob verpakt. Geen enkel deel van het bestand of van de waarden die je typt wordt ergens naartoe gestuurd; het verwerkte document blijft in de pagina bewaard totdat je wegnavigeert of op Nog een bestand verwerken klikt, waarna de pagina opnieuw laadt.

Veelgestelde vragen