Awesome Open Source
Awesome Open Source

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.ymlalgolia_search:enable 改成 false

Feature

Top article

支持文章置顶功能,在需要置顶的文章(Markdown 文件)加入 top: 1,数值越大越靠前。

如:

title: xxx
author: xxx
tags:
  - xxx
categories:
  - xxx
date: xxx
top: 1

Comments

目前支持 GitmentValine 评论。

使用方法:

  1. 在根目录下 _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)
    
  2. themes -> _config.yml 中可以开启或关闭 comments,并且通过 type 指定使用的评论插件

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

Algolia_search

  1. 注册 Algolia账户,创建新的 Index,记下 index name

  2. 安装扩展

    npm install hexo-algolia --save
    
  3. 修改 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

  4. 获取 Key,更新站点根目录配置

    algolia:
      applicationID: 'Application ID'
      apiKey: 'New API Key'
      indexName: 'index name'
    
  5. 主题配置下开启 Algolia_search

    algolia_search:
      enable: true
      hits:
        per_page: 10
    

    注意,每次更新文章后记得执行 hexo algolia 更新索引。

主题预览图

License

MIT

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Theme (43,478
Renderer (4,618
Stylus (2,753
Pug (2,441
Jade (2,346
Hexo (2,065
Algolia (861
Hexo Theme (396
Algolia Search (119