Versionado

Actualizado el 12 nov 2026

Livemark no tiene una función de versionado dedicada: las piezas que ya ofrece cubren los dos casos habituales. Elige según lo distintas que sean tus versiones:

• Un sitio, una sección por versión: unas pocas versiones cuya documentación vive en una misma rama.
• Un despliegue por versión: versiones mayores de larga duración mantenidas en sus propias ramas.

La mayoría de los proyectos solo necesitan mantener la documentación más reciente y la de la versión mayor anterior. Si de las versiones antiguas solo necesitas las notas, basta con una sección de registro de cambios.

Una sección por versión

Guarda los artículos de cada versión antigua en su propia carpeta y dales paths bajo un prefijo de versión. La documentación actual se queda en / y cada versión antigua se convierte en una sección:

docs/
  getting-started.md   # path: /getting-started/
v1/
  getting-started.md   # path: /v1/getting-started/

import { defineConfig } from "livemark"

export default defineConfig({
  title: "Acme",
  include: ["docs/**/*.md", "v1/**/*.md"],
  sections: [
    { title: "Docs", prefix: "/" },
    {
      title: "v1",
      prefix: "/v1/",
      icon: "archive",
      siteTitle: "Acme v1",
    },
  ],
})

La coincidencia por prefijo más largo envía cada artículo /v1/… a la sección v1, que obtiene su propio árbol en la barra lateral mientras el resto del sitio mantiene la documentación actual. siteTitle cambia la marca junto al logo dentro de esa sección, para que el lector siempre vea en qué versión está. Define position: "sidebar" para sacar las pestañas de versión de la cabecera.

Para avisar a los lectores en las páginas antiguas, empieza cada una con un aviso:

:::warning
You are reading the docs for v1. [See the latest version](/getting-started/).
:::

Conviene saber:

• La búsqueda indexa todo el sitio, así que los resultados incluyen los artículos de todas las versiones.
• Copiar una carpeta por versión duplica contenido; congela la carpeta antigua y corrígela solo cuando sea necesario.

Un despliegue por versión

Cuando cada versión mayor vive en su propia rama (main, v1, …), compila cada rama como un sitio independiente y sírvelo desde su propia dirección: un subdominio (v1.docs.example.com) o una subruta (docs.example.com/v1/) con base.

import { defineConfig } from "livemark"

export default defineConfig({
  site: "https://docs.example.com/v1",
  base: command => (command === "build" ? "/v1" : undefined),
  title: "Acme v1",
  banner: "You are reading the v1 docs · [Go to the latest →](https://docs.example.com/)",
  include: "docs/**/*.md",
})

Enlaza los despliegues entre sí con una sección custom o un enlace en la cabecera, que hace de selector de versión:

sections: [
  { title: "Docs", prefix: "/" },
  { title: "v1", type: "custom", url: "https://docs.example.com/v1/", icon: "archive" },
]

Cada despliegue tiene su propio índice de búsqueda, sitemap y llms.txt, así que las versiones nunca se mezclan. El coste es una compilación y un job de CI por cada rama mantenida; consulta Despliegue para configurar el hosting. La mayoría de los hostings despliegan las ramas en sus propias URL sin configuración adicional.

Ver también

• Secciones de artículos: tipos de sección, prefijos y coincidencia.
• Metadatos del sitio: los campos banner, title y site usados arriba.