Problemen met doc-sites oplossen
Wat elke melding op een doc-site betekent en hoe je deze oplost: geweigerde of mislukte publicaties, paginastatussen, aangepaste domeinen, privé-sites, de assistent, gepauzeerde of offline sites, imports, het contactformulier en site-adressen.
Deze pagina bevat een overzicht van de meldingen die een doc-site aan jou of je lezers kan tonen, wat ze betekenen en wat je moet doen. Zoek de melding die je ziet of het onderwerp waar deze bij hoort: publiceren, pagina's, domeinen, privé-sites, de assistent, offline sites, imports, het contactformulier of het aanmaken van een site.
Publiceren
Een publicatie werd geweigerd
Deze verschijnen wanneer je op Publiceren klikt, voordat er iets wordt gebouwd. Je live site verandert niet.
| Melding | Oorzaak | Wat te doen |
|---|---|---|
| "Nothing to publish." | Alles is al live. | Niets; je wijzigingen zijn al doorgevoerd. |
| "Add pages before publishing." | De site heeft geen gereedstaande pagina's en nog niets live. | Voeg een pagina toe en voltooi deze zodat deze gereed is. |
| "Verify your email to publish." | Op het Free-abonnement heeft de persoon die publiceert het e-mailadres nog niet bevestigd. | Bevestig je e-mailadres via de link die Clevera je heeft gemaild. |
| "A publish is already running for this doc site." | Er is al een andere publicatie bezig. | Wacht tot deze klaar is. |
| "This doc site was published many times in the last hour. Try again in a few minutes." | Een site kan maximaal 60 keer per uur publiceren. | Wacht een paar minuten. Met automatisch publiceren aan, worden wijzigingen voor je gegroepeerd. |
| "Your plan doesn't include private doc sites. Make the site public or upgrade to publish it." | De site is privé en de workspace is overgezet naar een abonnement zonder privé-sites. | Zet Toegang op Openbaar, of upgrade naar Pro. |
| "Paused sites are read-only." | De site overschrijdt de site-limiet van je abonnement. | Zie Een site is gepauzeerd. |
| "This doc site is suspended. Contact support to restore it." | Clevera heeft de site offline gehaald. | Neem contact op met support. |
| "Publishing is temporarily unavailable. Your live site hasn't changed." | Publiceren is tijdelijk gepauzeerd aan onze kant. | Probeer het later opnieuw. |
| "Only admins and editors can publish." | Jouw rol kan pagina's bewerken maar niet publiceren. | Vraag het aan de eigenaar van de workspace, een beheerder of een redacteur. |
Een publicatie is mislukt
Wanneer een publicatie mislukt, behoudt de site de vorige versie: "Lezers zien nog steeds de laatste versie." Je ziet een banner, "Version n didn't publish", met See details. Bij Publiceren staat bij de mislukte versie "Couldn't publish this build." met de reden en Opnieuw proberen. De eigenaar, beheerders en redacteurs krijgen ook een "Publishing site failed"-melding, die per e-mail wordt verstuurd als deze na ongeveer 10 minuten nog niet is gelezen.
| Reden | Wat te doen |
|---|---|
| "We couldn't collect the site's content." | Opnieuw proberen. |
| "The site couldn't be built." | Opnieuw proberen. Neem contact op met support als het blijft mislukken. |
| "The site's files couldn't be saved." | Probeer het over een paar minuten opnieuw. |
| "Publishing took too long." | Opnieuw proberen. Neem contact op met support als dit blijft gebeuren. |
| "This publish is held for review." | Deze versie wordt gecontroleerd voordat deze live gaat. Neem contact op met support als deze in de wacht blijft staan. |
| "Publishing failed." | Opnieuw proberen. Neem contact op met support als het blijft mislukken. |
Een mislukte publicatie wordt niet automatisch opnieuw geprobeerd. Klik op Opnieuw proberen of publiceer opnieuw.
Waarschuwingen voordat je publiceert
Deze stoppen een publicatie niet. Ze worden getoond in het overzichtsblad zodat je ze eerst kunt oplossen.
| Waarschuwing | Wat te doen |
|---|---|
| "name is an AI draft nobody has reviewed. It won't publish until it's marked ready." | Open de site-pagina, controleer deze en zet Klaar om te publiceren aan. |
| "name still has n placeholders to fill." | Vul de placeholders tussen haakjes in. |
| "name is a legal page. Have it reviewed before you publish." | Laat iemand de juridische tekst controleren. |
| "n changes left out — they stay unpublished." | Je hebt wijzigingen uitgesloten van deze publicatie. Klik op Terugzetten om ze op te nemen. |
Na een publicatie kunnen de details van de build inhoudelijke problemen op je pagina's weergeven:
| Probleem | Wat te doen |
|---|---|
| "the link to page doesn't lead to a page on this site." | Herstel of verwijder de link. |
| "the link to page points to a heading that doesn't exist." | Update de link naar een bestaande kop. |
| "an image has no alt text." | Voeg een beschrijving toe aan de afbeelding. |
| "a heading is empty." | Schrijf de kop of verwijder deze. |
| "an image is larger than 5 MB; readers on slow connections wait for it." | Gebruik een kleinere afbeelding. |
| "title has no current export, so it plays through the Clevera player…" | Exporteer de video en publiceer opnieuw zodat deze vanaf de site zelf wordt afgespeeld. |
| "This video has no share link yet, so the page can't show the player." | Open de video en maak de deellink aan. |
| "An image (…) isn't from this workspace and was left out." | Upload de afbeelding naar deze workspace. |
Paginastatussen
Op Pagina's zie je per pagina de status:
| Status | Betekenis | Wat te doen |
|---|---|---|
| Niet gereed | Het artikel is nog niet af in de editor. | Voltooi het in de editor om het te publiceren. |
| Gewijzigd | Bewerkt sinds de laatste publicatie. | Publiceren. |
| Nog niet gepubliceerd | Toegevoegd sinds de laatste publicatie. | Publiceren. |
| Verborgen | Gepubliceerd, maar niet in de navigatie. | Zet Tonen in navigatie aan als lezers het in het menu moeten kunnen vinden. |
| Gepland | Gaat live op de ingestelde datum. | Niets. |
Aangepaste domeinen
Elke domeinmelding, met oorzaken en stapsgewijze oplossingen, staat in Een aangepast domein verbinden. De korte versie:
| Je ziet | Gebruikelijke oorzaak | Oplossing |
|---|---|---|
| Blijft hangen op Wachten op DNS | Het record staat bij de verkeerde DNS-host, de naam is dubbel (help.example.com.example.com), of het is nog niet verwerkt. |
Wachten op DNS |
| "Your CNAME points somewhere else" | Verkeerde waarde, of een oud A-, AAAA- of CNAME-record op dezelfde naam. | Het doel herstellen |
| "Your record goes through Cloudflare's proxy" | Het record is geproxied (oranje wolkje). | Zet dit op Alleen DNS. Details |
| "Your DNS provider flattens the CNAME" | Cloudflare "Flatten all CNAMEs" of de Flatten-schakelaar van het record, een ALIAS/ANAME-record of een Route 53 Alias. | Gebruik een gewoon CNAME-record. Details |
| "Our hosting provider couldn't confirm the domain" | Het record is in de afgelopen minuten gewijzigd, of het is geflat of geproxied. | Details |
| Blijft hangen op Certificaat uitgeven, of "The certificate wasn't issued" | Een CAA-record, een proxy of flattening blokkeert het certificaat. | Details |
| "Your CAA records block the certificate" | Je CAA-records staan Amazon niet toe. | Voeg 0 issue "amazon.com" toe. Details |
| "This domain is already used by another service" | Het domein is nog gekoppeld aan een andere hosting-setup, vaak je vorige docs-host. | Details |
| "This domain is connected to another Clevera site" | Een andere doc-site heeft of claimt het domein. | Voeg het TXT-record toe. Details |
| Lezers zien "403 ERROR" of "Not secure" | Normaal totdat het domein Live is, of nadat het is losgekoppeld. | Details |
| "Not found" direct na Live | De site wordt nog opnieuw gepubliceerd onder het nieuwe adres. | Wacht een paar minuten, doe een harde verversing. Details |
| "We can't find your CNAME record any more" | Het record is verwijderd, bewerkt, geproxied of geflat nadat het live ging. | Zet het binnen 14 dagen terug. Details |
| Domein "is paused" | Het abonnement bevat geen aangepaste domeinen meer, of de site is gepauzeerd. | Details |
| Een melding wanneer je op Verbinden klikt | Extra onderdelen in het adres, een root-domein, Free-abonnement, of de site heeft al een domein. | Verbindingsmeldingen |
Wachten is normaal: DNS-wijzigingen worden meestal binnen enkele minuten zichtbaar en kunnen tot een dag duren, en het certificaat duurt daarna meestal 5–30 minuten.
Privé-sites
Wat lezers zien op een site met een wachtwoord of inloggen via de workspace:
| Melding | Oorzaak | Wat te doen |
|---|---|---|
| "That password didn't work." | Verkeerd wachtwoord. | Deel het huidige wachtwoord opnieuw. |
| "Too many attempts. Wait a minute and try again." | Te veel verkeerde wachtwoorden in korte tijd. | Wacht even en probeer het opnieuw. |
| "You don't have access to this doc site" | De lezer is ingelogd met een account dat geen lid is van je workspace. | Nodig hen uit voor de workspace of vraag hen in te loggen met het account dat ze daar gebruiken. |
| "We can't sign you in right now. Try again in a few minutes." | Een tijdelijk probleem. | Probeer het later opnieuw. |
| Lezers wordt opnieuw om het wachtwoord gevraagd | Je hebt het wachtwoord gewijzigd, het toegangstype gewijzigd of op Meld iedereen af geklikt. | Deel het nieuwe wachtwoord. |
In de instellingen: een wachtwoord moet minimaal 10 tekens bevatten ("Use at least 10 characters."), en privé-sites zijn beschikbaar vanaf het Pro-abonnement. Zie Bepalen wie een doc-site kan lezen.
De AI-assistent
| Bericht | Waarom | Wat te doen |
|---|---|---|
| Lezers zien "De assistent is momenteel niet beschikbaar. Zoek in plaats daarvan in de documentatie." | De workspace heeft de maandelijkse antwoorden verbruikt, de site heeft het dagelijkse aandeel verbruikt, de lezer heeft vandaag 30 vragen gesteld, of er is een tijdelijk probleem. | Controleer Inzichten → Assistent. Upgraden, of wacht tot de reset op de 1e. |
| Lezers zien "Je verstuurt vragen te snel. Wacht even en probeer het dan opnieuw." | Vragen werden te snel verstuurd. | Wacht even. |
| "AI-antwoorden zijn gepauzeerd tot datum" | De workspace heeft de antwoorden voor de maand verbruikt. Lezers kunnen nog wel zoeken. | Upgraden voor meer antwoorden. |
| "Probeer de assistent op je gepubliceerde site." | Je bevindt je in het voorbeeld van de app. | Open de live site. |
| Geen Vraag AI op de site | De assistent staat uit, of is nog niet gepubliceerd. | Schakel Toon de assistent in en publiceer. |
Zie De doc site-assistent instellen.
Gepauzeerde, offline en opgeschorte sites
Een site is gepauzeerd
"Deze site is gepauzeerd omdat je abonnement minder doc sites bevat. De site is alleen-lezen en gaat offline op datum."
Je workspace heeft meer doc sites dan je abonnement toestaat, meestal na een downgrade. Gepauzeerde sites blijven online maar zijn alleen-lezen, en gaan 30 dagen later offline. Er wordt niets verwijderd. Klik op Kies sites om te behouden, of upgrade. Je ontvangt e-mails wanneer een site wordt gepauzeerd en voordat deze offline gaat. Zie Doc site-abonnementen en limieten.
Wat lezers zien
| Lezers zien | Waarom | Wat te doen |
|---|---|---|
| "Deze site is offline" / "De eigenaar heeft deze docs site offline gehaald." | De site is niet gepubliceerd, is na de offline-datum gepauzeerd, is privé op een abonnement zonder privé-sites, of is nooit gepubliceerd. | Publiceer de site, behoud deze, of upgrade. |
| "Deze site is niet beschikbaar" / "Deze docs site is opgeschort." | Clevera heeft de site opgeschort. | Neem contact op met support. |
| "Deze site is verwijderd" / "Er is geen docs site meer op dit adres." | De site is verwijderd, het domein is losgekoppeld, of een oud adres leidt niet meer door. | Deel het huidige adres. |
| "Pagina niet gevonden" | Er is niets gepubliceerd op dit adres. | Controleer het adres, of publiceer de site. |
| "Deze pagina bestaat niet" / "Misschien is de pagina verplaatst of bevat de link een typefout." | De pagina staat niet op de live site. | Voeg een omleiding toe vanaf het oude adres. |
Opgeschorte sites
"Deze site is door Clevera offline gehaald en is alleen-lezen. Neem contact op met support als je denkt dat dit een vergissing is."
Een opgeschorte site is offline en alleen-lezen, en de instellingen kunnen niet worden gewijzigd. De eigenaar van de workspace ontvangt een e-mail met de reden. Neem contact op met support om de site te herstellen.
Importeren en exporteren
| Bericht | Wat te doen |
|---|---|
| "Alleen de eigenaar van de workspace kan inhoud importeren of exporteren." | Vraag het aan de eigenaar. |
| "Dat token werkte niet. Controleer of het volledig is gekopieerd en leestoegang heeft, en probeer het dan opnieuw." | Maak een nieuw token aan met leestoegang. |
| "We konden de bron niet bereiken." / "We konden de bron niet vinden." | Controleer of het adres opent in een browser. |
| "De site heeft onze lezer geblokkeerd. We kunnen alleen openbare pagina's importeren." | Gebruik de API of zip-methode als die beschikbaar is. |
| "Het robots.txt-bestand van deze site vraagt crawlers om deze pagina's niet te lezen." | Sta lezen toe, of gebruik een andere methode. |
| "We hebben geen pagina's gevonden om te importeren." | Controleer of het adres naar de documentatie wijst en niet naar een marketingpagina. |
| "De bron beperkt hoe snel we kunnen lezen. Probeer het over een paar minuten opnieuw." | Wacht en begin opnieuw. |
| "Het importeren is onverwacht gestopt. Wat is geïmporteerd staat in het rapport; je kunt het ongedaan maken." | Open het rapport, maak het ongedaan als je wilt, en begin opnieuw. |
| "Sommige van deze pagina's staan live op je site, dus het importeren kan niet ongedaan worden gemaakt." | Verwijder in plaats daarvan de pagina's die je niet wilt. |
| "Je kunt maximaal 3 exports per dag aanvragen." | Wacht tot de getoonde tijd. |
Zie Een doc site importeren en exporteren.
Contactformulier
| Bericht | Wat te doen |
|---|---|
| Nog niet geverifieerd op de contactkaart | Klik op de link in de bevestigingsmail. Berichten worden pas bezorgd nadat je dit hebt gedaan. |
| "Deze link is verlopen" | Links werken 7 dagen. Klik op Opnieuw verzenden. |
| "Deze link is niet langer geldig" | Gebruik de nieuwste link, of klik op Opnieuw verzenden. |
| "We hebben minder dan een minuut geleden een link verstuurd. Controleer de inbox en probeer het dan opnieuw." | Wacht een minuut. |
| "We hebben het maximaal aantal bevestigingslinks voor vandaag verstuurd. Probeer het morgen opnieuw." | Je kunt 10 links per dag versturen. |
| "Het contactformulier is beschikbaar vanaf het Starter-abonnement." | Upgrade om het in te schakelen. |
| Lezers zien "Het bericht kon niet worden verzonden. Probeer het later opnieuw." | Een tijdelijk probleem; lezers kunnen het later opnieuw proberen. |
| Lezers zien "Je hebt meerdere berichten verstuurd. Probeer het later opnieuw." | Eén adres heeft in korte tijd meerdere berichten verstuurd. |
Zie Feedback en berichten van lezers verzamelen.
Een site en het adres aanmaken
| Bericht | Wat te doen |
|---|---|
| "Gebruik minimaal 6 tekens" / "Gebruik maximaal 40 tekens" | Adressen zijn 6–40 tekens lang. |
| "Gebruik kleine letters, cijfers en enkele koppeltekens" | Geen spaties, hoofdletters of dubbele koppeltekens, en geen koppelteken aan het begin of einde. |
| "Dit adres is gereserveerd" / "Dit adres is niet beschikbaar" | Kies een ander adres. |
| "Dit adres bevat een beschermde naam. Neem contact op met support als dit jouw merk is." | Neem contact op met support met bewijs dat het jouw merk is. |
| "Een andere site gebruikt dit adres al" | Kies een ander adres. |
| "Je abonnement bevat 1 doc site." | Upgrade, of verwijder een site die je niet nodig hebt. |
| "Je kunt maximaal 5 doc sites per dag aanmaken. Probeer het morgen opnieuw." | Wacht tot morgen. |
Kom je er nog steeds niet uit?
Neem contact op met Clevera support. Vermeld de naam van de site en het exacte bericht dat je ziet.