Fait avec Chinaski

offline.tt

offline.tt génère la page de repli hors ligne de la PWA, /<lang>/offline.html, générée par langue uniquement quand le mode PWA est activé. C'est la destination que le service worker sert quand un visiteur demande une page qui n'est ni fraîche en ligne ni en cache.

Ce qu'il rend

  • Le titre offline et le message offline issus de vos réglages PWA : les seuls boutons de contenu de la page (un h1 plus un paragraphe, rendus avec les partials header/footer du thème du site, la navigation, l'instantané de la sidebar et les coordonnées de l'organisation).
  • Un lien Retour à l'accueil vers l'URL racine de la langue.
  • La page est explicitement noindex : un repli hors ligne n'a jamais sa place dans les sitemaps ni les résultats de recherche.
  • Gestion RTL incluse (direction d'écriture honorée par langue, comme tous les templates du site).

Comment ça marche en pratique

Générée au moment du build parmi les artefacts PWA (aux côtés de manifest.json et sw.js), la page figure dans la liste de précache du service worker : ainsi tout visiteur ayant chargé le site une fois la porte avec lui, et le worker y route quand une navigation ne peut être servie ni fraîche ni depuis le cache.

Les changements de réglages (titre, message) déclenchent le rebuild habituel ; la page offline se regénère avec les autres artefacts PWA. Chaque langue a sa propre page : titre/message dans cette langue selon les surcharges, direction d'écriture gérée automatiquement.

Comportement de thème

  • Le template se réfère aux règles de recherche standard (répertoire du thème d'abord, repli intégré) et aux feuilles de style/complexion de votre thème ; les mêmes classes et partials que toute page générée.
  • Pour le re-styler entièrement pour votre thème, surchargez offline.tt (maintenez le même contrat de template : un title plus un offline_message dans le stash et l'ordre de routes standard head/header/footer ; conservez le drapeau noindex), la zone de contenu du message est ce que les visiteurs voient.

À ne pas confondre avec

  • La page 404 : une autre page utilitaire (servie pour les chemins réellement manquants ; offline.tt n'existe que pour le routage hors ligne de la PWA).
  • Un repli d'hôte général : les exemples d'hébergement servent /offline.html uniquement comme route PWA ; si votre hébergement a sa propre route 404, garder offline.html comme repli PWA distinct préserve les deux comportements.
Lisez ce site en