}`
+## define
+- 类型： `object`
- 默认值： `{}`
-
- 详情：
-
- 多语言支持的各个语言 locales 。
-
- 可以使用的字段有：
-
- - [lang](#lang)
- - [title](#title)
- - [description](#description)
- - [head](#head)
-
-- 参考：
- - [指南 > I18n](../guide/i18n.md)
-
-## 主题配置
-
-### theme
-
-- 类型： `string`
-
-- 默认值： `'@vuepress/default'`
-
-- 详情：
-
- 你想要使用的主题的名称或绝对路径。
-
- 这个选项可以接收主题名称、主题简称或主题的绝对路径。
-
+
+ 用于提供给代码中可用的变量。
- 示例：
-
```js
-module.exports = {
- theme: 'vuepress-theme-foo',
- theme: 'bar',
- theme: '/path/to/local/theme',
+export default {
+ define: {
+ __DEV__: 'development'
+ }
}
```
+然后你代码里写 `console.log(__DEV__)`，会被编译成 `console.log('development')`。
-- 参考：
- - [指南 > 主题](../guide/theme.md)
-
-### themeConfig
-
-- 类型： `ThemeConfig`
+## devServer
+- 类型： `object`
- 默认值： `{}`
-
- 详情：
+
+ 配置开发服务器。支持以下子配置项：
- 为当前使用的主题提供的配置项。具体的配置项取决于你使用的主题。
+ - port，端口号，默认 `8000`
+ - host，默认 `localhost`
+ - https，是否启用 https server，同时也会开启 HTTP/2
-- 参考：
- - [默认主题 > 配置](./default-theme/config.md)
+ 启用 port 和 host 也可以通过环境变量 `PORT` 和 `HOST` 临时指定。
-## 打包工具配置
-
-### bundler
+## devtool
- 类型： `string`
-
-- 默认值： `'@vuepress/webpack'`
-
+- 默认值： `cheap-module-source-map` in dev, `undefined` in build
- 详情：
- 你想要使用的打包工具的名称。
+ 用户配置 sourcemap 类型。详见 [ webpack#devtool 配置](https://webpack.js.org/configuration/devtool/#devtool)。
- 可以使用打包工具名称的简称。
+## extraPostCSSPlugins
-- 参考：
- - [指南 > 打包工具](../guide/bundler.md)
+- 类型： `array`
+- 默认值： `[]`
+- 详情：
-### bundlerConfig
+ 设置额外的 [postcss 插件](https://github.com/postcss/postcss/blob/master/docs/plugins.md)。
-- 类型： `BundlerConfig`
-
-- 默认值： `{}`
-
-- 详情：
-
- 为当前使用的打包工具提供的配置项。具体的配置项取决于你使用的打包工具。
-
-## 目录配置
-
-### dest
-
-- 类型： `string`
-
-- 默认值： `` `${sourceDir}/.vuepress/dist` ``
-
-- 详情：
-
- 指定 `vuepress build` 命令的输出目录。
-
-### temp
-
-- 类型： `string`
-
-- 默认值： `` `${sourceDir}/.vuepress/.temp` ``
-
-- 详情：
-
- 指定临时文件目录。
-
-### cache
-
-- 类型： `string`
-
-- 默认值： `` `${sourceDir}/.vuepress/.cache` ``
-
-- 详情：
-
- 指定缓存目录。
-
-### public
-
-- 类型： `string`
-
-- 默认值： `` `${sourceDir}/.vuepress/public` ``
-
-- 详情：
-
- 指定 Public 文件目录。
-
-- 参考：
- - [指南 > 静态资源 > Public 文件](../guide/assets.md#public-文件)
-
-## Markdown 配置
-
-### markdown
-
-- 类型： `MarkdownOptions`
-
-- 默认值： `{}`
-
-- 详情：
-
- 对 VuePress 内置的 Markdown 语法扩展进行配置。
-
-- 参考：
- - [指南 > Markdown > 语法扩展](../guide/markdown.md#语法扩展)
-
-#### markdown.anchor
-
-- 类型： `AnchorPluginOptions | false`
-
-- 详情：
-
- [markdown-it-anchor](https://github.com/valeriangalliat/markdown-it-anchor) 的配置项。
-
- 设置为 `false` 可以禁用该插件。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 标题锚点](../guide/markdown.md#标题锚点)
-
-#### markdown.assets
-
-- 类型： `AssetsPluginOptions | false`
-
-- 详情：
-
- VuePress 内置的 markdown-it assets 插件的配置项。
-
- 设置为 `false` 可以禁用该插件。
-
-::: danger
-除非你了解它的用途，否则你不应该设置该配置项。
-:::
-
-#### markdown.code
-
-- 类型： `CodePluginOptions | false`
-
-- 详情：
-
- VuePress 内置的 markdown-it code 插件的配置项。
-
- 设置为 `false` 可以禁用该插件。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 代码块](../guide/markdown.md#代码块)
-
-##### markdown.code.highlight
-
-- 类型： `boolean`
-
-- 默认值： `true`
-
-- 详情：
-
- 是否启用代码块语法高亮。
-
- 如果你想在客户端进行语法高翔，你可以禁用该配置项。比如使用 [Prismjs](https://prismjs.com/) 或 [highlight.js](https://highlightjs.org/) 。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 代码块 > 语法高亮](../guide/markdown.md#语法高亮)
-
-##### markdown.code.highlightLines
-
-- 类型： `boolean`
-
-- 默认值： `true`
-
-- 详情：
-
- 是否启用代码块行高亮。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 代码块 > 行高亮](../guide/markdown.md#行高亮)
-
-##### markdown.code.lineNumbers
-
-- 类型： `boolean`
-
-- 默认值： `true`
-
-- 详情：
-
- 是否启用代码块行号。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 代码块 > 行号](../guide/markdown.md#行号)
-
-##### markdown.code.preWrapper
-
-- 类型： `boolean`
-
-- 默认值： `true`
-
-- 详情：
-
- 是否在 `` 标签外额外包裹一层。
-
- `highlightLines` 和 `lineNumbers` 依赖于这个额外的包裹层。这换句话说，如果你禁用了 `preWrapper` ，那么行高亮和行号也会被同时禁用。
-
- 如果你想要在客户端来实现这些功能时，可以禁用该配置项。比如使用 [Prismjs Line Highlight](https://prismjs.com/plugins/line-highlight/) 或者 [Prismjs Line Numbers](https://prismjs.com/plugins/line-numbers/)。
-
-##### markdown.code.vPre
-
-- 类型： `boolean`
-
-- 默认值： `true`
-
-- 详情：
-
- 是否在 `` 标签上添加 `v-pre` 指令。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > 代码块 > 添加 v-pre](../guide/markdown.md#添加-v-pre)
-
-#### markdown.customComponent
-
-- 类型： `undefined | false`
-
-- 详情：
-
- VuePress 内置的 markdown-it custom-component 插件的配置项。
-
- 设置为 `false` 可以禁用该插件。
-
-::: danger
-除非你了解它的用途，否则你不应该设置该配置项。
-:::
-
-#### markdown.emoji
-
-- 类型： `EmojiPluginOptions | false`
-
-- 详情：
-
- [markdown-it-emoji](https://github.com/markdown-it/markdown-it-emoji) 的配置项。
-
- 设置为 `false` 可以禁用该插件。
-
-- 参考：
- - [指南 > Markdown > 语法扩展 > Emoji](../guide/markdown.md#emoji)
-
-#### markdown.extractHeaders
-
-- 类型： `ExtractHeadersPluginOptions | false`
-
-- 详情：
-
- VuePress 内置的 markdown-it extract-headers 插件的配置项。
-
- 它将会把页面的标题提取到 Page Data 中，可以用于生成侧边栏、目录等。比如当前页面的侧边栏，就是由这个插件提取出的标题来自动生成的。
-
- 设置为 `false` 可以禁用该插件。
-
-#### markdown.hoistTags
-
-- 类型： `HoistTagsPluginOptions | false`
-
-- 详情：
-
- VuePress 内置的 markdown-it hoist-tags 插件的配置项。
-
- 它将会把你的 Markdown 中特定的 HTML 标签提升到 SFC 的顶层。默认情况下，只有 `
+
+```
+## API
+### get
+* `get(name: string)` 获取指定名字的枚举
+
+* `get(name: string, key: string)` 获取指定名字及键枚举默认值
+
+* `get(name: string, opt: {extend: Array