# Secciones de artículos > Organiza los artículos en secciones de Docs, Blog y registro de cambios. Una sección es un grupo de artículos que comparten un prefijo de URL, una barra lateral y una pestaña de navegación. Livemark incluye tres tipos de sección, más uno personalizado que es solo una pestaña: - **Article**: el tipo por defecto. Un árbol de artículos con una barra lateral plegable. - **Blog**: entradas ordenadas por fecha con etiquetas y un índice generado automáticamente. - **Changelog**: un único archivo fuente (o las releases de GitHub) dividido en un artículo por versión. - **Custom**: una pestaña que enlaza a cualquier URL, interna o externa, sin artículos propios. ## Uso básico {#basic-usage} ```typescript title="livemark.config.ts" import { defineConfig } from "livemark" export default defineConfig({ site: "https://example.com", include: ["docs/**/*.md", "blog/**/*.md"], sections: [ { title: "Docs", prefix: "/" }, { title: "Blog", prefix: "/blog/", type: "blog" }, { title: "Changelog", prefix: "/changelog/", type: "changelog", source: "CHANGELOG.md", version: true, }, ], }) ``` Si se omite `sections`, todos los artículos se renderizan en una única sección por defecto, algo útil para sitios pequeños. ## Campos comunes {#common-fields} Toda sección, sea del tipo que sea, acepta: | Campo | Tipo | Por defecto | Propósito | | ----------------- | ------------------------------------------------ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `title` | `string` | — | Etiqueta de la pestaña de la sección y de la cabecera de la barra lateral. | | `prefix` | `string` | — | Prefijo de URL (p. ej. `/`, `/blog/`, `/changelog/`). Los artículos con `path` coincidentes se enrutan aquí. Todos los tipos salvo `custom`. | | `type` | `"article" \| "blog" \| "changelog" \| "custom"` | `"article"` | Tipo de sección. | | `icon` | `string` | — | Icono de Lucide mostrado junto al título. Sin él, la pestaña no lleva icono. | | `position` | `"header" \| "sidebar"` | `"header"` | Dónde se renderiza la pestaña de la sección. | | `siteTitle` | `string` | — | Sustituye el `title` del sitio en la cabecera de la barra lateral y en las migas de pan mientras estás en la sección, y titula su feed RSS. | | `siteDescription` | `string` | — | Sustituye la `description` del sitio en la cabecera de la barra lateral mientras estás en la sección, y describe su feed RSS. | | `siteLink` | `string` | página de inicio | A dónde enlaza el título del sitio mientras estás en la sección: una ruta interna o una URL absoluta. | Cuando las secciones y los enlaces de la cabecera no caben, el campo de búsqueda se reduce a un icono y después los que siguen sin caber se agrupan en un menú **Más**. En móvil, todas las secciones se pliegan en la barra lateral. Dentro de una sección se convierten en un selector que abre una hoja inferior: al elegir una, la barra lateral muestra los artículos, entradas o versiones de esa sección sin salir de la página actual. ## Secciones de artículos {#article-sections} Documentación simple. La barra lateral muestra el árbol de artículos. Es el tipo por defecto, así que puedes omitir `type` por completo: ```typescript { title: "Docs", prefix: "/" } ``` ## Secciones de blog {#blog-sections} Las secciones de blog ordenan los artículos por `date` (los más recientes primero), renderizan un índice generado automáticamente en el prefijo de la sección y ofrecen páginas por etiqueta. ```typescript { title: "Blog", prefix: "/blog/", type: "blog", } ``` Luego, en cada entrada: ```yaml --- title: Announcing v0.3 date: 2026-04-15 tags: [announcement, release] --- ``` Livemark genera automáticamente: - `/blog/`: índice con todas las entradas, las más recientes primero. - `/blog/tags//`: una página por etiqueta. ## Secciones de registro de cambios {#changelog-sections} Una sección de registro de cambios lee de un archivo `source` y lo divide en un artículo por cada encabezado `##`. ```typescript { title: "Changelog", prefix: "/changelog/", type: "changelog", source: "CHANGELOG.md", version: true, } ``` Un encabezado como `## 0.3.0 — 2026-04-01` se convierte en un artículo en `/changelog/0-3-0/`, nombrado según su primera palabra. Con `version: true`, la pestaña de la sección en la cabecera muestra además la última versión entre paréntesis. Un sitio puede declarar varias secciones de registro de cambios —por ejemplo, una por paquete en un monorepo— siempre que cada una tenga su propio `prefix`. Cada una renderiza sus propias páginas de versión bajo su prefijo, su propia lista de versiones en la barra lateral y su propia última versión, de modo que dos registros de cambios que contengan `0.2.0` producen `/changelog/0-2-0/` y `/python/changelog/0-2-0/` uno al lado del otro. ```typescript sections: [ { title: "Changelog", prefix: "/changelog/", type: "changelog", source: "CHANGELOG.md", }, { title: "Python Changelog", prefix: "/python/changelog/", type: "changelog", source: "python/CHANGELOG.md", }, ] ``` Campos específicos del registro de cambios: | Campo | Tipo | Por defecto | Propósito | | --------- | --------- | ----------- | ----------------------------------------------------------------------------------- | | `source` | `string` | — | Ruta al archivo fuente del registro de cambios, relativa a la raíz del proyecto. | | `version` | `boolean` | `false` | Si es true, muestra la última versión junto al título de la pestaña de la cabecera. | ## Secciones personalizadas {#custom-sections} Una sección personalizada recibe una `url` en lugar de un `prefix` y se renderiza solo como pestaña. Una URL interna como `/about/` (por ejemplo, una [ruta personalizada](/es/customization/custom-routes/)) resalta la pestaña mientras estás en ella; una URL absoluta abre otro sitio. ```typescript { title: "About", type: "custom", url: "/about/" } ``` ## Orden y coincidencia {#ordering-and-matching} Las rutas de los artículos se asignan a las secciones por el prefijo más largo. Dado `/blog/2024/launch/` y secciones con prefijos `/` y `/blog/`, el artículo se coloca en `/blog/`. Termina los prefijos con barra (`/blog/`, no `/blog`) para que la coincidencia sea predecible. ## Ver también {#see-also} - [Enlaces externos](/es/customization/external-links/): añade enlaces externos junto a las pestañas de tus secciones. - [Frontmatter](/es/authoring/frontmatter/): los campos `path`, `order`, `date` y `tags` que determinan el contenido de las secciones.