starter_docsify/doc/faq.md

常见问题

这里列出了使用文档站点时可能遇到的常见问题及其解答。

文档站点无法正常显示

问题： 访问 http://localhost:3000 后页面空白或显示错误。

解决方法：

• 确认服务器已成功启动（npm run start）
• 检查index.html中的basePath配置是否正确
• 确认doc目录下有home.md文件

侧边栏不显示

问题： 页面加载后没有显示侧边栏。

解决方法：

• 确认index.html中的loadSidebar配置为true
• 检查doc目录下是否存在_sidebar.md文件
• 确认_sidebar.md的格式是否正确

如何添加新的导航项

问题： 如何在侧边栏中添加新的导航项？

解决方法：

1. 在doc目录下创建新的Markdown文件
2. 在_sidebar.md中添加对应的链接，格式为 * [页面标题](文件名.md)

如何修改页面样式

问题： 如何修改文档页面的样式？

解决方法：

• 修改css/vue.css文件
• 或者在index.html中引入自定义的CSS文件

如何添加图片

问题： 如何在Markdown文件中添加图片？

解决方法：

1. 在doc目录下创建images文件夹
2. 将图片放入该文件夹
3. 在Markdown文件中使用相对路径引用，例如：

![图片描述](images/example.png)