@studiocms/blog

v0.3.0 GitHub npm Registro de cambios

Este complemento habilita las características del Blog de StudioCMS así como, un frontend en tu proyecto Astro. Te permitirá crear, editar y eliminar publicaciones de blog desde el panel de control de StudioCMS.

¿Qué hace este complemento?

Esta integración agregará las siguientes nuevas rutas a tu frontend controlado por StudioCMS:

/[...slug] - Ruta de catch-all que renderiza páginas genéricas de StudioCMS.
/blog - Índice del blog que lista todas las publicaciones.
/blog/[slug] - La página de la publicación individual del blog.
/rss.xml - El feed RSS para tus publicaciones de blog.

Instalación

Instala el paquete usando el siguiente comando:
- npm
- pnpm
- yarn
Ventana de terminal
npm run studiocms add @studiocms/blog
Ventana de terminal
pnpm run studiocms add @studiocms/blog
Ventana de terminal
yarn run studiocms add @studiocms/blog

Tu configuración de StudioCMS ahora debe incluir @studiocms/blog:

import { defineStudioCMSConfig } from 'studiocms/config';
import blog from '@studiocms/blog';

 export default defineStudioCMSConfig({
   plugins: [
     blog(/* Opciones */),
   ],
 });

Opciones

type StudioCMSBlogOptions = {
  /**
   * Lenguaje HTML por defecto - El lenguaje por defecto para la etiqueta HTML
   * @default 'en'
   */
  htmlDefaultLanguage: string | undefined;
  /**
   * Encabezado HTML por defecto - La configuración de encabezado por defecto para el frontend
   */
  htmlDefaultHead: {
    /**
     * Nombre de la etiqueta HTML para agregar a `<head>`, ej. `'meta'`, `'link'`, o `'script'`.
     */
    tag: "link" | "title" | "base" | "style" | "meta" | "script" | "noscript" | "template";
    /**
     * Atributos para establecer en la etiqueta, ej. `{ rel: 'stylesheet', href: '/custom.css' }`.
     */
    attrs?: Record<string, string | boolean | undefined> | undefined;
    /**
     * Contenido para colocar dentro de la etiqueta (opcional).
     */
    content?: string | undefined;
  }[] | undefined;
  /**
   * Configuración del Favicon - La configuración del favicon por defecto para el frontend
   */
  favicon: string | undefined;
  /**
   * Habilitar la generación de sitemap
   * @default true
   */
  sitemap: boolean | undefined;
  /**
   * Inyectar rutas
   * @default true
   */
  injectRoutes: boolean | undefined;
  /**
   * La configuración para el blog
   */
  blog: {
    /**
     * El título del blog
     */
    title: string | undefined;
    /**
     * Habilitar el feed RSS
     */
    enableRSS: boolean | undefined;
    /**
     * La ruta para el blog
     * @default '/blog'
     * @example '/noticias'
     */
    route: string | undefined;
  } | undefined;
}