Menu
优化 gliderRecord Docsify 知识库网站，包括文档结构、侧边栏、样式、性能和 SEO 等方面的优化。当用户提到「优化网页」「改进文档」「美化页面」「提升性能」等需求时使用此 skill。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | webpage_optimization |
| description | 优化 gliderRecord Docsify 知识库网站，包括文档结构、侧边栏、样式、性能和 SEO 等方面的优化。当用户提到「优化网页」「改进文档」「美化页面」「提升性能」等需求时使用此 skill。 |
本 skill 用于优化 gliderRecord Docsify 知识库网站。项目部署于 GitHub Pages，使用 Docsify 4.x 纯静态方案，核心文件为根目录的 index.html、_sidebar.md、_coverpage.md。
.md 文件必须有且只有一个 # 一级标题.{文件名}.assets/ 隐藏文件夹中.{文件名}.assets/image.png python 、 bash 新建文档时参考 themes/template-cn.md（中文模板）或 themes/template-en.md（英文模板）。
_sidebar.md）**加粗** 配合 emoji 图标，例如：* **💼 工作记录**[文档标题](record/standard_record/xxx.md)_sidebar.md_sidebar.md 对应分类下添加一行：
* [文档标题](相对路径/文件名.md)
index.html 配置优化window.$docsify）关键配置项说明：
window.$docsify = {
name: '...', // 侧边栏顶部标题
repo: '...', // GitHub 仓库链接（右上角图标）
loadSidebar: true, // 启用自定义侧边栏
subMaxLevel: 3, // 侧边栏最多展示到 h3
auto2top: true, // 切换页面自动回到顶部
search: { ... }, // 搜索插件配置
copyCode: { ... }, // 代码复制按钮配置
}
修改主题色时，统一修改以下 CSS 变量（在 index.html 的 <style> 中）：
:root {
--lapis-primary: #4870ac; /* 主色 */
--lapis-text: #40464f; /* 正文颜色 */
--lapis-bg: #ffffff; /* 背景色 */
--lapis-block-bg: #f6f8fa; /* 代码块/引用块背景 */
--lapis-border: #e3e8f0; /* 边框颜色 */
--theme-color: var(--lapis-primary);
}
# 使用 ImageMagick 压缩图片（保持宽度 1200px，质量 85）
convert input.png -resize 1200x\> -quality 85 output.png
项目使用 cdn.jsdelivr.net 加载 Docsify 及插件，不要将 CDN 资源下载到本地，保持引用 CDN 链接：
<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
index.html 底部 <script> 加载顺序：
docsify@4）在 index.html 的 <head> 中确保以下 meta 标签完整：
<title>gliderRecord - 个人技术知识库</title>
<meta name="description" content="个人工作记录和知识库">
<meta name="keywords" content="技术文档,知识库,工作记录,机器人,ROS2,AGV">
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
themes/ 目录）| 文件 | 风格 |
|---|---|
lapis.css | Lapis 蓝（当前主风格） |
lapis-dark.css | Lapis 暗色 |
github.css | GitHub 风格 |
night.css | 深夜暗色 |
newsprint.css | 新闻纸风格 |
pixyll.css | 极简白 |
whitey.css | 纯净白 |
将 index.html 中的主题 CDN 链接替换为本地路径：
<link rel="stylesheet" href="themes/lapis.css">
# 1. 在对应目录创建 md 文件
touch record/standard_record/新文档.md
# 2. 创建图片资源目录
mkdir -p record/standard_record/.新文档.assets
# 3. 编写内容后，更新侧边栏
# 编辑 _sidebar.md，在「工作记录」分类下添加链接
# 4. 提交（遵循 git.mdc 规范）
git add record/standard_record/新文档.md _sidebar.md
git commit -m "docs(record): 新增《新文档》工作记录"
git push origin master
cd /home/std/project/gliderRecord
npm run dev
# 访问 http://localhost:3000
# 查看最大的 git 对象
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sort -k3 -n -r | head -20