Troubleshooting: veelvoorkomende importproblemen
Het ZIP-bestand wordt geweigerd
Mogelijke oorzaken:
- Het bestand is groter dan 50 MB — verkleinen of splitsen in meerdere imports is de oplossing
- Het bestand is geen geldig ZIP-archief (bv. een
.rarof.7zbestand hernoemd naar.zip) — gebruik een echt ZIP-formaat - Het bestand is beschadigd — maak het ZIP-bestand opnieuw aan
Artikels komen op de verkeerde plek terecht
De bestemming in de content tree stel je in bij stap 1. Controleer of je de juiste doelmap hebt geselecteerd. Vergeet ook niet dat de mappenstructuur in je ZIP-bestand wordt overgenomen: als je bestanden in een submap /facturen/ staan in de ZIP, komen ze ook in een map "facturen" terecht op de gekozen bestemming.
Een bestaand artikel wordt niet bijgewerkt maar als nieuw aangemaakt
De import-tool herkent een bestaand artikel enkel als de combinatie van locatie én titel exact overeenkomt met wat er al in je content tree staat. Controleer:
- Staat het artikel in je ZIP-bestand op exact dezelfde relatieve pad als in de content tree?
- Is de bestandsnaam (en dus de titel) identiek, inclusief hoofdletters?
Als een van beide afwijkt, beschouwt Sarrai het als een nieuw artikel.
Interne links werken niet na de import
Als een Markdown-bestand een link bevat naar een ander bestand in dezelfde ZIP, probeert Sarrai die automatisch om te zetten naar een interne link. Dit lukt niet altijd, bijvoorbeeld als het doelbestand niet mee in de ZIP zit of als het pad in de link niet klopt.
Je ziet bij zulke artikels een waarschuwing in de preview (stap 2). Na de import kan je die artikels handmatig openen en de links corrigeren. Meer info: Artikels bewerken
Artikels staan in de verkeerde taal
De taalinstelling in stap 1 geldt voor alle artikels in die import. Heb je artikels in meerdere talen? Importeer ze dan in aparte batches en stel per batch de juiste taal in.
Artikels zijn gepubliceerd terwijl ze als draft hadden moeten worden opgeslagen (of omgekeerd)
De publicatiestatus stel je in bij stap 1. Als je hier een verkeerde keuze hebt gemaakt, kan je na de import elk artikel afzonderlijk terugzetten naar draft of alsnog publiceren. Meer info: Drafts en publiceren
Speciale tekens of opmaak worden niet correct weergegeven
Zorg dat je Markdown-bestanden zijn opgeslagen in UTF-8 encoding. Bestanden in een andere encoding (bv. Windows-1252) kunnen problemen geven met accenten en speciale tekens. De meeste teksteditors laten je de encoding instellen bij het opslaan.
De import lijkt te hangen of duurt erg lang
Grotere ZIP-bestanden hebben meer verwerkingstijd nodig. Wacht de import rustig af en ververs de pagina niet. Als de import na een langere tijd nog steeds geen resultaat toont, sluit de wizard dan en controleer in de content tree of er al items zijn aangemaakt. Probeer eventueel een kleinere batch.