常用方法

常用链接 #

常用命令 #

进入项目：

cd ~/projects/doks-site

启动本地服务：

npm run start -- --port 1324

完整检查：

npm run lint
npm run build

只检查 Markdown：

npm run lint:markdown

只检查样式：

npm run lint:styles

查看改动：

git status --short
git diff --stat

内容放哪里 #

新增栏目 #

新增文档栏目时需要：

1. 在 content/en/docs/ 下创建目录。
2. 添加 _index.md。
3. 在 config/_default/menus/menus.en.toml 增加 [[docs]] 顶层菜单。
4. 子页面 front matter 中设置 menu.docs.parent。
5. 跑 npm run build 检查侧栏。

右侧目录不显示 #

检查页面 front matter：

toc: true

还要确认正文有二级标题：

## 标题

如果只有一级标题或没有足够标题，右侧目录可能为空。

左侧导航不对 #

重点检查：

• config/_default/menus/menus.en.toml 里是否有顶层 [[docs]]。
• 页面 front matter 的 menu.docs.parent 是否正确。
• weight 是否合理。
• 页面是否在 content/en/docs/ 下。

样式没生效 #

先确认改的是源文件：

assets/scss/
layouts/

再重新构建：

npm run build

如果本地生效但线上没生效，检查是否已经提交并推送到 GitHub。

页面太挤或太空 #

优先看这些样式文件：

修改后同时检查浅色和深色模式。

敏感信息规则 #

不要写进文档或提交到仓库：

• .env 中的真实值。
• 数据库密码。
• API Token。
• Cookie。
• 私钥。
• 数据库文件。
• 备份包。

可以写变量名和示例占位符，例如 HALO_DB_PASSWORD，但不要写真实密码。

三个站点怎么分工 #

简单入口放导航站，操作流程放文档站，完整文章放博客。