SEO

作为一个开源静态文档站点，我们希望用户能够通过搜索引擎更快的访问到需要的内容，因此SEO就显得尤为重要。

docsite对于markdown文档，提供了title、keywords、description三个元数据配置项。同时将对应的jsx页面渲染成静态HTML，组合到最终生成的页面中去。

对于非markdown文档页面，title、keywords、description三个配置项在项目根目录下的docsite.config.yml(v1.3.3版本添加，旧工程需手动添加该文件)中，内容如下：

  1. pages:
  2.  # key is the dirname of pages in src/pages, not including documentation and blogList that is related to markdown file
  3.  home:
  4.   # 首页配置
  5.   zh-cn:
  6.    title: '网页标签title'
  7.    keywords: '关键词1，关键词2'
  8.    description: '页面内容简介'
  9.   # home config
  10.   en-us:
  11.    title: 'page title'
  12.    keywords: 'keyword1,keyword2'
  13.    description: 'page description'
  14.  community:
  15.   # 社区页配置
  16.   zh-cn:
  17.    title: '网页标签title'
  18.    keywords: '关键词1，关键词2'
  19.    description: '页面内容简介'
  20.   # community page config
  21.   en-us:
  22.    title: 'page title'
  23.    keywords: 'keyword1,keyword2'
  24.    description: 'page description'
  25.  blog:
  26.   # 博客列表页配置
  27.   zh-cn:
  28.    title: '网页标签title'
  29.    keywords: '关键词1，关键词2'
  30.    description: '页面内容简介'
  31.   en-us:
  32.    # blog list page config
  33.    title: 'page title'
  34.    keywords: 'keyword1,keyword2'
  35.    description: 'page description'

在整个页面站点完成并发布后，为使搜索引擎更快的收录站点，需要向搜索引擎提供站点地图。

站点地图生成

打开站点中的某个页面（最好是文档页面和博客页面），将页面地址拷贝填入https://www.xml-sitemaps.com/的输入框，点击开始，会生成一份站点地图。

因站点的中英文版本之间无明显的链接相连，所以需中英文分别生成，然后手动合并成一份，并命名为sitemap.xml。当然，你也可以选择其他站点地图生成工具。

站点地图提交

除了将生成的站点地图文件放置在项目根目录外，你还可以主动向搜索引擎提供站点地图。目前主流的搜索引擎为Google和百度，可以分别向这两个搜索引擎的站长平台提交站点地图，链接为：