Dokumentaro Xingluo
Xingluo estas moderna bloga CMS konstruita kun Astro kaj la vida stilo shadcn/ui. Ĝi liveras pli modernan vidan sperton per plataj, elegantaj shadcn-komponentoj kaj la OKLCH-kolorsistemo, kaj denaske integras komentan sistemon, nedevigan MDX-subtenon kaj aŭdio/vidaj ludilojn.
Indekso de dokumentaro
| Dokumento | Enhavo |
|---|---|
| Komenci | Postuloj, instalo, loka evoluigo, konstruo kaj antaŭrigardo |
| Agorda gvidilo | Plena referenco por xingluo.config.ts |
| Enhava kreado | Afiŝa frontmatter, Markdown/MDX-sintakso, kodblokoj, callouts, plibonigoj |
| Internaciigo | Plurlingva vojigo, UI-ĉenoj, traduko je enhava nivelo, aldoni lingvon |
| Arkitektura superrigardo | Dosieruja strukturo, agorda fluo, bildiga fluo, konstrutubo |
| Etoso kaj stiloj | shadcn-etosaj variabloj, OKLCH, Tailwind v4, malhela reĝimo |
| Komenta sistemo | Elektado kaj agordado de giscus / twikoo / waline |
| Aŭdvidaĵaj ludiloj | Uzo de APlayer / DPlayer en Markdown kaj MDX |
| SEO | OG-bildoj, RSS, retejmapo, hreflang, canonical, strukturitaj datumoj |
| Serĉo | Integrado de plenteksta serĉo Flexsearch |
| Deplojo | Statika gastigado, GitHub Pages, mediaj variabloj, Docker |
Ĉefaj trajtoj
- Plej alta rendimento: Astro statika generado, enkonstruitaj SVG-ikonoj dum konstruo (nula JS dum rutimo), malrapida ŝargo de komentoj kaj ludiloj, purigado de orfaj aktivaĵoj
- Modernaj vidajxoj: shadcn/ui novjorkaj komponantoj, OKLCH-kolorspaco, glata malhela reĝimo (FOUC-protekto)
- Plurlingva: traduko je UI- kaj enhava nivelo, vojigo
prefixDefaultLocale: false, hreflang- kaj x-default-SEO-deklaroj - Enhava plibonigo: laŭvola MDX, Shiki-du-tema kod reliefigo, callouts, faldebla TOC, ruleblaj tabeloj
- Legotempo: inteligenta takso (CJK laŭ signokvanto, latina laŭ vortkvanto), montrata sur kartoj kaj detalpaĝoj
- Rilataj afiŝoj: aŭtomate rekomenditaj per komunaj etikedoj
- Afiŝaj kategorioj: asignu per frontmatter, kun dediĉitaj kategoriaj paĝoj kaj navigada eniro
- Fiksita TOC-flankbreto: fiksita tabelo de enhavo dekstre sur grandaj ekranoj, IntersectionObserver ruluma sekvado
- Komenta sistemo: giscus / twikoo / waline, tema-konscia, malrapide ŝargita
- Aŭdvidaĵaj ludiloj: APlayer-aŭdio kaj DPlayer-video, kun ambaŭ MD barilo kaj MDX-komponanta enirpunktoj
- Serĉo: Flexsearch plenteksta serĉo, po-lingvaj indeksoj, View Transitions stata persistado
- Plena SEO: dinamikaj OG-bildoj (satori + sharp), RSS, retejmapo, JSON-LD strukturitaj datumoj (BlogPosting + BreadcrumbList), canonical normaligo
Teknologia stako
| Kategorio | Teknologio |
|---|---|
| Frameworks | Astro 6.x |
| Stilado | Tailwind CSS v4, shadcn/ui-stilaj komponantoj, @tailwindcss/typography |
| Ikonoj | astro-icon + Font Awesome |
| Enhavo | Astro Content Collections, MDX, remark/rehype kroma ĉeno |
| Kod reliefigo | Shiki |
| Serĉo | Flexsearch |
| OG-bildoj | satori + sharp |
| Komentoj | giscus / twikoo / waline |
| Ludiloj | APlayer / DPlayer |
| Dato | dayjs |
| Pakaĵadministrilo | pnpm |
| Lingvo | TypeScript |
Permesilo
AGPL-3.0
Konigi ĉi tiun artikolon: Konigi per X Konigi per Facebook Konigi per Telegram Konigi per Weibo Konigi per retpoŝto
Rilataj artikoloj
Deplojo
2 min legadoGvidilo pri deplojo de Xingluo kovranta statikajn gastigajn platformojn (Netlify/Vercel/GitHub Pages), Nginx-memgastigadon, Docker kaj mediajn variablojn.
Serĉo
1 min legadoGvidilo pri serĉo de Xingluo kovranta Flexsearch-plentekstan serĉintegriĝon, indeksgeneradon, UI, plurlingvan serĉon kaj rendimenton.