_meta.json 概述与基本格式

Docs 站点的侧边栏导航不是自动生成的，而是通过每个目录下的 _meta.json 文件来配置。这套机制决定了侧边栏的显示名称、排列顺序和层级结构。

什么是 _meta.json

_meta.json 是一个放在内容目录中的 JSON 配置文件，每个目录最多放一个。它的核心作用有两个：

• 映射显示名称 — 将文件名或目录名映射为更友好的名称（如 wsl2 → WSL 2 安装与通用配置指南）
• 控制排序 — 严格按照 JSON 中键的声明顺序渲染侧边栏

以点开头的目录（如 .obsidian）和 _meta.json 本身不会被纳入文档扫描。

基本格式

最简单的 _meta.json 是一个扁平的键值对对象，键为目录名或文件名（不含扩展名），值为显示名称：

{  "ollama": "Ollama 快速入门",  "docker": "Docker 快速入门"}

对应目录结构：

local/ ├── _meta.json ├── ollama.md └── docker.md

侧边栏会将 ollama 显示为 "Ollama 快速入门"，docker 显示为 "Docker 快速入门"，且 ollama 排在 docker 前面。