You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

51 lines
1.3 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 常见问题
这里列出了使用文档站点时可能遇到的常见问题及其解答。
## 文档站点无法正常显示
**问题:** 访问 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文件中使用相对路径引用例如
```markdown
![图片描述](images/example.png)
```

Powered by TurnKey Linux.