AtPoint's Blog

测试 Research 的添加

Sun, 11 Jan 2026 00:00:00 GMT

1. 前置条件

Node.js 18+（建议 20+）
包管理器：pnpm

pnpm install
pnpm dev

2. 目录结构（最常用）

src/site.config.ts：主题配置入口（站点信息、导航、集成配置等）
src/content/blogs/<slug>/index.mdx：中文文章
src/content/blogs/<slug>/index-en.mdx：英文文章（可选，没有则英文列表会回退到中文）
public/：静态资源（/images/*、/avatar/* 等）

3. 配置站点信息（`src/site.config.ts`）

常改字段：

theme.title / theme.description：站点标题/描述
theme.personal.domains.main：主域名（用于生成绝对链接、RSS 等）
theme.header.menu：导航菜单
integ.pagefind：站内搜索（Pagefind）
integ.waline：评论系统（见 Waline 文档）

4. 写一篇文章（中英双语）

新建文件夹：src/content/blogs/my-first-post/
写中文：src/content/blogs/my-first-post/index.mdx
写英文：src/content/blogs/my-first-post/index-en.mdx（可选）

最小 Frontmatter（两种语言都要有）：

---
title: My Title
publishDate: 2026-01-11
description: Short summary.
tags: ['docs']
---

5. 构建与产物

pnpm build
pnpm preview

构建产物默认在 dist/
astro.config.mjs 会根据 DEPLOYMENT_PLATFORM 选择适配器与输出模式（详见部署文档）

6. 部署推荐（GitHub + Vercel）

建议使用 GitHub 托管代码 + Vercel 自动部署（PR 预览、回滚、CDN、HTTPS 都更省心）。

部署思路与注意事项：Website on Vercel

Axi Theme 基础使用与配置

Sun, 11 Jan 2026 00:00:00 GMT

1. 前置条件

Node.js 18+（建议 20+）
包管理器：pnpm

pnpm install
pnpm dev

2. 目录结构（最常用）

src/site.config.ts：主题配置入口（站点信息、导航、集成配置等）
src/content/blogs/<slug>/index.mdx：中文文章
src/content/blogs/<slug>/index-en.mdx：英文文章（可选，没有则英文列表会回退到中文）
public/：静态资源（/images/*、/avatar/* 等）

3. 配置站点信息（`src/site.config.ts`）

常改字段：

theme.title / theme.description：站点标题/描述
theme.personal.domains.main：主域名（用于生成绝对链接、RSS 等）
theme.header.menu：导航菜单
integ.pagefind：站内搜索（Pagefind）
integ.waline：评论系统（见 Waline 文档）

4. 写一篇文章（中英双语）

新建文件夹：src/content/blogs/my-first-post/
写中文：src/content/blogs/my-first-post/index.mdx
写英文：src/content/blogs/my-first-post/index-en.mdx（可选）

最小 Frontmatter（两种语言都要有）：

---
title: My Title
publishDate: 2026-01-11
description: Short summary.
tags: ['docs']
---

5. 构建与产物

pnpm build
pnpm preview

构建产物默认在 dist/
astro.config.mjs 会根据 DEPLOYMENT_PLATFORM 选择适配器与输出模式（详见部署文档）

6. 部署推荐（GitHub + Vercel）

建议使用 GitHub 托管代码 + Vercel 自动部署（PR 预览、回滚、CDN、HTTPS 都更省心）。

部署思路与注意事项：Website on Vercel

GitHub + Vercel 部署（推荐）

Sun, 11 Jan 2026 00:00:00 GMT

1. 为什么推荐 GitHub + Vercel

PR 预览：每个分支/PR 都能拿到可访问的预览链接
自动构建：push 即部署
HTTPS / CDN：默认就有

详细流程与说明：Website on Vercel

2. 部署前检查

本地先跑通：

pnpm install
pnpm build

配置域名（建议至少填主域名）：

src/site.config.ts → theme.personal.domains.main

3. Vercel 部署要点

主题会读取 DEPLOYMENT_PLATFORM 来选择适配器与输出：

vercel（默认）：Vercel adapter，输出通常为 server
github：用于 GitHub Pages，输出为 static
cloudflare：用于 Cloudflare Pages，输出为 static

在 Vercel 项目里设置环境变量：

DEPLOYMENT_PLATFORM=vercel

构建命令建议使用：

pnpm build

输出目录（Output Directory）保持默认即可（Astro 会由适配器处理）。

4. 静态站点（可选）

如果你希望生成纯静态站点（例如 GitHub Pages），使用：

DEPLOYMENT_PLATFORM=github

并确保你的部署平台支持静态产物 dist/。

Friend Circle（朋友圈）：接入与配置

Sun, 11 Jan 2026 00:00:00 GMT

1. Friend Circle 是什么

“朋友圈”页面会展示友链站点的最新文章聚合，适合在 Links 页让访问者快速看到朋友们的新内容。

本主题的 Links 页集成入口在：

src/pages/links/index.astro

2. 先准备数据源（Friend-Circle-Lite）

本主题使用 Friend-Circle-Lite 的接口数据（all.json 等）。搭建与使用方式建议参考：

Friend Circle 参考文档

你需要得到一个可访问的域名，例如：

fc.example.com

并确保以下地址可访问：

https://fc.example.com/all.json

3. 在主题中启用

编辑 src/site.config.ts，设置：

theme.personal.domains.friendCircle = 'fc.example.com'

配置完成后，/links 页面会自动显示 “Small Circle / 朋友圈” 区块。

4. 友链 RSS 建议

如果某个站点在友链里但朋友圈里没有内容，通常是该站点未提供 RSS 或 RSS 不可访问。建议为友链站点补全 RSS。

MDX 组件使用：User & Advanced

Sun, 11 Jan 2026 00:00:00 GMT

import { Aside, Tabs, TabItem, Spoiler } from '@/components/user' import { GithubCard, LinkPreview, QRCode, ImageGroup, WebVideo } from '@/components/advanced'

1. 必须使用 MDX

.md 文章无法 import 组件；请使用 .mdx（如 src/content/blogs/<slug>/index.mdx）。

2. User 组件示例

3. Advanced 组件示例

GitHub 卡片

链接预览

二维码

图片组（等高拼图）

内嵌视频

Waline 评论系统：部署与接入

Sun, 11 Jan 2026 00:00:00 GMT

1. 部署 Waline 服务端

请参考这篇完整教程（包含服务端部署与配置项说明）：

Waline Comments: Deploy & Integrate

部署完成后你会得到一个服务端地址，例如：

https://waline.example.com/

2. 在主题中启用 Waline

编辑 src/site.config.ts：

integ.waline.enable: 设为 true
integ.waline.server: 填你的 Waline Server URL

示例：

waline: {
  enable: true,
  server: 'https://waline.example.com/',
}

3. 常见说明

评论区组件：src/components/advanced/Comment.astro
页面访问量/评论数：部分页面会加载 Waline 的 pageview 统计（见 src/pages/*）
单篇文章是否显示评论：由文章 Frontmatter 的 comment 控制（默认 true）

写作指南：Markdown / MDX

Sun, 11 Jan 2026 00:00:00 GMT

1. Markdown 支持范围

主题默认启用了常用扩展：

GFM：表格、删除线、任务列表等
数学公式：KaTeX（ $...$ / $$...$$）
代码高亮：Shiki（支持标题、差异标注等）

2. 数学公式（KaTeX）

行内：

欧拉公式：$e^{i\\pi}+1=0$

块级：

$$
\\int_0^1 x^2 dx = \\frac{1}{3}
$$

3. 代码块增强（差异/高亮）

你可以在代码中使用注释标记来展示变更（示例来自主题的高亮 transformer）：

const a = 1 // [!code --]
const a = 2 // [!code ++]

也可以做行高亮：

const token = 'secret' // [!code highlight]

4. 什么时候用 MDX

当你需要在文章里使用组件（例如 Aside、Tabs、GithubCard 等）时，请使用 .mdx，并在文件顶部 import 组件。

组件用法示例文档：见 “MDX 组件使用”。

AtPoint's Blog

测试 Research 的添加

1. 前置条件

2. 目录结构（最常用）

3. 配置站点信息（src/site.config.ts）

4. 写一篇文章（中英双语）

5. 构建与产物

6. 部署推荐（GitHub + Vercel）

Axi Theme 基础使用与配置

1. 前置条件

2. 目录结构（最常用）

3. 配置站点信息（src/site.config.ts）

4. 写一篇文章（中英双语）

5. 构建与产物

6. 部署推荐（GitHub + Vercel）

GitHub + Vercel 部署（推荐）

1. 为什么推荐 GitHub + Vercel

2. 部署前检查

3. Vercel 部署要点

4. 静态站点（可选）

Friend Circle（朋友圈）：接入与配置

1. Friend Circle 是什么

2. 先准备数据源（Friend-Circle-Lite）

3. 在主题中启用

4. 友链 RSS 建议

MDX 组件使用：User & Advanced

1. 必须使用 MDX

2. User 组件示例

3. Advanced 组件示例

GitHub 卡片

链接预览

二维码

图片组（等高拼图）

内嵌视频

Waline 评论系统：部署与接入

1. 部署 Waline 服务端

2. 在主题中启用 Waline

3. 常见说明

写作指南：Markdown / MDX

1. Markdown 支持范围

2. 数学公式（KaTeX）

3. 代码块增强（差异/高亮）

4. 什么时候用 MDX

3. 配置站点信息（`src/site.config.ts`）

3. 配置站点信息（`src/site.config.ts`）