fan-lv / fan Goto Github PK

View Code? Open in Web Editor NEW

160.0 4.0 36.0 2.62 MB

hexo-theme

JavaScript 23.12% Pug 20.14% Stylus 56.74%

hexo-theme pug stylus

fan's Introduction

Fan

这是一个深色主题，如梦幻般的星空，群星闪烁。

Preview

Install

git clone https://github.com/fan-lv/Fan.git themes/Fan

修改位于博客根目录下的 _config.yml 内的 theme 选项值为 Fan

Update

cd themes/Fan
git pull

Required packages

hexo-renderer-jade
hexo-renderer-stylus

若报错 extends includes/layout.pug block content include includes/recent-posts.pug include includes/pagination.pug

安装依赖包，重新生成

npm install --save hexo-renderer-jade hexo-renderer-stylus

Notes: 有说 hexo-renderer-jade 包过期的，可以用 hexo-renderer-pug

其他扩展依赖包参考

npm install --save hexo-generator-feed hexo-generator-sitemap hexo-generator-archive hexo-browsersync

Questions

若报错 layout\includes\config.pug:1, Cannot read property 'appId' of undefined, 需要把 themes -> _config.yml 中 algolia_search:enable 改成 false

Feature

Comments

目前支持 Gitment、Valine 评论。

使用方法：

在根目录下 _config.yml 文件中加入以下代码，["gitment", "valine"] 配置自行选择一个，第二步中选择使用哪个

comments:
  gitment:
    enable: true
    owner: 'Your GitHub ID'
    repo: 'The repository to store your comments. Make sure you're repo's owner'
    client_id: 'GitHub client ID'
    client_secret: 'GitHub client secret'

  # 可以自由配置 valine 的其他配置项
  valine:
    appId: 'Your appId'
    appKey: 'Your appKey'
    placeholder: 'xxx'
    ...(valine配置项，参考链接 https://valine.js.org/configuration.html)

themes -> _config.yml 中可以开启或关闭 comments，并且通过 type 指定使用的评论插件

# 评论
comments:
  enable: true
  # 使用哪种评论插件["gitment", "valine"]
  type: "valine"

Algolia_search

注册 Algolia账户，创建新的 Index，记下 index name
安装扩展
```
npm install hexo-algolia --save
```
修改 Algolia 搜索 ACL（访问控制列表）默认的 Search-Only API Key 不能修改，需要在 All API Keys -> New API Key

勾选 ACLs: search addObject deleteObject listIndexes deletelndex

执行安装
```
export HEXO_ALGOLIA_INDEXING_KEY=New API Key
hexo algolia
```
Notes: Mac 和 git bash 为 export, Windows 为 set, Powershell 用 $env

获取 Key，更新站点根目录配置

algolia:
  applicationID: 'Application ID'
  apiKey: 'New API Key'
  indexName: 'index name'

主题配置下开启 Algolia_search
```
algolia_search:
  enable: true
  hits:
    per_page: 10
```
注意，每次更新文章后记得执行 hexo algolia 更新索引。

License

MIT

fan's People

Contributors

Stargazers

Watchers

fan's Issues

gitment评论问题

我给我的blog配置了gitment评论，部署之后gitment评论好像没用，不能初始化

大佬，这个主题我用一用哈

这是我博客的连接：https://konglinlin.github.io
再次谢大佬提供的主题

hexo5.0.0+版本toc不会跳转

5.0.0+版的hexo在toc生成时会对中文toc-link进行编码，但是文章本体的toc-link地址不会编码。导致scroll.js的监听事件读取到的toc-link地址不匹配，无法正确的激活sidebar的toc。
我fork以后在sidebar.js最后加了一个对toc的toc-link的href进行decode的过程，sidebar就可以正常跳转和激活了。

Help!!

#Update
How to use localsearch or algolia? Can show me your config algolia or localsearch!!

在哪里添加备案信息？

在两个 config.yml 中都没有找到适合用于添加备案信息的 div 。希望能添加一个 div 用于在 footer 中显示自定义内容。

请教下为啥我在本地显示不出来呢

页面上显示这个，不知道为啥，其它有pug标签的主题都试了，都不行
extends includes/layout.pug block content include includes/recent-posts.pug include includes/pagination.pug

建议将_config.yml下面的algolia_search默认改为enable: false

很多人可能并不会使用algolia作为搜索引擎,现在配置文件里面默认enable的情况下,hexo编译会报错,建议默认改为disable.

algolia_search:
  enable: false

Feature Request

1.can add the nprogress support ?
2.how can i add GitHub Corners?
3.how to add menu icon？
4. how to use search?

建议去掉鼠标滚轮的惯性滚动效果

电脑上在鼠标滚轮滚动时似乎模拟了触摸屏的惯性滚动效果，但是触屏惯性是系统层次实现的，想停在某一具体位置只需点击屏幕，而在滚轮滚动时使用惯性滚动很难控制滚动到某一细节位置。建议去掉这个效果。

layout.pug文件中 css link的url希望可以加上根目录地址。

css引用在部署的连接错误，更改layout.pug中样式的href为url_for(url)。
link(rel='stylesheet', href=url_for(url)) link(rel="icon", href=url_for(theme.favicon))

细节问题补充（对新手友好）

在 config 文件中加入以下代码

这里希望补充一下，是总配置文件里的 _config.yml ，对小白更友好，期待主题可以变得更完美

更换完主题打开页面是白屏

Error with Permissions-Policy header: Unrecognized feature: 'interest-cohort'.

安装依赖后，部署或生成静态文件都不能正常进行

ERROR D:\hexo\themes\Fan\layout\includes\layout.pug:11

可以适配移动端嘛？

您好，很喜欢您这个主题，很漂亮，也很喜欢深色主题。

但是在手机上打开您的博客主页仍然是以 PC 端的方式打开的，体验不太好，后期会优化嘛？

_{Sent from PPHub For GitHub}

404页面问题

hexo new page 404后添加title: Page Not Found，permalink: /404，页面的确转跳404，但是标题是menu.Page Not Found

求助！配置完algolia搜索栏无法弹出内容，有人知道如何解决么？

algolia已经完成配置，并加载到config中且hexo algolia无报错，但是在页面中无法查找

layout.pug文件报错

Unhandled rejection TypeError: F:\Blog\themes\Fan\layout\includes\layout.pug:11
9|
10| - var pageDescription = page.description || page.title || config.description || ''

11| - var pageKeywords = (config.keywords || []).join(',')
12| - if (page.tags && page.tags.data) pageKeywords = page.tags.data.map(function(tag) {return tag.name;}).join(',')
13| - var pageAuthor = config.author + ',' + config.email
14| - var pageCopyright = config.copyright || config.author

(config.keywords || []).join is not a function

第11行报错，说不是一个类

excuse me

WARN No layout: index.html

hexo s
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
WARN No layout: index.html