Documentação do Xingluo
Xingluo é um CMS de blog moderno construído com Astro e o estilo visual shadcn/ui. Ele oferece uma experiência visual mais moderna através de componentes shadcn planos e elegantes e do sistema de cores OKLCH, e integra nativamente um sistema de comentários, suporte MDX opcional e reprodutores de áudio/vídeo.
Índice de documentação
| Documento | Conteúdo |
|---|---|
| Começando | Requisitos, instalação, desenvolvimento local, build e preview |
| Guia de configuração | Referência completa para xingluo.config.ts |
| Criação de conteúdo | Frontmatter de posts, sintaxe Markdown/MDX, blocos de código, callouts, melhorias |
| Internacionalização | Roteamento multilíngue, strings de UI, tradução em nível de conteúdo, adicionar idioma |
| Visão geral da arquitetura | Estrutura de diretórios, fluxo de configuração, fluxo de renderização, pipeline de build |
| Tema e estilos | Variáveis de tema shadcn, OKLCH, Tailwind v4, modo escuro |
| Sistema de comentários | Escolha e configuração de giscus / twikoo / waline |
| Reprodutores de mídia | Uso de APlayer / DPlayer em Markdown e MDX |
| SEO | Imagens OG, RSS, sitemap, hreflang, canonical, dados estruturados |
| Pesquisa | Integração de busca de texto completo Flexsearch |
| Implantação | Hospedagem estática, GitHub Pages, variáveis de ambiente, Docker |
Funcionalidades principais
- Desempenho de alto nível: geração estática Astro, ícones SVG incorporados em tempo de build (zero JS em runtime), carregamento lento de comentários e players, limpeza de assets órfãos
- Visuais modernos: componentes shadcn/ui new-york, espaço de cor OKLCH, modo escuro suave (proteção FOUC)
- Multilíngue: tradução em nível de UI e conteúdo, roteamento
prefixDefaultLocale: false, declarações SEO hreflang e x-default - Melhoria de conteúdo: MDX opcional, realce de código Shiki de tema duplo, callouts, TOC recolhível, tabelas roláveis
- Tempo de leitura: estimativa inteligente (CJK por contagem de caracteres, latim por contagem de palavras), exibido em cartões e páginas de detalhes
- Posts relacionados: recomendados automaticamente por tags compartilhadas
- Categorias de posts: atribuir via frontmatter, com páginas de categoria dedicadas e entrada de navegação
- Barra lateral TOC fixa: tabela de conteúdos fixa à direita em telas grandes, rastreamento de rolagem IntersectionObserver
- Sistema de comentários: giscus / twikoo / waline, consciente do tema, carregamento lento
- Players de mídia: áudio APlayer e vídeo DPlayer, com pontos de entrada MD fence e componente MDX
- Busca: busca de texto completo Flexsearch, índices por idioma, persistência de estado View Transitions
- SEO completo: imagens OG dinâmicas (satori + sharp), RSS, sitemap, dados estruturados JSON-LD (BlogPosting + BreadcrumbList), normalização canonical
Stack tecnológico
| Categoria | Tecnologia |
|---|---|
| Framework | Astro 6.x |
| Estilização | Tailwind CSS v4, componentes estilo shadcn/ui, @tailwindcss/typography |
| Ícones | astro-icon + Font Awesome |
| Conteúdo | Astro Content Collections, MDX, cadeia de plugins remark/rehype |
| Realce de código | Shiki |
| Busca | Flexsearch |
| Imagens OG | satori + sharp |
| Comentários | giscus / twikoo / waline |
| Players | APlayer / DPlayer |
| Data | dayjs |
| Gerenciador de pacotes | pnpm |
| Linguagem | TypeScript |
Licença
AGPL-3.0
Compartilhar este artigo: Compartilhar no X Compartilhar no Facebook Compartilhar no Telegram Compartilhar no Weibo Compartilhar por e-mail
Artigos relacionados
Implantação
2 min de leituraGuia de implantação do Xingluo cobrindo plataformas de hospedagem estática (Netlify/Vercel/GitHub Pages), auto-hospedagem Nginx, Docker e variáveis de ambiente.
Busca
1 min de leituraGuia de busca do Xingluo cobrindo integração de busca de texto completo Flexsearch, geração de índices, UI, busca multilíngue e desempenho.