Guía de Configuración

Todas las opciones configurables de Xingluo se encuentran en xingluo.config.ts en la raíz. El archivo proporciona restricciones de tipo completas a través de defineXingluoConfig; los cambios surten efecto de inmediato sin tocar el código fuente.

site

ts
site: {
  url: "https://xingluo.example.com/",  // URL del sitio, usado para enlaces absolutos, RSS, sitemap
  title: "Xingluo",                      // Título del sitio
  description: "Un CMS de blog moderno construido con Astro y shadcn",
  author: "Xingluo",                     // Nombre de autor predeterminado
  profile: "https://xingluo.example.com", // Página de inicio del autor (usado para JSON-LD)
  ogImage: "default-og.jpg",              // Imagen OG predeterminada (en el directorio public)
  lang: "zh-cn",                          // Idioma predeterminado
  timezone: "Asia/Shanghai",              // Zona horaria (visualización de fecha de artículos)
  dir: "ltr",                             // Dirección del texto: ltr | rtl
  googleVerification: "",                 // Valor de verificación de Google Search Console (o mediante variable de entorno)
}

posts

ts
posts: {
perPage: 8,              // Artículos por página de lista
  perIndex: 5,             // Artículos mostrados en la página de inicio
  scheduledPostMargin: 900000, // Tolerancia de publicación programada (ms), 15 minutos
}

• perPage: tamaño de página para /posts/[...page] y /tags/[tag]/[...page]
• perIndex: número de artículos mostrados en la sección “Últimos” de la página de inicio
• scheduledPostMargin: los artículos futuros dentro de esta ventana se tratan como publicados (efectivo en producción; dev muestra todos)

features

ts
features: {
  lightAndDarkMode: true,
  dynamicOgImage: true,
  showArchives: true,
  showBackButton: true,
  editPost: { enabled: true, url: "https://github.com/.../edit/main/" },
  search: "flexsearch",
  mdx: true,
  comments: { provider: false /* giscus | twikoo | waline */ },
  players: { aplayer: false, dplayer: false },
}

editPost

editPost.url es un prefijo de URL de edición de repositorio; Xingluo añade la ruta fuente relativa del artículo (src/content/posts/...). Por ejemplo:

ts
editPost: { enabled: true, url: "https://github.com/owner/repo/edit/main/" }

El artículo src/content/posts/welcome.md produce el enlace https://github.com/owner/repo/edit/main/src/content/posts/welcome.md.

socials

ts
socials: [
  { name: "github", url: "https://github.com/xingluo/blog" },
  { name: "x", url: "https://x.com/xingluo" },
  { name: "mail", url: "mailto:[email protected]" },
];

• name: nombre del icono, correspondiente a src/assets/icons/socials/{name}.astro. Integrados: github, x, mail, facebook, telegram, weibo
• url: URL del enlace; mailto: para correo electrónico
• linkTitle: título accesible opcional; se genera automáticamente a partir del nombre cuando se omite

Añadir una plataforma social: cree un componente de icono .astro con el mismo nombre en src/assets/icons/socials/. src/lib/socialIcons.ts los recopila automáticamente mediante import.meta.glob.

shareLinks

ts
shareLinks: [
  { name: "x", url: "https://x.com/intent/post?url=" },
  { name: "facebook", url: "https://www.facebook.com/sharer.php?u=" },
  { name: "telegram", url: "https://t.me/share/url?url=" },
  { name: "weibo", url: "https://service.weibo.com/share/share.php?url=" },
  { name: "mail", url: "mailto:?subject=...&body=" },
];

Estas entradas para compartir aparecen al final de las páginas de artículos. url es un prefijo de URL para compartir; Xingluo añade la URL absoluta del artículo actual. name se asigna igualmente a un icono en src/assets/icons/socials/.

Variables de entorno

Declaradas mediante env.schema en astro.config.ts:

Ejemplo (PowerShell):

powershell
$env:PUBLIC_GOOGLE_SITE_VERIFICATION = "su-código-de-verificación"
pnpm build

El valor se inyecta en config.site.googleVerification y se renderiza como <meta name="google-site-verification">.

Ejemplo completo

Consulte xingluo.config.ts. Las secciones features.comments y features.players incluyen ejemplos comentados para giscus / twikoo / waline; descomente y complete con valores reales para activarlos.