纸鹿摸鱼处

我的第三代个人博客，于 2024 年 8 月 11 日上线。

Warning

修改本项目需要具备前端开发和项目部署能力。由于这是个人博客，代码经过深度定制，且可能会进行较大幅度的更新，建议您 Fork 后安心使用自己分支的版本；若需引入上游（本仓库）的新功能，建议重新 Fork 最新代码，以避免同步冲突。

如果需要协助或有问题咨询，欢迎加入 QQ 群 169994096 讨论/闲聊，我会在空闲时尽力解答。

使用本主题的博客

主题吸收了 Stellar 的设计风格，命名为 Clarity，寓意清楚的阅读体验和清晰的观点表达。

博客名称	作者	对应上游版本	下游特色功能
纸鹿摸鱼处	L33Z22L11	v3.4.9	(我是上游)
希乐博客	Xlenco	v3.4.8	最新评论
SteinsNote	Labmem-00	v3.1-241112	专栏
月空人	Whbbit1999	v3.4.9	项目/博客/Snippets页
地球驿站	mugzx	v3.4.9	设计风格统一
喵落阁	Kemeow815	v3.4.7	即刻+友圈+最新评论+游戏/番剧页
梦爱吃鱼	JLinmr	v3.2-250304	即刻+友圈+最新评论
Mikuの极光星	PaloMiku	v3.4.9	设计风格统一，设置面板
Shenley的存档点	shenlye	v3.4.4	游戏/番剧页，方形卡片+科技风
BiuXin-s Blog	damizai	v3.2-250304	即刻+友圈+最新评论
液泡部落格	VacuolePaoo	v3.4.9	一言+标签tags+页脚随机友链
歆鸢阁	661111	v3.4.9	即刻+友圈+Heo友链轮播/Profile
落憾	LuoH-AN	v3.4.9	即刻+一言+卡片Profile
落尘up	luochenup	v3.3.4	侧栏时间轴
硅基漫游指南	HeLongaa	v3.4.0	即刻+友圈+Artalk评论
ATao-Blog	ataoyan	v3.4.0	即刻+装备页
fishcpy的小破站	fishcpy	v3.4.8	友圈+Artalk评论
六月墨语	Akuma-real	v3.4.9	友圈+最新评论
Cталин博客	StalinDev54	v3.4.8	侧栏时间轴+关于页
栖童の小站	Linux-qitong	v3.4.9	即刻+友圈
小源151博客	XiaoYuan151	v3.4.8
墨韵云阁	luoyuanxiang	v3.4.8

特性

主题特性 · 组件示例

目录结构

项目使用 Nuxt 4 项目目录结构。

.
├── app # 前端
│   ├── assets # 资源文件
│   ├── components # 组件
│   │   ├── content # MDC组件
│   │   ├── partial # 微型组件
│   │   ├── widget # 侧边栏组件
│   │   ├── zhilu # 个人标识组件
│   │   └── ... # 布局组件
│   ├── composables # Vue 组合式函数
│   ├── pages # 页面
│   │   ├── [...slug].vue # 正文、404页面
│   │   ├── archive.vue # 归档
│   │   ├── link.vue # 友链
│   │   ├── index.vue # 首页
│   │   └── preview.vue # 预览的文章
│   ├── plugins # Nuxt / Vue 插件
│   ├── stores # Pinia 状态管理
│   ├── types # 类型定义
│   ├── utils # 工具函数
│   ├── app.config.ts # 前端响应式配置★
│   ├── app.vue # 基本布局
│   ├── error.vue # 意外错误页
│   └── feeds.ts # 友链列表★
├── content # 文章
│   ├── posts # 正式文章
│   ├── previews # 草稿文章，仅可被站内搜索
│   ├── link.md # 友链要求
│   └── theme.md # 主题介绍
├── modules # Nuxt 模块
│   └── anti-mirror # 恶意反代跳转
├── packages # Monorepo 包
│   └── remark-music # 乐谱解析
├── patches # npm 包补丁
├── public # 静态资源，生成在站点根目录
│   ├── assets # 订阅源 XSL 模板
│   └── fonts # 字体
├── scripts # npm 脚本
├── server # 服务端
│   ├── api # 接口
│   │   └── stats.get.ts # 博客静态统计
│   ├── plugins # Nitro 插件
│   └── routes # 根路由
│       ├── atom.xml.get.ts # Atom 订阅源
│       └── zhilu.opml.get.ts # OPML 订阅源聚合
├── blog.config.ts # 博客静态公共配置★
├── content.config.ts # Nuxt Content 配置
├── edgeone.json # EdgeOne 配置
├── nuxt.config.ts # Nuxt 配置
└── redirects.json # 旧站点重定向配置

快速开始

安装依赖

pnpm i

如果你擅长前端并且需要安装 npm 包，推荐通过 @antfu/nip 包提供的 nip 命令安装 npm 包到合适的 catalog 下。

初始配置

pnpm init-project # 初始化项目配置

• 在启动或部署项目时，你需要移除我的文章、我的个人信息、我的统计/评论配置。

  • blog.config.ts 中的站点信息、Umami 站点统计、Cloudflare Insights 统计、Twikoo 评论服务源。
  • app.config.ts 中的页脚导航、出生年份等。

• 为保证开发体验，需要安装 ESLint、Stylelint 等 VS Code 扩展。如果你不喜欢此项目的格式化风格，可以在 ./eslint.config.mjs 和 ./.vscode/settings.json 中调整或者不安装 VS Code 扩展。

• 如果文章 URL 和先前的不相同，可以通过编辑 redirects.json 来添加重定向。

创建文章

• 启用 blog.config.ts 中的 article.useRandomPremalink，即可在创建文章时随机生成 URL。

pnpm new

运行开发环境

pnpm dev

构建生产环境

pnpm generate
pnpm preview

部署指南

支持 Vercel、Netlify、Cloudflare Pages、EdgeOne 等平台部署。建议采用静态（SSG）部署方式：

• 构建命令: pnpm generate
• 输出目录: dist
• 安装命令: pnpm i

如果直接使用平台提供的“Nuxt”预设部署，则会变成 SSR 模式，此模式每次访问都会等待服务端重新渲染。请参阅 Nuxt 文档 和 Nuxt Content 文档 的“部署”一节。

贡献

欢迎参与项目：如果有具体问题或功能建议，可以发起 Issue；如果愿意在已确定的方向上增加功能或修复问题，可以提交 Pull Request。

许可证

• 项目本体：MIT
• 博客文章：CC BY-NC-SA 4.0
• 请完成必要的配置与修改后再部署项目，不得以我的名义或将我的文章发布到互联网，否则我将设法与你联系。
• 希望你在页脚保留此项目链接，助力开源传播。