vuepress-plugin-netlify-functions
v1.0.0-rc.71
Published
The Plugin for VuePress 2, Support Netlify Functions
Downloads
266
Maintainers
Readme
vuepress-plugin-netlify-functions
English | 简体中文
如果你的 vuepress 站点是部署在 netlify
的,而且希望能够使用netlify functions
来做 serverless
。
那么你可能需要本插件提供支持。
功能
- 在 vuepress 本地服务器上,启动一个
netlify functions
本地服务,帮助你在本地对functions
进行调试。 - 帮助生成一个 可用的
netlify.toml
,如果你已经创建了netlify.toml
,会添加合适的functions
配置 - 本插件不提供具体的
function
脚本,仅提供netlify functions
支持;可以在主题中直接只用,也可以在 vuepress 项目中直接使用,也可以基于本插件,开发新的插件提供更详细的功能支持。 - 使用
dotenv
在本地服务环境提供 类似于netlify environment variables
支持。 在项目根目录下 创建.env
文件用于保存开发时环境变量
安装
npm install vuepress-plugin-netlify-functions
# or
pnpm add vuepress-plugin-netlify-functions
# or
yarn add vuepress-plugin-netlify-functions
使用
在 vuepress 项目中,或者在一个 vuepress 主题中
// .vuepress/config.[jt]s import { netlifyFunctionsPlugin } from 'vuepress-plugin-netlify-functions' export default { // ... plugins: [ netlifyFunctionsPlugin() ] // ... }
在 vuepress plugin 中:
import { useNetlifyFunctionsPlugin } from 'vuepress-plugin-netlify-functions' function myPlugin(): Plugin { return (app: App) => { const { // 请求前缀, 默认 /api proxyPrefix, preparePluginFunctions, generatePluginFunctions } = useNetlifyFunctionsPlugin(app, { // 指定插件的functions目录,相关脚本在此目录中开发 directory: path.resolve(__dirname, 'functions') }) return { name: 'vuepress-plugin-myPlugin', onPrepared: () => preparePluginFunctions(), onGenerated: () => generatePluginFunctions(), } } }
Methods
netlifyFunctionsPlugin(options)
插件函数。
在 vuepress 配置中,或者在 vuepress 主题配置中使用。
options
options.sourceDirectory
functions 源文件夹。默认 `app.dir.source('.vuepress/functions') 目录。
options.destDirectory
functions 输出文件夹。默认 `app.dir.dest('function') 目录
options.proxyPrefix
proxy代理前缀。默认
/api
。functions下的请求通过
/api
转发
useNetlifyFunctionsPlugin(app, options)
在 开发 vuepress 插件时, 在插件中使用
app
: Appoptions.directory
插件中的 functions 开发目录
查看详细说明文档
待补充
Example
示例
插件开发示例
- vuepress-plugin-page-collection
基于 netlify-functions 的,通过在 functions中连接
leancloud
实现 博客文章页 阅读数/访问次数 的记录与展示。