GitHub Pages

Actualizado el 12 nov 2026

GitHub Pages sirve un directorio de archivos estáticos con una de dos formas de URL:

• Sitio de usuario u organización: https://<user>.github.io/, servido desde un repositorio llamado <user>.github.io. Sin subruta.
• Sitio de proyecto: https://<user>.github.io/<repo>/, servido desde cualquier otro repositorio. El prefijo /<repo>/ importa: las rutas y las URLs de los recursos deben incluirlo.

Compila el sitio

livemark build

La salida queda en .livemark/build/client/.

Configura base para sitios de proyecto

Si publicas bajo https://<user>.github.io/<repo>/, define el campo base para que cada ruta y URL de recurso lleve el prefijo correcto. La forma de función mantiene simple el desarrollo: livemark start sigue sirviendo en / y solo la compilación de producción se monta bajo /<repo>/:

import { defineConfig } from "livemark"

export default defineConfig({
  site: "https://acme.github.io/my-docs",
  base: command => (command === "build" ? "/my-docs" : undefined),
})

Para sitios de usuario u organización en la raíz, omite base por completo.

Despliega manualmente

El despliegue puntual más sencillo usa el paquete gh-pages:

livemark build
gh-pages -d .livemark/build/client

Esto sube la compilación a la rama gh-pages. En la configuración de tu repositorio, define Pages → Source como "Deploy from a branch" y elige gh-pages / / (root).

Despliega con GitHub Actions

Las acciones oficiales de Pages son el camino más limpio: sin rama adicional ni tokens de servicio:

name: deploy

on:
  push:
    branches: [main]

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          cache: pnpm
          node-version: 24
      - run: pnpm install
      - run: pnpm livemark build
      - uses: actions/upload-pages-artifact@v3
        with:
          path: .livemark/build/client

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - uses: actions/deploy-pages@v4
        id: deployment

Define Pages → Source como "GitHub Actions" en la configuración de tu repositorio.

Dominio personalizado

Añade un archivo CNAME con tu dominio en .livemark/public/:

docs.example.com

Todo lo que hay en .livemark/public/ se copia tal cual a la salida de compilación, así que el archivo acaba en la raíz de tu despliegue. Configura el DNS en tu registrador (un registro CNAME que apunte a <user>.github.io) y define el dominio en Pages → Custom domain.

Ver también

• Metadatos del sitio: site es necesario para las URLs absolutas en el sitemap, RSS y las etiquetas Open Graph.
• Despliegue: vuelve al índice de hostings.