FAQ

# 1. 如何添加 icon-font ？

1. 将字体文件放在 public 文件夹下，然后在 enhanceApp.js 中引入字体文件中的css文件即可生效;
2. 如果你的 icon 完整的 className 是 class="iconfont icon-myIcon"，设置 icon-font 时应设置为 { text: '首页', link: '/', icon: 'iconfont icon-myIcon' }。

# 2. 如何显示摘要？

文档中 <!-- more --> 以上部分会被当作摘要。

---
title: 摘要
date: 2019-11-01
---

这里的内容会被显示成摘要。

1. 可以放置文案；
2. 可以放置图片作为文章封面。

<!-- more -->

这里是文章的正文。

# 3. 首页页脚是否可以自定义？

不可以。

# 4. 首页右侧信息栏头像和导航栏左侧的图片分别怎么设置？

首页右侧信息栏头像需要通过配置 .vuepress/config.js 中的 themeConfig.authorAvatar

// .vuepress/config.js
module.exports = {
  themeConfig: {
    authorAvatar: '/avatar.png'
  }
}

导航栏左侧的图片需要通过配置 .vuepress/config.js 中的 themeConfig.logo

// .vuepress/config.js
module.exports = {
  themeConfig: {
    logo: '/head.png'
  }
}

此外，你需要将你的图片放在 .vuepress/public/ 中

# 5. 文章的存放位置有规定吗？

你可以将你的文章存放在任意位置，但是你需要保证它是 VuePress 可以解析的位置，比如你使用的命令是 vuepress dev docs ，那么请将所有文章存放在 docs/ 中，但是主题并不会强制你放在哪个子目录，这个按照你的喜好来即可，详情见 详细的 VuePress 目录结构配置。

# 6. 侧边栏为什么不显示一级标题？

在 vuepress-theme-reco 中，请摒弃一级标题，使用 front-matter 生成标题以及其他文章信息，正文从二级标题开始。

# 7. 1.1.0 版本会在首页出现评论怎么解决？

该问题已经在 1.1.1 版本中得到解决。

# 8. 如何自定义评论区样式？

VuePress 允许你在 .vuepress/styles/index.styl 为你的网站添加样式，你可以通过这个方式来修改主题（包括评论区）内的基本所有样式，详情请见 VuePress 添加样式。

# 9. 是否支持图片点击放大功能？

主题在 1.1.1 中已经将 @vuepress/medium-zoom 作为内置插件，支持文章内容中的图片点击放大功能，详情见 主题内置插件。

# 10. 插件或者主题不生效怎么办？

请按以下步骤进行检查：

1. 查看编译时终端的输出信息是否已加载插件

   • 如果未加载该插件，请检查 config.js 是否已按正确格式进行配置。
   • 如果显示该插件加载错误，请检查该插件是否已经下载安装。
   • 如果已经下载安装后仍然无法正常加载插件，请删除 node-modules/ ，并重新安装依赖（建议使用 yarn 而不是 npm）。

2. 如果是在前端生效的插件，检查控制台看是否有报错信息，根据报错信息查找原因。

3. 仔细对比文档中的支持的 Options，重新配置 config.js。

4. 搜索插件所在项目或者社区有没有相似 issue 及解决方案。