paper

🎨 paper 是一个简洁，没有过多冗余视觉元素和功能的 hexo 主题，其设计风格的灵感来源于📰 报纸等纸质读物。而且主题以一种💡极其巧妙的方式实现了当下(2019)流行的🌗Dark Mode，一键可开启。

简体中文｜ English

如何使用

安装

# 在你的 hexo 顶层文件夹下
cd themes
# clone 该项目
git clone git@github.com:random-yang/paper.git

安装 stylus 和 pug 转换工具(由于 hexo init 后默认可能没有安装下面的两个)

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

修改配置文件

# 在你的 _config.yml 文件中设置
theme: paper
# 同时为了代码高亮，你需要将下面的内容粘贴到该文件（如果之前存在highlight字段，记得删除后再粘贴）
highlight:
  hljs: true
  enable: true
  line_number: false
  auto_detect: true
  tab_replace: ''

# 清空并重新编译
hexo clean && hexo s
# done
# 在临时开启的本地server中你应该能看见应用了paper主题的blog！

配置项

在 theme/paper 目录下的 _config.yml 文件中进行配置

社交账号

social:
  Github: https://github.com/yours
  Codepen: https://codepen.io/yours
  Dribbble: https://dribbble.com/yours
  twitter: https://twitter.com/yours
  知乎: https://www.zhihu.com/people/yours
  掘金: https://juejin.im/user/yours
  Mail: mailto:xxx@yourmail.xxxx
  Rss: your-rss-link-url
  # ...
  # and more, you can add other link by the same way

除了提供的，您还可以添加其他未列出的

主题色

main_color: default # forest | grass | sky | sun | sea

这里提供了 6 种可通过直接配置修改的颜色，当然，如果您都不喜欢，可以自己进入themes/paper/source/css/var.styl修改变量渲染出你想要的颜色。

右边栏可见内容

取消注释则表示关闭该内容

# Uncomment to disable sidebar
# toc: false
# link: false
# archives: false
# categories: false
# tags: false

posts 列表预览文章图片

在文章 markdown 头部写：

photos:
- your-images-url
# The following pictures will be ignored
# - ...
# - ...

默认只取列表中的第一个 url，后面的将被忽略。

google Analytics

# google Analytics
google_analytics_id: xx-xxxxxxx-xx

文章置顶

首先，在项目中安装 hexo-generator-index-pin-top 依赖，然后在文章 markdown 头部写：

top: true

添加 Rss 订阅

根据hexo-generator-feed的引导，生成atom.xml文件，然后在themes/paper/_config.yml中配置

social:
  - Rss: your-rss-link-url

评论模块配置

# commend module
comment:
  enable: false # true to enable
  appId: your-app-id
  appKey: your-app-key
  placeholder: say something
  notify: false
  verify: false
  avatar: mp

开启数学公式

卸载 hexo-math

npm uninstall hexo-math

卸载 hexo-renderer-marked

npm uninstall hexo-renderer-marked

安装 hexo-renderer-kramed

npm install hexo-renderer-kramed --save

更新 _config.yml

# 添加
math:
  engine: 'mathjax'
  mathjax:
    enable: true
    cdn: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM_CHTML