Résoudre les problèmes de site de documentation
Signification des messages sur les sites de documentation et comment les résoudre : publications refusées ou échouées, statuts des pages, domaines personnalisés, sites privés, l'assistant, sites en pause ou hors ligne, importations, formulaire de contact et adresses de site.
Cette page répertorie les messages qu'un site de documentation peut afficher pour vous ou vos lecteurs, leur signification et la marche à suivre. Trouvez le message que vous voyez ou la section concernée : publication, pages, domaines, sites privés, l'assistant, sites hors ligne, importations, formulaire de contact ou création de site.
Publication
Une publication a été refusée
Ces messages apparaissent lorsque vous cliquez sur Publier, avant que la construction ne commence. Votre site en ligne n'est pas modifié.
| Message | Raison | Marche à suivre |
|---|---|---|
| "Nothing to publish." | Tout est déjà en ligne. | Aucune ; vos modifications sont publiées. |
| "Add pages before publishing." | Le site ne contient aucune page prête et rien n'est encore en ligne. | Ajoutez une page et terminez-la pour qu'elle soit prête. |
| "Verify your email to publish." | Sur le forfait Gratuit, la personne qui publie n'a pas confirmé son adresse e-mail. | Confirmez votre adresse e-mail via le lien envoyé par Clevera. |
| "A publish is already running for this doc site." | Une autre publication est en cours. | Attendez qu'elle se termine. |
| "This doc site was published many times in the last hour. Try again in a few minutes." | Un site peut être publié jusqu'à 60 fois par heure. | Attendez quelques minutes. Avec la publication automatique activée, les modifications sont regroupées pour vous. |
| "Your plan doesn't include private doc sites. Make the site public or upgrade to publish it." | Le site est privé et l'espace de travail a basculé sur un forfait sans sites privés. | Réglez l'Accès sur Public ou passez au forfait Pro. |
| "Paused sites are read-only." | Le site dépasse la limite de sites de votre forfait. | Consultez Un site est en pause. |
| "This doc site is suspended. Contact support to restore it." | Clevera a mis le site hors ligne. | Contactez le support. |
| "Publishing is temporarily unavailable. Your live site hasn't changed." | La publication est temporairement suspendue de notre côté. | Réessayez plus tard. |
| "Only admins and editors can publish." | Votre rôle permet de modifier les pages mais pas de publier. | Demandez au propriétaire de l'espace de travail, à un administrateur ou à un éditeur. |
Une publication a échoué
Lorsqu'une publication échoue, le site conserve la version précédente : "Les lecteurs voient toujours la dernière version." Vous voyez une bannière, "Version n didn't publish", avec See details. Dans Publication, la version ayant échoué indique "Couldn't publish this build." avec la raison et Réessayer. Le propriétaire, les administrateurs et les éditeurs reçoivent également une notification "Publishing site failed", envoyée par e-mail si elle n'est pas lue après environ 10 minutes.
| Raison | Marche à suivre |
|---|---|
| "We couldn't collect the site's content." | Réessayez. |
| "The site couldn't be built." | Réessayez. Contactez le support si l'échec persiste. |
| "The site's files couldn't be saved." | Réessayez dans quelques minutes. |
| "Publishing took too long." | Réessayez. Contactez le support si cela se reproduit. |
| "This publish is held for review." | Cette version est vérifiée avant d'être mise en ligne. Contactez le support si elle reste bloquée. |
| "Publishing failed." | Réessayez. Contactez le support si l'échec persiste. |
Une publication échouée ne se relance pas automatiquement. Cliquez sur Réessayer ou publiez à nouveau.
Avertissements avant de publier
Ils n'empêchent pas la publication. Ils apparaissent dans la fiche de révision pour vous permettre de les corriger au préalable.
| Avertissement | Marche à suivre |
|---|---|
| "name is an AI draft nobody has reviewed. It won't publish until it's marked ready." | Ouvrez la page du site, révisez-la et activez Prêt à publier. |
| "name still has n placeholders to fill." | Remplissez les espaces réservés entre crochets. |
| "name is a legal page. Have it reviewed before you publish." | Faites relire le texte juridique. |
| "n changes left out — they stay unpublished." | Vous avez exclu des modifications de cette publication. Cliquez sur Put back pour les inclure. |
Après une publication, les détails du build peuvent lister des problèmes de contenu sur vos pages :
| Problème | Marche à suivre |
|---|---|
| "the link to page doesn't lead to a page on this site." | Corrigez ou supprimez le lien. |
| "the link to page points to a heading that doesn't exist." | Mettez à jour le lien vers un titre existant. |
| "an image has no alt text." | Ajoutez une description à l'image. |
| "a heading is empty." | Rédigez le titre ou supprimez-le. |
| "an image is larger than 5 MB; readers on slow connections wait for it." | Utilisez une image plus légère. |
| "title has no current export, so it plays through the Clevera player…" | Exportez la vidéo, puis publiez à nouveau pour qu'elle soit lue depuis le site lui-même. |
| "This video has no share link yet, so the page can't show the player." | Ouvrez la vidéo et créez son lien de partage. |
| "An image (…) isn't from this workspace and was left out." | Importez l'image dans cet espace de travail. |
Consultez Publier un site de documentation.
Statuts des pages
Dans Pages, chaque page indique son état :
| Statut | Signification | Marche à suivre |
|---|---|---|
| Pas prêt | L'article n'est pas terminé dans l'éditeur. | Terminez-le dans l'éditeur pour le publier. |
| Modifié | Modifié depuis la dernière publication. | Publiez. |
| Pas encore publié | Ajouté depuis la dernière publication. | Publiez. |
| Masqué | Publié, mais absent de la navigation. | Activez Afficher dans la navigation si les lecteurs doivent le trouver dans le menu. |
| Planifié | Sera mis en ligne à la date prévue. | Aucune. |
Domaines personnalisés
Chaque message relatif aux domaines, avec ses causes et ses solutions étape par étape, se trouve dans Connecter un domaine personnalisé. En résumé :
| Ce que vous voyez | Cause habituelle | Solution |
|---|---|---|
| Bloqué sur En attente du DNS | L'enregistrement est chez le mauvais hébergeur DNS, le nom est en double (help.example.com.example.com) ou il n'est pas encore apparu. |
En attente du DNS |
| "Your CNAME points somewhere else" | Valeur incorrecte, ou ancien enregistrement A, AAAA ou CNAME sur le même nom. | Corriger la cible |
| "Your record goes through Cloudflare's proxy" | L'enregistrement est en mode Proxy (nuage orange). | Réglez-le sur DNS only. Détails |
| "Your DNS provider flattens the CNAME" | Option "Flatten all CNAMEs" de Cloudflare ou commutateur Flatten de l'enregistrement, enregistrement ALIAS/ANAME ou Alias Route 53. | Utilisez un CNAME simple. Détails |
| "Our hosting provider couldn't confirm the domain" | L'enregistrement a changé il y a quelques minutes, ou il est aplati (flattened) ou en proxy. | Détails |
| Bloqué sur Émission du certificat, ou "The certificate wasn't issued" | Un enregistrement CAA, un proxy ou un aplatissement bloque le certificat. | Détails |
| "Your CAA records block the certificate" | Vos enregistrements CAA n'autorisent pas Amazon. | Ajoutez 0 issue "amazon.com". Détails |
| "This domain is already used by another service" | Le domaine est toujours lié à une autre configuration d'hébergement, souvent votre ancien hébergeur de documentation. | Détails |
| "This domain is connected to another Clevera site" | Un autre site de documentation possède ou détient le domaine. | Ajoutez l'enregistrement TXT. Détails |
| Les lecteurs voient "403 ERROR" ou "Not secure" | Normal jusqu'à ce que le domaine soit En ligne, ou après sa déconnexion. | Détails |
| "Not found" juste après En ligne | Le site est en cours de republication sous la nouvelle adresse. | Attendez quelques minutes, faites un rafraîchissement forcé. Détails |
| "We can't find your CNAME record any more" | L'enregistrement a été supprimé, modifié, mis en proxy ou aplati après la mise en ligne. | Remettez-le en place sous 14 jours. Détails |
| Domain "is paused" | Le forfait n'inclut plus les domaines personnalisés, ou le site est en pause. | Détails |
| Un message en cliquant sur Connecter | Parties supplémentaires dans l'adresse, domaine racine, forfait Gratuit ou site ayant déjà un domaine. | Messages de connexion |
L'attente est normale : les modifications DNS apparaissent généralement en quelques minutes et peuvent prendre jusqu'à une journée, et l'émission du certificat prend généralement 5 à 30 minutes après cela.
Sites privés
Ce que les lecteurs voient sur un site protégé par mot de passe ou connexion à l'espace de travail :
| Message | Raison | Marche à suivre |
|---|---|---|
| "That password didn't work." | Mot de passe incorrect. | Partagez à nouveau le mot de passe actuel. |
| "Too many attempts. Wait a minute and try again." | Trop de mots de passe erronés en peu de temps. | Attendez, puis réessayez. |
| "You don't have access to this doc site" | Le lecteur s'est connecté avec un compte qui n'est pas membre de votre espace de travail. | Invitez-le dans l'espace de travail ou demandez-lui de se connecter avec le compte utilisé à cet effet. |
| "We can't sign you in right now. Try again in a few minutes." | Problème temporaire. | Réessayez plus tard. |
| Les lecteurs doivent à nouveau saisir le mot de passe | Vous avez modifié le mot de passe, le type d'accès ou cliqué sur Déconnecter tout le monde. | Partagez le nouveau mot de passe. |
Dans les paramètres : un mot de passe doit comporter au moins 10 caractères ("Use at least 10 characters."), et les sites privés sont disponibles à partir du forfait Pro. Consultez Contrôler qui peut lire un site de documentation.
L'assistant IA
| Message | Pourquoi | Que faire |
|---|---|---|
| Les lecteurs voient "L'assistant n'est pas disponible pour le moment. Recherchez plutôt dans la documentation." | L'espace de travail a utilisé ses réponses mensuelles, le site a atteint sa limite de partage quotidienne, le lecteur a posé 30 questions aujourd'hui, ou il s'agit d'un problème temporaire. | Vérifiez Analyses → Assistant. Mettez à niveau ou attendez la réinitialisation le 1er du mois. |
| Les lecteurs voient "Vous envoyez des questions trop rapidement. Attendez un instant, puis réessayez." | Questions envoyées trop rapidement. | Attendez un instant. |
| "Les réponses de l'IA sont suspendues jusqu'au date" | L'espace de travail a utilisé ses réponses pour le mois. Les lecteurs peuvent toujours effectuer des recherches. | Mettre à niveau pour obtenir plus de réponses. |
| "Essayez l'assistant sur votre site publié." | Vous êtes dans l'aperçu de l'application. | Ouvrez le site en ligne. |
| Pas d'option Demander à l'IA sur le site | L'assistant est désactivé ou n'est pas encore publié. | Activez Afficher l'assistant et publiez. |
Consultez Configurer l'assistant du site de documentation.
Sites suspendus, hors ligne et en pause
Un site est en pause
"Ce site est en pause car votre forfait inclut moins de sites de documentation. Il est en lecture seule et sera hors ligne le date."
Votre espace de travail possède plus de sites de documentation que ce que permet votre forfait, généralement après un déclassement. Les sites en pause restent en ligne mais en lecture seule, et deviennent hors ligne 30 jours plus tard. Rien n'est supprimé. Cliquez sur Choisir les sites à conserver ou mettez à niveau. Vous recevez des e-mails lorsqu'un site est mis en pause et avant qu'il ne devienne hors ligne. Consultez Forfaits et limites des sites de documentation.
Ce que voient les lecteurs
| Ce que voient les lecteurs | Pourquoi | Que faire |
|---|---|---|
| "Ce site est hors ligne" / "Le propriétaire a mis ce site de documentation hors ligne." | Le site n'est pas publié, a été mis en pause après sa date de mise hors ligne, est privé sur un forfait sans sites privés, ou n'a jamais été publié. | Publiez-le, conservez-le ou mettez à niveau. |
| "Ce site est indisponible" / "Ce site de documentation a été suspendu." | Clevera a suspendu le site. | Contactez le support. |
| "Ce site a été supprimé" / "Il n'y a plus de site de documentation à cette adresse." | Le site a été supprimé, le domaine a été déconnecté ou une ancienne adresse a cessé de rediriger. | Partagez l'adresse actuelle. |
| "Page introuvable" | Rien n'est publié à cette adresse. | Vérifiez l'adresse ou publiez le site. |
| "Cette page n'existe pas" / "Elle a peut-être été déplacée ou le lien contient une erreur." | La page n'est pas sur le site en ligne. | Ajoutez une redirection depuis l'ancienne adresse. |
Sites suspendus
"Ce site a été mis hors ligne par Clevera et est en lecture seule. Contactez le support si vous pensez qu'il s'agit d'une erreur."
Un site suspendu est hors ligne et en lecture seule, et ses paramètres ne peuvent pas être modifiés. Le propriétaire de l'espace de travail reçoit un e-mail expliquant la raison. Contactez le support pour le restaurer.
Importations et exportations
| Message | Que faire |
|---|---|
| "Seul le propriétaire de l'espace de travail peut importer ou exporter du contenu." | Demandez au propriétaire. |
| "Ce jeton n'a pas fonctionné. Vérifiez qu'il a été copié en entier et qu'il dispose d'un accès en lecture, puis réessayez." | Créez un nouveau jeton avec accès en lecture. |
| "Nous n'avons pas pu atteindre la source." / "Nous n'avons pas pu trouver la source." | Vérifiez que l'adresse s'ouvre dans un navigateur. |
| "Le site a bloqué notre lecteur. Nous ne pouvons importer que des pages publiques." | Utilisez l'API ou la méthode zip s'il y en a une. |
| "Le fichier robots.txt de ce site demande aux robots d'indexation de ne pas lire ces pages." | Autorisez la lecture ou utilisez une autre méthode. |
| "Nous n'avons trouvé aucune page à importer." | Vérifiez que l'adresse pointe vers la documentation et non vers une page marketing. |
| "La source limite la vitesse de lecture. Réessayez dans quelques minutes." | Attendez et recommencez. |
| "L'importation s'est arrêtée de manière inattendue. Ce qui a été importé se trouve dans le rapport ; vous pouvez l'annuler." | Ouvrez le rapport, annulez si vous le souhaitez et recommencez. |
| "Certaines de ces pages sont en ligne sur votre site, l'importation ne peut donc pas être annulée." | Supprimez plutôt les pages que vous ne voulez pas. |
| "Vous pouvez demander jusqu'à 3 exportations par jour." | Attendez jusqu'à l'heure indiquée. |
Consultez Importer et exporter un site de documentation.
Formulaire de contact
| Message | Que faire |
|---|---|
| Pas encore vérifié sur la carte de contact | Cliquez sur le lien dans l'e-mail de confirmation. Les messages ne sont pas envoyés tant que vous ne l'avez pas fait. |
| "Ce lien a expiré" | Les liens fonctionnent pendant 7 jours. Cliquez sur Renvoyer. |
| "Ce lien n'est plus valide" | Utilisez le lien le plus récent ou cliquez sur Renvoyer. |
| "Nous avons envoyé un lien il y a moins d'une minute. Vérifiez votre boîte de réception, puis réessayez." | Attendez une minute. |
| "Nous avons envoyé le nombre maximal de liens de confirmation autorisés aujourd'hui. Réessayez demain." | Vous pouvez envoyer 10 liens par jour. |
| "Le formulaire de contact est disponible à partir du forfait Starter." | Mettez à niveau pour l'activer. |
| Les lecteurs voient "Le message n'a pas pu être envoyé. Veuillez réessayer plus tard." | Un problème temporaire ; les lecteurs peuvent réessayer. |
| Les lecteurs voient "Vous avez envoyé plusieurs messages. Veuillez réessayer plus tard." | Une adresse a envoyé plusieurs messages en peu de temps. |
Consultez Collecter les commentaires et messages des lecteurs.
Création d'un site et de son adresse
| Message | Que faire |
|---|---|
| "Utilisez au moins 6 caractères" / "Utilisez 40 caractères ou moins" | Les adresses font entre 6 et 40 caractères. |
| "Utilisez des lettres minuscules, des chiffres et des traits d'union simples" | Pas d'espaces, de majuscules ou de doubles traits d'union, et pas de trait d'union au début ou à la fin. |
| "Cette adresse est réservée" / "Cette adresse n'est pas disponible" | Choisissez une autre adresse. |
| "Cette adresse contient un nom protégé. Contactez le support s'il s'agit de votre marque." | Contactez le support avec une preuve qu'il s'agit de votre marque. |
| "Un autre site utilise déjà cette adresse" | Choisissez une autre adresse. |
| "Votre forfait inclut 1 site de documentation." | Mettez à niveau ou supprimez un site dont vous n'avez pas besoin. |
| "Vous pouvez créer jusqu'à 5 sites de documentation par jour. Réessayez demain." | Attendez demain. |
Consultez Créer un site de documentation.
Toujours bloqué ?
Contactez le support Clevera. Incluez le nom du site et le message exact que vous voyez.