1
name: Code quality
2

3
on:
4
  push:
5
    branches: [ main ] # Adjust branches as needed
6
  pull_request:
7
    branches: [ main ] # Adjust branches as needed
8

9
jobs:
10
  quality:
11
    runs-on: ubuntu-latest
12
    steps:
13
      - name: Checkout
14
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
15
      - name: Setup Biome
16
        uses: biomejs/setup-biome@f382a98e582959e6aaac8e5f8b17b31749018780 # v2.5.0
17
        with:
18
          version: latest
19
      - name: Run Biome
20
        run: biome ci ./src --reporter=github

1
name: Code quality
2

3
on:
4
  push:
5
    branches: [ main ]
6
  pull_request:
7
    branches: [ main ]
8

9
concurrency:
10
  group: ${{ github.workflow }}-${{ github.ref }}
11
  cancel-in-progress: true
12

13
permissions:
14
  contents: read
15

16
jobs:
17
  quality:
18
    runs-on: ubuntu-latest
19
    steps:
20
      - name: Checkout
21
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
22
      - name: Setup Biome
23
        uses: biomejs/setup-biome@f382a98e582959e6aaac8e5f8b17b31749018780 # v2.5.0
24
        with:
25
          version: latest
26
      - name: Setup pnpm
27
        uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
28
        with:
29
          run_install: false
30
      - name: Setup Node.js
31
        uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0
32
        with:
33
          node-version: 24
34
      - name: Install dependencies
35
        run: pnpm install --frozen-lockfile
36
      - name: Run Biome
37
        run: biome ci ./src --reporter=github
38
        run: pnpm exec biome ci ./src --reporter=github

1
import { defineCollection, z } from "astro:content";
2
import { defineCollection } from "astro:content";
3
import { glob } from "astro/loaders";
4
import { z } from "astro/zod";
5

6
const postsCollection = defineCollection({
7
  schema: z.object({
8
const posts = defineCollection({
9
  loader: glob({ base: "./src/content/posts", pattern: "**/*.{md,mdx}" }),
10
  schema: z.object({
11
    title: z.string(),
12
    published: z.date(),
13
    updated: z.date().optional(),
14
    draft: z.boolean().optional().default(false),
15
    description: z.string().optional().default(""),
16
    image: z.string().optional().default(""),
17
    tags: z.array(z.string()).optional().default([]),
18
    category: z.string().optional().default(""),
19
    lang: z.string().optional().default(""),
20
    comments: z.boolean().optional().default(false),
21
    pinned: z.boolean().optional().default(false),
22
    series: z.string().optional(),
23
    /* For internal use */
24
    prevTitle: z.string().default(""),
25
    prevSlug: z.string().default(""),
26
    nextTitle: z.string().default(""),
27
    nextSlug: z.string().default(""),
28
  }),
29
});
30
export const collections = {
31
  posts: postsCollection,
32
};
33

34
const spec = defineCollection({
35
  loader: glob({ base: "./src/content/spec", pattern: "**/*.{md,mdx}" }),
36
  schema: z.object({}),
37
});
38

39
export const collections = { posts, spec };

1
import { getCollection, type CollectionEntry } from "astro:content";
2
import { getCollection, render, type CollectionEntry } from "astro:content";
3

4
const { Content } = await entry.render();
5
const { Content } = await render(entry);
6

7
const url = getPostUrlBySlug(entry.slug);
8
const url = getPostUrlBySlug(entry.id);
9

10
const posts: CollectionEntry<"posts">[] = ...
11
const posts: CollectionEntry<"posts">[] = ...  // 类型名不变，数据源换成 loader

1
/**
2
 * Resolve the directory that contains a post's source file, relative to `src/`.
3
 * Content Layer entries keep their real path in `filePath` (e.g.
4
 * `src/content/posts/docker/index.md`), which is needed to locate cover images
5
 * referenced with relative paths. The `id` is only a slug and has no directory.
6
 */
7
export function getPostDir(entry: { id: string; filePath?: string }): string {
8
  const filePath = entry.filePath ?? `src/content/posts/${entry.id}`;
9
  const dirname = filePath.includes("/")
10
    ? filePath.slice(0, filePath.lastIndexOf("/"))
11
    : "";
12
  return `${dirname.replace(/^src\//, "")}/`;
13
}

1
/**
2
 * 站点附加功能（参考 Besty0728/fuwari 的「整个博客改造」）。
3
 * 这里只放可安全公开的配置；第三方统计 / 广告 / 防盗链 / 收款码等个人化硬编码一律不引入。
4
 */
5
export const featureConfig: FeatureConfig = {
6
  readingProgress: { enable: true },
7
  mermaid: { enable: true },
8
  recentPosts: { enable: true, count: 5 },
9
  forceDark: { enable: true, defaultOn: false },
10
  randomBackground: { enable: true, defaultOn: false, opacity: 0.25 },
11
  musicPlayer: {
12
    enable: true,
13
    defaultOn: false,
14
    // 默认使用一段免版权的公共音频；如要换成自己的，只需改这个 URL。
15
    title: "Ambient",
16
    src: "https://cdn.pixabay.com/download/audio/2022/03/15/audio_c8c8a73467.mp3?filename=ambient-piano-logo-165357.mp3",
17
  },
18
  hot: { enable: true },
19
  works: { enable: true },
20
  apps: { enable: true, items: [ /* Fuwari / Astro 文档 / p1ume 源码 */ ] },
21
  labels: { /* 23 条中文文案，单一配置源 */ },
22
};

1
---
2
import { featureConfig, siteConfig } from "../config";
3
---
4

5
<div
6
  id="config-carrier"
7
  data-hue={siteConfig.themeColor.hue}
8
  data-feature-force-dark={String(featureConfig.forceDark.enable)}
9
  data-feature-force-dark-default={String(featureConfig.forceDark.defaultOn)}
10
  data-feature-random-bg={String(featureConfig.randomBackground.enable)}
11
  data-feature-random-bg-opacity={String(featureConfig.randomBackground.opacity)}
12
  data-feature-music={String(featureConfig.musicPlayer.enable)}
13
  data-feature-music-title={featureConfig.musicPlayer.title}
14
  data-feature-music-src={featureConfig.musicPlayer.src}
15
  data-feature-reading-progress={String(featureConfig.readingProgress.enable)}
16
  data-feature-mermaid={String(featureConfig.mermaid.enable)}
17
  data-label-random-bg={featureConfig.labels.randomBg}
18
  data-label-force-dark={featureConfig.labels.forceDark}
19
  data-label-music={featureConfig.labels.music}
20
  data-label-controls={featureConfig.labels.controls}
21
></div>

1
/*
2
 * 站点附加功能（参考 Besty0728/fuwari 的「整个博客改造」，按本仓库重写）。
3
 * 纯原生 JS，无 npm 依赖；通过 #config-carrier 的 data-* 读取功能开关。
4
 * 该脚本位于 public/ 下、以 is:inline 方式引入，不参与打包，在 Swup 页面切换时只需
5
 * 监听 page:view 重新处理新内容即可。
6
 */
7
(() => {
8
  "use strict";
9
  function cfg() {
10
    const c = document.getElementById("config-carrier");
11
    if (!c) return {};
12
    return {
13
      forceDark: c.dataset.featureForceDark === "true",
14
      randomBg: c.dataset.featureRandomBg === "true",
15
      randomBgOpacity: Number.parseFloat(c.dataset.featureRandomBgOpacity || "0.25"),
16
      mermaid: c.dataset.featureMermaid === "true",
17
      /* ... */
18
    };
19
  }
20
  /* ... */
21
  if (window.swup?.hooks) {
22
    window.swup.hooks.on("page:view", onPageView);
23
  } else {
24
    document.addEventListener("swup:enable", () => {
25
      window.swup?.hooks?.on("page:view", onPageView);
26
    });
27
  }
28
})();

1
/** 作品集：参照参考仓库的 works 内容类型，按 Content Layer glob loader 定义。 */
2
const works = defineCollection({
3
  loader: glob({ base: "./src/content/works", pattern: "**/*.{md,mdx}" }),
4
  schema: z.object({
5
    title: z.string(),
6
    description: z.string().optional().default(""),
7
    published: z.date(),
8
    updated: z.date().optional(),
9
    tags: z.array(z.string()).optional().default([]),
10
    link: z.string().optional().default(""),
11
    image: z.string().optional().default(""),
12
    draft: z.boolean().optional().default(false),
13
    status: z.string().optional().default(""),
14
  }),
15
});
16

17
export const collections = { posts, spec, works };

1
// 友链改为数据驱动：新增友链只需在 src/content/friends/ 下放一个 JSON 文件。
2
const friendModules = import.meta.glob("../content/friends/*.json", {
3
  eager: true,
4
  import: "default",
5
}) as unknown as Record<string, Friend>;
6
const items: Friend[] = Object.values(friendModules);

1
export const navBarConfig: NavBarConfig = {
2
  links: [
3
    LinkPreset.Home,
4
    LinkPreset.Archive,
5
    LinkPreset.About,
6
    LinkPreset.Friends,
7
    {
8
      name: featureConfig.labels.navMusic,   // "音乐"
9
      url: "http://music.alger.fun/#/",
10
      external: true,
11
    },
12
    ...(featureConfig.works.enable
13
      ? [{ name: featureConfig.labels.works, url: "/works/" }]   // "作品"
14
      : []),
15
    ...(featureConfig.apps.enable
16
      ? [{ name: featureConfig.labels.apps, url: "/apps/" }]     // "应用"
17
      : []),
18
    ...(featureConfig.hot.enable
19
      ? [{ name: featureConfig.labels.hot, url: "/hot/" }]       // "热门文章"
20
      : []),
21
  ],
22
};

1
    <ConfigCarrier />
2
    <slot />
3
    <GlobalFeatures />

1
        <RecentPosts class="onload-animation" style="animation-delay: 100ms" />

1
.text-90 { @apply text-black/90 dark:text-white/90 }
2
.text-75 { @apply text-black/75 dark:text-white/75 }
3
.text-50 { @apply text-black/50 dark:text-white/50 }
4
/* ... */

1
.card-base {
2
  @apply rounded-[var(--radius-large)] overflow-hidden bg-[var(--card-bg)] transition;
3
}

1
#feature-controls-panel {
2
  display: flex;
3
  /* 模板未设基础文字色，默认继承纯黑；暗黑模式必须显式给出可读文字色 */
4
  color: rgba(0, 0, 0, 0.75);
5
}
6
.dark #feature-controls-panel {
7
  color: rgba(255, 255, 255, 0.75);
8
}
9

10
/* 排序按钮同时出现在悬浮面板与 /hot/ 页面，需独立给出明暗两套文字色 */
11
.hot-sort {
12
  color: rgba(0, 0, 0, 0.75);
13
}
14
.dark .hot-sort {
15
  color: rgba(255, 255, 255, 0.75);
16
}
17

18
/* 激活态白字优先级需同时压过明暗两套基础色 */
19
.hot-sort.is-on,
20
.dark .hot-sort.is-on {
21
  color: #ffffff;
22
}

1
/*
2
 * Waline 评论组件（模板自带的 @waline/client@v3）在暗黑模式下未给容器设置
3
 * 基础文字色，评论计数、排序标题等标签会继承纯黑，压在深色背景上看不清。
4
 * 用 #waline 容器 ID 提升特异度，只作用于评论区域，不影响站点其它文字；
5
 * 自带显式颜色的控件（如绿底主按钮）仍保留原有配色。
6
 */
7
.dark #waline {
8
  color: rgba(255, 255, 255, 0.75);
9
}