Publicar Astro des de Git: Markdown i rutes estàtiques

Un quadern, un blog petit o un lloc de documentació poden convertir-se en fitxers HTML abans de rebre visites. Astro construeix contingut a partir de Markdown i components: després publiques el resultat estàtic sense mantenir el servidor de desenvolupament en marxa.

Aquesta guia fa servir Cuaderno orbital, un exemple original amb llicència MIT. Obre la portada publicada i la nota Markdown. Té CSS i una il·lustració propis; no inclou comptes, pagaments, API ni base de dades.

Si el web té traduccions, comprova les rutes i el canvi d’idioma a Astro. El diagnòstic utilitza un exemple local amb pàgines equivalents; no demostra un lliurament multilingüe natiu a Hostbrid.

Comprova que el projecte és estàtic

Revisa astro.config.mjs i els scripts de package.json. L’exemple declara output: 'static', no porta adaptador de servidor i el seu script build executa astro build. Genera els fitxers que necessita cada ruta.

Astro també pot renderitzar pàgines sota demanda. SSR, sessions, actions i endpoints actius necessiten un adaptador i un runtime compatible. Aquesta recepta només comprova la sortida estàtica. No eliminis funcions de backend per fer que una aplicació sembli compatible; consulta quin allotjament necessita una web creada amb IA i la referència oficial d’output.

Escriu una nota en Markdown

La nota és a src/pages/notas/primera-noche.md. El seu frontmatter conté el títol, la descripció i el layout que comparteix amb la portada. El contingut es transforma en HTML durant el build; la portada descobreix les notes amb import.meta.glob i mostra els seus títols i enllaços.

Comença editant la nota existent i conserva els camps de títol, descripció i layout. Un altre fitxer .md en aquesta carpeta genera una altra pàgina i permet que el llistat la descobreixi al següent build. Revisa també el text editorial del llistat si amplies el quadern. La documentació de Markdown d’Astro explica la diferència entre aquestes pàgines i les col·leccions de contingut amb esquema.

Canviar un fitxer al teu ordinador no canvia el lloc publicat. Desa la modificació a Git i fes una nova construcció mitjançant el flux del teu projecte.

Construeix amb versions reproduïbles

Fes un fork o copia el repositori mantenint la llicència. Inclou package.json, package-lock.json, astro.config.mjs, src i public; exclou node_modules i claus privades.

L’exemple fixa Astro 7.3.7. La guia oficial d’instal·lació requereix Node 22.12.0 o superior i no admet versions senars. El vam comprovar localment amb Node 22.23.3, indicat a .nvmrc. El preset d’Hostbrid es diu node22; aquest nom no identifica una versió patch exacta.

npm ci
npm run build

Busca dist/index.html, dist/notas/primera-noche/index.html i dist/orbital.svg. En aquest build petit, Astro incorpora el CSS als HTML: no cal trobar una carpeta CSS separada per saber que els estils s’han aplicat. npm run dev i npm run preview són eines locals.

Configura l’URL pública abans del build

En aquest exemple, la configuració llegeix PUBLIC_SITE_URL per establir site. Conté una URL pública, mai una contrasenya. La publicació verificada va utilitzar:

PUBLIC_SITE_URL=https://hostbrid-astro-demo.hostbrid.dev npm run build

Per a la teva còpia, fes servir la teva URL final, sense reutilitzar el domini de la demo. A Projects, configura aquesta variable abans de construir. Si no es defineix, l’exemple fa servir https://example.invalid i afegeix noindex: és una guarda per a proves locals, no una configuració per publicar un lloc indexable. Revisa canonical i robots després de cada canvi.

La variable no configura DNS i no és una opció que tots els repositoris Astro llegeixin automàticament. L’exemple està pensat per a l’arrel d’un domini; publicar-lo sota una subcarpeta exigeix adaptar base, enllaços i assets, i tornar-los a comprovar.

Selecciona el preset d’Astro a Projects

Segueix la documentació de Projects per connectar Git i revisar-ne els permisos. El repositori independent de l’exemple va utilitzar:

En un monorepo, indica la subcarpeta que conté package.json i la configuració. Publica el resultat de dist, no el codi font. Aquests ajustos coincideixen amb la guia oficial de desplegament.

Prova les rutes reals després de publicar

Escriu /notas/primera-noche/ directament al navegador i recarrega. Astro ja n’ha generat l’HTML: aquest exemple no necessita el marcador .hostbrid-spa ni un fallback a la portada. Una ruta que no s’ha generat ha de retornar 404, igual que un asset inexistent.

Verificat el 8 d’octubre de 2026: el commit e3bdd60 es va construir i publicar mitjançant Projects. Portada, nota i imatge van retornar 200, amb hashes iguals a l’artefacte i a les dues rèpliques d’allotjament. Chrome va comprovar les dues rutes a 390 i 1280 px, CSS, imatge, enllaços i navegació, sense overflow ni POST. Canonical feia servir el domini real; aquestes respostes no contenien meta noindex ni capçalera X-Robots-Tag. Rutes i assets absents van retornar 404. Això no demostra indexació per un cercador.

La prova va utilitzar un projecte propi i un build manual: no valida l’alta d’un client, el seu OAuth ni la publicació automàtica en rebre un push. Tampoc no demostra Astro SSR o serveis externs. Consulta Projects i els plans vigents per triar capacitat segons el teu compte i aplicació.