674 字
3 分钟
增加系列侧边栏
此方法来自于伊卡的记事本,需要对博客框架进行小改造
增加多语言配置
这里如果不给每个翻译文件增加对应参数的话会产生报错,不过为了简洁这里只演示英文与中文的内容,其余语言可以通过翻译软件进行翻译
enum I18nKey { // ... series = 'series',}export const en: Translation = { // ... [Key.series]: 'Series',}export const en: Translation = { // ... [Key.series]: 'Series',}增加字段配置
export type BlogPostData = { // ... series?: string;};const postsCollection = defineCollection({ schema: z.object({ // ... series: z.string().optional(), }),});传入组件
---import type { MarkdownHeading } from "astro";import Categories from "./Categories.astro";import Profile from "./Profile.astro";import Tag from "./Tags.astro";import Series from './Series.astro'
interface Props { class?: string; headings?: MarkdownHeading[]; series?: string}
const className = Astro.props.class;
const series = Astro.props.series---<div id="sidebar" class:list={[className, "w-full"]}> <div class="flex flex-col w-full gap-4 mb-4"> <Profile></Profile> </div> <div id="sidebar-sticky" class="transition-all duration-700 flex flex-col w-full gap-4 top-4 sticky top-4"> <div id="series" class="flex flex-col w-full gap-4"> { series && <Series series={ series }></Series> } </div> <Categories class="onload-animation" style="animation-delay: 150ms"></Categories> <Tag class="onload-animation" style="animation-delay: 200ms"></Tag> </div></div>interface Props { title?: string; banner?: string; description?: string; lang?: string; setOGTypeArticle?: boolean; headings?: MarkdownHeading[]; series?: string;}
const { title, banner, description, lang, setOGTypeArticle, headings = [], series,} = Astro.props;
// ...
<SideBar class="mb-4 row-start-2 row-end-3 col-span-2 lg:row-start-1 lg:row-end-2 lg:col-span-1 lg:max-w-[17.5rem] onload-animation" headings={headings} series={series}></SideBar><MainGridLayout banner={entry.data.image} title={entry.data.title} description={entry.data.description} lang={entry.data.lang} setOGTypeArticle={true} headings={headings} series={entry.data.series}> // ...</MainGridLayout>创建组件
export async function getPostSeries( seriesName: string,): Promise<{ body: string; data: BlogPostData; slug: string }[]> { const posts = (await getCollection('posts', ({ data }) => { return ( (import.meta.env.PROD ? data.draft !== true : true) && data.series === seriesName ) })) as unknown as { body: string; data: BlogPostData; slug: string }[]
posts.sort((a, b) => { const dateA = new Date(a.data.published) const dateB = new Date(b.data.published) return dateA > dateB ? 1 : -1 })
return posts}---import I18nKey from '../../i18n/i18nKey'import { i18n } from '../../i18n/translation'import { getPostSeries } from '../../utils/content-utils'import { getPostUrlBySlug } from '../../utils/url-utils'import WidgetLayout from './WidgetLayout.astro'
const COLLAPSED_HEIGHT = '7.5rem'
interface Props { class?: string style?: string series: string}const className = Astro.props.classconst style = Astro.props.styleconst seriesName = Astro.props.series
const series = await getPostSeries(seriesName)
const isCollapsed = series.length >= 10---<WidgetLayout name={i18n(I18nKey.series) + " - " + series[0].data.series} id="series" isCollapsed={isCollapsed} collapsedHeight={COLLAPSED_HEIGHT} class={className} style={style}> <div class="flex flex-col gap-1"> {series.map(t => ( <a href={getPostUrlBySlug(t.slug)} aria-label={t.data.title} class="group btn-plain h-10 w-full rounded-lg hover:text-[initial]" > <!-- dot and line --> <div class="w-[15%] md:w-[10%] relative dash-line h-full flex items-center"> <div class="transition-all mx-auto w-1 h-1 rounded group-hover:h-5 bg-[oklch(0.5_0.05_var(--hue))] group-hover:bg-[var(--primary)] outline outline-4 z-50 outline-[var(--card-bg)] group-hover:outline-[var(--btn-plain-bg-hover)] group-active:outline-[var(--btn-plain-bg-active)] " ></div> </div> <!-- post title --> <div class="w-[85%] text-left font-bold group-hover:translate-x-1 transition-all group-hover:text-[var(--primary)] text-75 pr-15 whitespace-nowrap overflow-ellipsis overflow-hidden" title={t.data.title} > {t.data.title} </div> </a> ))} </div></WidgetLayout>增加配置项
export default defineConfig({ // ... integrations: [ // ... swup({ theme: false, animationClass: "transition-swup-", // see https://swup.js.org/options/#animationselector // the default value `transition-` cause transition delay // when the Tailwind class `transition-all` is used containers: ["main", "#toc", "#series"], smoothScrolling: true, cache: true, preload: true, accessibility: true, updateHead: true, updateBodyClass: false, globalInstance: true, }),// ...示例
这样就配置好了,在文章的模板中增加一条series的参数就可以自动合并同系列文章了
---title:published: 2025-07-31description: ''image: ''tags: []category: ''draft: falselang: ''series: '博客改造'---