2026-06-123 分钟阅读
网站操作与使用指南
如何运行、维护、更新内容、部署和排查这个 ROS2 机器人个人网站。
文档Next.js运维
这份指南用于日常维护这个个人网站：本地运行、更新博客、修改项目、部署上线，以及每次大更新后的 Git 提交流程。
本地启动
安装依赖并启动开发服务器：
npm install
npm run dev
默认访问地址：
http://127.0.0.1:3000/zh
http://127.0.0.1:3000/en
如果 3000 端口已经被占用，可以换到 3001：
npm run dev -- --hostname 127.0.0.1 --port 3001
更新博客
中文博客放在：
src/content/blog/zh/
英文博客放在：
src/content/blog/en/
每篇文章使用 Markdown frontmatter：
title: "文章标题"
description: "用于 SEO 和文章卡片的摘要"
date: "2026-06-12"
tags: ["ROS2", "文档"]
文章发布前运行：
npm run lint
npm run build
更新项目和产品
项目、商店产品、个人链接和技术栈都集中在：
src/lib/data.ts
如果要新增首页精选项目，将项目对象里的 featured 设为 true。项目截图放在 public/projects/，然后在 screenshot 字段中引用。
部署前检查
上线前确认：
NEXT_PUBLIC_SITE_URL: "https://your-domain.com"
还要检查：
/zh和/en首页/zh/blog和/en/blog/sitemap.xml/rss.xml/robots.txt
Git 提交
每次大更新完成后提交：
git add .
git commit -m "Update documentation"
这个项目已经配置提交身份：
git config --global user.name "Yu Ge"
git config --global user.email "liuzi9240@gmail.com"
更完整的维护说明见仓库文档 docs/operations-and-usage.md。