纸鹿摸鱼处

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

使用本主题的博客

• 纸鹿摸鱼处 @L33Z22L11 · 开发经历
• 希乐博客 @Xlenco
• SteinsNote @Labmem-00 · 迁移经历
• 月空人 @Whbbit1999 · 迁移评价
• 地球驿站 @mugzx · 迁移记录
• 克喵的小栈 @Kemeow815
• 梦爱吃鱼 @JLinmr
• Mikuの极光星 @PaloMiku

特性

主题特性 · 组件示例

目录结构

项目使用 Nuxt 4 项目目录结构，可以参照 Nuxt 3 目录结构（左侧栏有导航）。

.
├── app # 前端
│   ├── assets # 资源文件
│   ├── components # 组件
│   │   ├── content # MDC组件
│   │   ├── partial # 微型组件
│   │   ├── widget # 侧边栏组件
│   │   ├── zhilu # 个人标识组件
│   │   └── ... # 布局组件
│   ├── composables # Vue 组合式函数
│   ├── pages # 页面
│   │   ├── [...slug].vue # 正文、404页面
│   │   ├── page.vue # 首页
│   │   ├── page/[[id]].vue # 首页动态路由
│   │   ├── archive.vue # 归档
│   │   ├── link.vue # 友链
│   │   └── preview.vue # 预览的文章
│   ├── plugins # Nuxt / Vue 插件
│   ├── stores # Pinia 状态管理
│   ├── types # 类型定义
│   ├── utils # 工具函数
│   ├── app.config.ts # 前端响应式配置★
│   ├── app.vue # 基本布局
│   ├── error.vue # 意外错误页
│   ├── friends.ts # 友链★
│   └── subscriptions.ts # 单向订阅/推荐网站★
├── content # 文章
│   ├── posts # 文章
│   ├── previews # 预览文章，可被站内搜索
│   ├── link.md # 友链要求
│   └── theme.md # 主题介绍
├── patches # npm 包补丁
├── public # 静态资源，生成在站点根目录
│   └── fonts # 字体
├── server # 服务端
│   ├── api # 接口
│   │   └── stats.get.ts # 博客静态统计
│   ├── plugins # Nitro 插件
│   │   ├── anti-mirror.ts # 恶意反代跳转
│   │   └── fix-post.ts # 修复文章时区/链接
│   └── routes # 路由
│       └── atom.xml.get.ts # Atom 订阅源
├── blog.config.ts # 博客静态公共配置★
├── nuxt.config.ts # Nuxt 配置
└── redirects.json # 旧站点重定向配置

快速开始

安装依赖

pnpm i

运行开发环境

pnpm dev

初始配置

为避免误会，应当更改一些配置信息以和我的博客网站区分：

• 删除原有文章：content/ 目录下仅保留 link.md，app.config.ts 中将 footer.nav[2].items[1].url 由 /theme 改为 https://blog.zhilu.cyou/theme（确保通过链接检测）。
• 更换服务配置：blog.config.ts 中的 Umami 站点统计、Cloudflare Insights 统计、Twikoo 评论服务源需要注释或更换。
• 个人信息：blog.config.ts 中的站点信息、app.config.ts 中的页脚导航、出生年份等。
• 其他应当被善意认为有必要修改的文件和配置字段（参阅“目录结构”一节）。

创建文章

pnpm new my-post-title

构建生产环境

pnpm generate
pnpm preview

部署指南

推荐使用 Vercel 进行部署，同时也支持 Netlify、Cloudflare Pages 等平台。建议采用静态（SSG）部署方式，我的部署配置如下：

• 构建命令: pnpm generate/nuxt generate
• 输出目录: dist（与Nuxt预设相同）
• 安装命令: pnpm i（一般会自动检测）

如果直接使用平台提供的“Nuxt”预设部署，那么会变成 SSR 模式，需要调整部署命令，请参阅 Nuxt 官方文档的 部署 部分。

疑难解答

• Vercel 先前创建的项目需要 手动指定 pnpm 10。
• Cloudflare Pages 部署项目需要配置 NODE_VERSION 环境变量为较新的版本，如 22.14.0。

贡献

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

使用答疑

使用需要具备一定的前端项目基础。如果你不确定代码是否有问题，可以加入 QQ 群 169994096 讨论（也欢迎闲聊），我很乐意在空闲时解答问题。

许可证

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