友链朋友圈——添加鱼塘
hexo-circle-of-friends后端
前端
开始
后端部署
按照文档即可https://fcircle-doc.yyyzyyyz.cn/#/
推荐github部署,sqlite存储
直接开始https://fcircle-doc.yyyzyyyz.cn/#/backenddeploy
fork友链朋友圈的项目仓库
更改/hexo_circle_of_friends/fc_settings.yaml文件
添加4个环境变量
fork后进入自己的仓库,依次settings>>左侧secrets and variables>>Actions
按照文档新建:()
添加4个环境变量secret:
- GH_NAME:github名称,也就是你的用户名
- GH_EMAIL:github邮箱,填写你注册github的邮箱
- GH_TOKEN:github访问token,获取方式,请参考官方文档,其中,Select scopes选择repo和workflow。
- STORAGE_TYPE:存储方式,填写sqlite
获取token
对于token,官方文档没有写太清楚
获取方式
- 点击个人头像
- setting
- 左侧最下Developer Settings
- Personal access token
- Tokens(classic)
或者直接
然后创建Personal access tokens (classic)
Generate new token (classic)
(关键性操作可能需要输入密码)
Note:注记 就取个名字
Expiration: 到期 有效期
下面的只要选这几个就行
创建 复制token
完成后是这样的
给与仓库的读写权限
回到自己fork的仓库
点击仓库的setting–>Actions–>General–>勾选Read and write permissions–>Save
最下面按照图示
去vercel部署
这步基本没问题
看教程就行
https://fcircle-doc.yyyzyyyz.cn/#/backenddeploy
github action
接下来,回到github,启用fork后仓库的github action,点击Actions–>I understand my workflows, go ahead and enable them
之后点击update-friends-posts并启用workflow
然后点击Run workflow—>Run workflow进行第一次运行
等待运行完毕后,仓库应该会上传data.db,并且vercel也会同步更新。
后端部署完成
检查
在vercel自定义域名或者分配的域名即未提供给前端使用的api
比如我的:https://friends.polar-bear.eu.org/
在这之后加上/all
如果可以看到友链文章信息,说明部署成功
https://friends.polar-bear.eu.org/all
前端
使用安知鱼的鱼塘朋友圈
安装插件
在博客根目录[Blogroot]下打开终端,运行以下指令(与旧版前端方案不兼容,如有安装旧版请先卸载):
1 | npm uninstall hexo-butterfly-fcircle --save |
添加配置信息
在站点配置文件_config.yml或者主题配置文件例如_config.butterfly.yml中添加
1 | # fcircle |
插件参数释义
参数 | 备选值/类型 | 释义 |
---|---|---|
enable | true/false | 控制开关 |
apiurl | URL | api 链接,配置教程参看后端部署文档 |
initnumber | number | 【可选】填写阿拉伯数字,页面展示文章数量,默认 20 |
stepnumber | number | 【可选】填写阿拉伯数字,每次加载增加的篇数,默认 10 |
error_img | URL | 【可选】头像图片加载失败时的默认头像 |
css | URL | 【可选】开发者接口,自定义 css 链接 |
js | URL | 【可选】开发者接口,自定义 js 链接 |
fetchJs | URL | 【可选】开发者接口,自定义 fetchJs 链接 |
randomFriendsPostJS | URL | 【可选】开发者接口,自定义 randomFriendsPostJS 链接 |
path | string | 【可选】字符串,fcircle 的路径名称。默认为 fcircle,生成的页面为 fcircle/index.html |
topIcon | string | 【可选】字符串,顶部按钮的图标类名 |
topLink | URL | 【可选】字符串,顶部按钮点击跳转的链接(仅支持 pjax 跳转) |
front_matter | object | 【可选】写法见上文示例,fcircle 页面的 front_matter 配置 |
top_background | URL | 【可选】字符串,页面顶部模块背景图 |
其他
其他的还是去看安知鱼的教程
注意
这里有几个问题
- top_background:改成自己的背景图
- path: /fcircle 说明生成的页面为fcircle,如https://polar-bear.eu.org/fcircle/
- randomFriendsPostJS: https://npm.elemecdn.com/hexo-filter-fcircle-anzhiyu@1.1.2/assets/js/random-friends-post.js
这个js用的是安知鱼友链的API
作用是鱼塘的钓鱼
随机钓一篇文字
需要换成自己的API(否则会钓别人的鱼)
js文件:https://npm.elemecdn.com/hexo-filter-fcircle-anzhiyu@1.1.2/assets/js/random-friends-post.js
display
1 | ; |
将
1 |
|
基本上就是这些问题,如果还有其他问题
欢迎加入建站交流群766354968