Aller au contenu principal
LisibleDocumentation
Previewer en direct

Fonctionnalités

Recherche et navigation

Configurer Pagefind, la palette de commandes, les transitions Astro, la pagination et les parcours de lecture.

Lisible combine un HTML multipage statique avec une navigation client légère. Les liens restent standards et utilisables sans JavaScript ; ClientRouter ajoute les transitions et conserve certains états.1

Pagefind

Pagefind analyse dist/ après la génération Astro. L’index est segmenté par langue grâce à l’attribut <html lang> de chaque page.

Diagramme
100%
Rendu du diagramme...
Molette pour zoomer, glisser pour deplacer

En développement, l’index n’existe pas encore. Le plugin Vite local fournit un module de repli afin que bun run dev n’échoue pas et que la palette conserve ses actions.

Palette de commandes

La palette réunit :

  • la recherche plein texte ;
  • le changement de thème et de langue ;
  • la réinitialisation de l’accent ;
  • la copie de l’URL ;
  • les raccourcis vers Blog, Tags, Archives, Séries, À propos et RSS.

Elle se pilote au clavier avec les flèches, Entrée et Échap.

Transitions Astro

<ClientRouter /> intercepte les liens internes. Tout script qui dépend du DOM doit se réinitialiser sur astro:page-load, événement émis au premier affichage et après chaque navigation.2

document.addEventListener("astro:page-load", initFeature);
document.addEventListener("astro:before-swap", cleanupFeature);

La pagination limite la taille des listes. Les tags offrent un parcours thématique, les archives un parcours chronologique et les séries un parcours ordonné. Archives reste dans la navigation haute de chaque variante. Séries y apparaît uniquement lorsqu’au moins un article publié de la locale définit series; les deux liens sont absents du footer. L’index /series/ distribue ensuite les parcours disponibles. Lisez Images, tags et séries pour le frontmatter associé.

Références

Footnotes

  1. Astro garde des pages réelles et ajoute un routeur client optionnel ; le contenu reste servi comme HTML statique.

  2. Les scripts de module sont regroupés et ne se réexécutent pas automatiquement à chaque navigation client.

Documentation maintenue avec LisibleModifier cette page ↗

Actions

Recherchez une API, une commande ou un concept.