Ja. Daar heb je geen API voor nodig. Een Tolkie-link is je bestaande pdf-url met een vaste prefix ervoor. Je webbouwer kan die prefix automatisch voor alle pdf-links op je website zetten, bijvoorbeeld in de template. Voorwaarde is wel dat het domein waar je pdf's op staan in Mijn Tolkie geregistreerd is, en dat de server van dat domein toestaat dat de pdf-viewer van Tolkie de pdf's ophaalt.
Heb je veel pdf's op je website, dan is het ondoenlijk om voor elke pdf apart een link te maken in Mijn Tolkie. Met de aanpak hieronder krijgen al je pdf's in één keer de leeshulp, ook pdf's die je later toevoegt.
Hoe ziet een Tolkie-link eruit?
Een Tolkie-link bestaat uit drie delen: de prefix, het token van je website en de url van de pdf.
https://pdf.tolkie.nl/web/viewer.html?token=JOUW-TOKEN&file=URL-VAN-DE-PDF
Een voorbeeld:
https://pdf.tolkie.nl/web/viewer.html?token=0547f2305575dae26afc69356d196b03c5bca13a&file=https://www.example.nl/documenten/brief-huurverhoging.pdf
Het token van je website vind je in Mijn Tolkie bij Code/token. Twijfel je welk token je moet gebruiken? Maak dan in Mijn Tolkie met Maak Tolkie-link één link voor een bestaande pdf, en kijk welk token daarin staat. Hoe dat werkt, lees je in Hoe werkt de Pdf-viewer met Tolkie Leeshulp?
Wat moet mijn webbouwer doen?
Je webbouwer zorgt ervoor dat links naar pdf's op je website automatisch via de Tolkie-link lopen. Bijvoorbeeld zo:
Zoek in de template van de website alle links die naar een pdf verwijzen.
Zet voor die links de prefix met het token van je website. De oorspronkelijke pdf-url komt achter
file=.Bevat de pdf-url zelf een vraagteken, een &-teken of spaties? Codeer de url dan (url-encoding), zodat de viewer hem goed leest.
Test een paar pdf's uit verschillende mappen voordat de aanpassing live gaat.
Tolkie denkt graag mee over de aanpak en beantwoordt vragen van je webbouwer. De aanpassing in het CMS doet jullie webbouwer zelf.
Welke pdf's werken met de Tolkie-link?
De pdf moet openbaar bereikbaar zijn. Pdf's achter een inlog of op een intern netwerk werken niet.
Het domein waar de pdf's op staan, moet geregistreerd zijn in Mijn Tolkie bij Instellingen → Implementatie → Geregistreerde urls. Staan je pdf's op een ander domein dan je website, zoals een opslagdienst? Voeg dat domein dan ook toe.
De server waar de pdf op staat, moet toestaan dat de pdf-viewer van Tolkie (pdf.tolkie.nl) het bestand ophaalt. Technisch heet dat CORS, en je webbouwer of hostingpartij kan dat instellen. Sommige servers staan het niet toe, bijvoorbeeld bij websites van Embrace. In dat geval upload je de pdf bij Tolkie.
De pdf moet echte tekst bevatten. Een gescande pdf is eigenlijk een foto. Daar kan de leeshulp niets mee.
Kan dit ook voor pdf's die ik bij Tolkie upload?
Uploaden gaat met de hand, via Pdf's in Mijn Tolkie. Er is geen API om pdf's automatisch te uploaden. Elke geüploade pdf krijgt een eigen link, die je kopieert met Link kopiëren. Meer daarover lees je in het artikel Pdf’s laten hosten bij Tolkie: hoe werkt dat?.
Werkt dit ook met ons CMS?
De Tolkie-link werkt met elk CMS, omdat het gewoon een link is. Bij Zig Websoftware is er al een standaardkoppeling, waarmee bij pdf's een leeshulpknop komt te staan. Werk je met een ander CMS, dan regelt je webbouwer het met de prefix zoals hierboven beschreven.
Heb ik hiervoor een API van Tolkie nodig?
Nee. Voor pdf-links is de prefix genoeg. De API's van Tolkie zijn bedoeld voor iets anders: je eigen systeem vraagt dan teksten op bij Tolkie, zoals een vertaling of een Simpele tekst. Meer daarover lees je in:
Vragen?
Mail [email protected] en vertel hoe jullie pdf's op de website staan. Dan denken we mee over de beste aanpak.
