Chinese Simplified Maintaining the Wiki

维护 Wiki

GitHub 的 Wiki 是独立的 Git 仓库。GitHub 命令行界面（gh）可以认证 Git、启用或打开 Wiki，并提供仓库上下文，但当前并不包含用于创建或编辑 Wiki 页面的本地命令。

一次性设置

GitHub 在允许克隆 Wiki 仓库之前，首页必须存在。此 Wiki 已经初始化，因此维护者可以直接使用本地工作流程。

认证并配置 Git 凭证处理：

gh auth login
gh auth setup-git

克隆 Wiki 仓库：

git clone https://github.com/Appshines/Voice2Win.wiki.git
Set-Location Voice2Win.wiki

编辑和发布

每个 Markdown 文件就是一页。文件名会成为页面地址；例如，Getting-Started.md 会发布为 Getting-Started。_Sidebar.md 控制导航侧边栏。

编辑后：

git add --all
git commit -m "Update Voice2Win user guide"
git push

只有推送到 wiki 仓库默认分支的更改才会对读者可见。

有用的 GitHub CLI 命令

打开 wiki：

gh browse --wiki --repo Appshines/Voice2Win

验证功能是否已启用：

gh repo view Appshines/Voice2Win --json hasWikiEnabled

如有必要，启用它：

gh repo edit Appshines/Voice2Win --enable-wiki

内容约定

• 按语言对页面进行分组，并在每种语言中使用一致的标签。
• 保持主页简短，将详细信息引导至专门页面。
• 每当页面被添加、删除或重命名时，更新 _Sidebar.md。
• 优先使用稳定描述，而不是特定版本的截图或精确下载文件名。
• 明确记录平台差异。
• 页面中首次出现缩写时进行解释。
• 绝不发布配对令牌、密码、私人日志或个人录音。
• 页面重命名后测试每个内部链接。

GitHub 官方指南：添加或编辑 wiki 页面。