Avant de monter EmDash sous un sous-chemin : nous avons cliqué sur chaque adresse sous /field-notes

Après avoir défini base dans Astro, quelles adresses suivent le mouvement et lesquelles non, ainsi que quelques endroits à vérifier à la main avant la mise en ligne.

Placer un site sous example.com/field-notes/ plutôt que de lui donner un domaine entier est une demande courante : le site principal est un autre système, et le blog n’est qu’une section accrochée en dessous.

Le réglage correspondant dans Astro tient en une seule ligne, base. Nous pensions donc que ce guide serait court.

Puis nous avons créé un nouveau site avec le modèle de blog, défini base: "/field-notes", construit, démarré, et appelé chaque adresse avec curl. Il y avait plus à dire que cette seule ligne. Voici ce que nous avons réellement vu.

Environnement de test : EmDash 1.4.0, adaptateur Node, SQLite, modèle de blog officiel, avec les 8 articles d’exemple du modèle chargés via emdash seed.

export default defineConfig({
  output: "server",
  base: "/field-notes",
  // ...
});

Quelles adresses ont suivi base ?

D’abord la bonne nouvelle. Les pages elles-mêmes fonctionnent :

AdresseRésultat
/field-notes/200
/field-notes/posts200
/field-notes/rss.xml200
/field-notes/robots.txt200

Quelles adresses n’ont pas bougé ?

L’administration et l’API restent à leur place :

AdresseRésultat
/_emdash/api/health200
/_emdash/admin302, redirige vers /_emdash/admin/setup

Autrement dit, tout ce qui commence par /_emdash ne se déplace pas dans /field-notes. Votre règle de routage placée devant doit envoyer à cette application à la fois /field-notes/* et /_emdash/*. Si vous n’envoyez que la première, l’administration ne s’ouvrira pas.

Deux autres adresses que nous avons rencontrées méritent d’être mentionnées : /field-notes/_emdash/api/health et /field-notes/sitemap.xml renvoient toutes deux 500. Ce ne sont pas des adresses que l’on est censé visiter, mais si votre script de vérification fonctionne selon le principe « ajouter le préfixe et réessayer », elles vous feront peur.

Autre chose nous a surpris : le chemin racine / et /posts renvoient aussi 200. Le même contenu a donc deux entrées. Si vous ne voulez pas que les moteurs de recherche voient deux copies, faites en sorte que votre routage placé devant ne laisse passer que /field-notes/* et /_emdash/*, et rejette tout le reste.

Aucun lien des pages ne porte le préfixe

C’est le point auquel nous nous attendions le moins. Ouvrez la page d’accueil à /field-notes/ et affichez la source. Les liens ressemblent à ceci :

  • 7 articles : des choses comme /posts/a-weekend-with-a-side-project
  • 4 étiquettes : des choses comme /tag/opinion
  • la barre de navigation : /, /pages/about, /posts
  • ainsi que /rss.xml et /search

Aucun ne porte /field-notes. En cliquant, on quitte votre sous-chemin et on tombe sous le chemin racine.

Les liens proviennent de deux endroits, et ils se corrigent à des endroits différents :

  1. Écrits en dur dans le code du modèle. Par exemple href={`/tag/${t.slug}`} dans src/pages/posts/[slug].astro, et le href="/posts" qui apparaît dans plusieurs pages. Il faut les réécrire pour qu’ils commencent par import.meta.env.BASE_URL.
  2. Stockés dans la base de données. Les trois éléments de navigation ne sont pas écrits dans le modèle. Ce sont des données de menu, conservées dans la table _emdash_menu_items, et leurs adresses sont /, /pages/about et /posts. Si vous ne modifiez que le modèle, la barre de navigation ne bouge pas du tout. Il faut changer les adresses des éléments du menu eux-mêmes, ou modifier le fichier de seed et le recharger.

La façon dont ces liens sont écrits dans ce modèle est un choix du modèle lui-même. Ce n’est pas un problème causé par le réglage base. Nous n’avons pas non plus réécrit tout le modèle pour vérifier ensuite, donc nous ne pouvons ici que vous dire où chercher. Nous ne pouvons pas promettre que tout sera correct une fois ces liens modifiés.

Les adresses lues par les machines n’ont pas non plus de préfixe

En plus des liens que voient les humains, trois choses sont lues par des machines, et nous les avons regardées aussi :

  • Les adresses listées dans /sitemap.xml ressemblent à .../sitemap-posts.xml, et les adresses d’articles qu’il contient à .../posts/the-case-for-static. Aucune ne contient /field-notes.
  • Le <link> de chaque entrée du flux RSS est de même .../posts/....
  • Le /robots.txt de la racine contient Disallow: /_emdash/ et pointe vers le plan du site, tandis que /field-notes/robots.txt ne contient que User-agent: * et Allow: /, sans le blocage de /_emdash/ ni le plan du site.

Le dernier point mérite réflexion : les moteurs de recherche ne lisent robots.txt qu’à la racine du domaine. Celui placé sous le sous-chemin n’est, en pratique, lu par personne. Si votre site principal n’est pas EmDash, vous devez bloquer vous-même /_emdash/ dans le robots.txt du site principal.

L’absence de préfixe dans le plan du site et dans le RSS signifie que les adresses que vous soumettez aux moteurs de recherche seront des adresses extérieures au sous-chemin. Nous n’avons fait qu’observer le comportement. Nous n’avons pas cherché quelle ligne de code le détermine.

Le mode développement vous égare

Nous avons d’abord testé avec astro dev, et voici ce que nous avons obtenu :

  • /_emdash/api/health a renvoyé 500, avec Cannot read properties of undefined (reading 'registry') dans le journal.
  • /sitemap.xml a renvoyé 500, avec pour contenu EmDash not configured.

Nous avons cru que base avait cassé l’exécution. En supprimant base, les deux adresses sont revenues à 200, ce qui nous a confortés.

Jusqu’à ce que nous passions à astro build d’abord, puis à un démarrage avec node ./dist/server/entry.mjs. Avec base défini, les deux adresses ci-dessus renvoient 200.

Ne jugez donc pas en mode développement si un sous-chemin est bien configuré. Nous n’avons pas trouvé pourquoi les deux modes diffèrent.

Ce que nous cliquerions à la main avant la mise en ligne

  1. Construire, démarrer, et regarder avec curl la source de la page d’accueil de /field-notes/. Chercher les liens qui commencent par href="/ mais ne contiennent pas /field-notes.
  2. Ouvrir /_emdash/admin et confirmer que votre règle de routage placée devant l’envoie bien à l’application.
  3. Jeter un œil aux adresses dans sitemap.xml et rss.xml.
  4. Confirmer dans le robots.txt du site principal que /_emdash/ est bloqué.
  5. Visiter / et /posts, et décider si vous voulez qu’elles existent.

Ce que nous n’avons pas testé

  • Nous n’avons pas placé la règle de routage sur un vrai Cloudflare Worker ou nginx. Ce que nous disons plus haut sur la nécessité d’envoyer à la fois /field-notes/* et /_emdash/* est déduit du comportement observé.
  • Nous n’avons pas essayé l’adaptateur Cloudflare, seulement Node.
  • Nous n’avons pas réécrit les liens de tout le modèle.

Si vous pouvez vous passer d’un sous-chemin et utiliser un sous-domaine distinct, vous évitez l’essentiel de ce dont parle cet article.