docs(plugin-active-header-links): add plugin reference

Author: meteorlxy

docs/reference/plugin/active-header-links.md

@@ -1,3 +1,56 @@
 # active-header-links
 
-> TODO
+> @vuepress/plugin-active-header-links
+
+This plugin will listen to page scroll event. When the page scrolls to a certain _header anchor_, this plugin will change the route hash to that _header anchor_ if there is a corresponding _header link_.
+
+This plugin is mainly used to develop themes, and has been integrated into the default theme. You won't need to use it directly in most cases.
+
+## Options
+
+### headerLinkSelector
+
+- Type: `string`
+
+- Default: `'.sidebar-link'`
+
+- Details:
+
+  Selector of _header link_.
+
+  If a _header anchor_ does not have a corresponding _header link_, this plugin won't change the route hash to that anchor when scrolling to it.
+
+### headerAnchorSelector
+
+- Type: `string`
+
+- Default: `'.header-anchor'`
+
+- Details:
+
+  Selector of _header anchor_.
+
+  You don't need to specify this option unless you have changed the `permalinkClass` option of [markdown-it-anchor](https://github.com/valeriangalliat/markdown-it-anchor#readme) via [markdown.anchor](../config.md#markdown-anchor).
+
+- Also see:
+  - [Guide > Markdown > Syntax Extensions > Header Anchors](../../guide/markdown.md#header-anchors)
+
+### delay
+
+- Type: `number`
+
+- Default: `200`
+
+- Details:
+
+  The delay of the debounced scroll event listener.
+
+### offset
+
+- Type: `number`
+
+- Default: `5`
+
+- Details:
+
+  Even if you click the link of the _header anchor_ directly, the `scrollTop` might not be exactly equal to `offsetTop` of the _header anchor_, so we add an offset to avoid the error.

docs/zh/reference/plugin/active-header-links.md

@@ -1,3 +1,56 @@
 # active-header-links
 
-> TODO
+> @vuepress/plugin-active-header-links
+
+该插件会监听页面滚动事件。当页面滚动至某个 _标题锚点_ 后，如果存在对应的 _标题链接_ ，那么该插件会将路由 Hash 更改为该 _标题锚点_ 。
+
+该插件主要用于开发主题，并且已经集成到默认主题中。大部分情况下你不需要直接使用它。
+
+## 配置项
+
+### headerLinkSelector
+
+- 类型： `string`
+
+- 默认值： `'.sidebar-link'`
+
+- 详情：
+
+  _标题链接_ 的选择器。
+
+  如果一个 _标题锚点_ 没有对应的 _标题链接_ ，那么及时滚动到这个 _标题锚点_ ，该插件也不会更改路由 Hash 。
+
+### headerAnchorSelector
+
+- 类型： `string`
+
+- 默认值： `'.header-anchor'`
+
+- 详情：
+
+  _标题锚点_ 的选择器。
+
+  你通常不需要设置该选项，除非你通过 [markdown.anchor](../config.md#markdown-anchor) 修改了 [markdown-it-anchor](https://github.com/valeriangalliat/markdown-it-anchor#readme) 的 `permalinkClass` 选项。
+
+- 参考：
+  - [指南 > Markdown > 语法扩展 > 标题锚点](../../guide/markdown.md#标题锚点)
+
+### delay
+
+- 类型： `number`
+
+- 默认值： `200`
+
+- 详情：
+
+  滚动事件监听器的 Debounce 延迟。
+
+### offset
+
+- 类型： `number`
+
+- 默认值： `5`
+
+- 详情：
+
+  即便直接点击 _标题锚点_ 的链接， `scrollTop` 也可能不会完全等于 _标题锚点_ 的 `offsetTop` ，所以我们添加一个 Offset 偏移量来避免这个误差。