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 de pdf's op een locatie staan die Tolkie heeft opengezet voor de pdf-viewer.
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:
In de template van de website zoekt hij alle links die naar een pdf verwijzen.
Voor die links zet hij 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? Dan codeert hij de url (url-encoding), zodat de viewer hem goed leest.
Hij 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.
De pdf moet op een locatie staan die Tolkie heeft opengezet voor de pdf-viewer. Staan jullie pdf's op een nieuwe plek, zoals een andere map, een ander domein of een opslagdienst? Geef die locatie dan door aan [email protected].
Sommige servers staan niet toe dat pdf's in een andere pdf-lezer openen. Dat is bijvoorbeeld zo 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.
Lees ook