在使用 Firekylin 时,您可能会遇到一些问题,下列的常见问题解答可能会对您有所帮助。如果您在这里找不到解答,可以在 GitHub 上提问。
博客后台地址是什么?
你的博客地址 + /admin
文章如何设置摘要?
在你的文章中插入 <!—more—>
该标签之前的即为文章摘要
如何修改端口?
默认 Firekylin 用的端口是 8360
,如果该端口已经被占用或者不想使用该端口,那么可以在项目目录下新建文件 port
(是的,这个文件没有后缀名),文件内容为端口号。如:
设置文件 port
的内容为 9999
,表示设置的端口为 9999
。
后台菜单设置的菜单属性是什么?
菜单属性就是对应该菜单的附加属性,主题内可以获取到这个属性对菜单进行对应操作。例如默认主题里会直接读取属性内容作为字体图标的名称。当然你也可以自定义设置一个 JSON 数据在主题中解析获取菜单的更多属性。
如何添加emoji表情支持?
- 首先需要保证需要 MySQL 的版本大于等于 5.5.3。
- 数据库
fk_post
中的title
,summary
,markdown_content
,content
字段的数据类型需要修改为utf8mb4
。 - 同时修改
app/common/config/db.js
文件,增加一个encoding: 'utf8mb4'
的键值对。
如何实现内网登录?
只要安装对应的登录适配模块 firekylin-auth-xxx
(xxx为具体模块名),就可以自动识别增加内网登录支持。
如果没有对应的适配模块,需要实现一个名为 firekylin-auth-xxx
的模块,后面的 xxx
随便定义。模块需要导入一个以 req
和 res
为参数的方法,并返回 {name, email, display_name}
的对象,具体示例如下:
- module.exports = function(req, res) { //Firekylin 调用的时候会传入原始的 req 和 res 对象
- // 具体的登陆逻辑
- const user = getUserInfo(req, res);
- //需要返回如下三个属性,其中 name 和 email 是必须
- return {
- name: user.userName,
- email: user.userMail,
- display_name: user.displayName
- };
- }