hexo

hexo

四月 09, 2018

github

一共需要需要3个仓库。

  • blog成品仓以oddme.github.io为例,用于放置blog主站文件。
  • blog制品仓以hexoBlog为例,用于放置hexo相关代码以及blog文章md文件。
  • blog评论仓库以gitalk为例,用于接入gitalk评论模块。

hexo

npm install -g hexo
hexo init
npm install
hexo g //生成
hexo s //启动本地服务
hexo d //发布

hexo 主题

你可以到官网找你喜欢的主题进行下载 hexo themes 知乎:有哪些好看的 Hexo 主题?

这里以Diaspora为例

在hexo目录下的themes目录中

git clone https://github.com/Fechin/hexo-theme-diaspora.git diaspora

修改hexo配置文件 _config.yml 主题项设置为diaspora

...
theme: diaspora
...

更新主题需要在更新时先备份 _config.yml 配置文件

cd themes/diaspora
git pull

主题source中的所有文件和hexo根目录source目录一样都会在编译后放到public根目录下。

新建文章模板

---
title: My awesome title
date: 2016-10-12 18:38:45
categories: 
    - 分类1
    - 分类2
tags: 
    - 标签1
    - 标签2
mp3: http://domain.com/awesome.mp3
cover: http://domain.com/awesome.jpg
---

创建分类页

  • 新建一个页面命名为categories,使用hexo new page [filename] 的方式创建的页面不会作为文章生成在_post下,而是在_post同级目录生成新的页面目录。

    hexo new page categories

  • 编辑刚新建的页面,将页面类型设置为categories

---
title: categories
date: 2014-12-22 12:39:04
type: "categories"
---

主题将自动为这个页面显示所有标签

创建标签页

  • 新建一个页面命名为tags

    hexo new page tags

  • 编辑刚新建的页面,将页面类型设置为tags

---
title: tags
date: 2014-12-22 12:39:04
type: "tags"
---

主题将自动为这个页面显示所有分类

主题配置

# 头部菜单,title: link
menu:
    Whoami: /whoami
    Github: https://github.com/Fechin
    Twitter: https://twitter.com/FechinLi
    分类: /categories
    归档: /archives
    标签云: /tags

# 是否显示目录
TOC: false

# 是否自动播放音乐
autoplay: false

# 默认音乐(随机播放)
mp3: 
    - http://link.hhtjim.com/163/425570952.mp3
    - http://link.hhtjim.com/163/425570952.mp3

# 首页封面图, 为空时取文章的cover作为封面
welcome_cover: # /img/welcome-cover.jpg

# 默认文章封面图
cover: /img/cover.jpg

# Gitalk 评论插件(https://github.com/gitalk/gitalk)
gitalk:
    # 是否自动展开评论框
    autoExpand: false
    # 应用编号
    clientID: ''
    # 应用秘钥
    clientSecret: ''
    # issue仓库名
    repo: ''
    # Github名
    owner: ''
    # Github名
    admin: ['']
    # Ensure uniqueness and length less than 50
    id: location.pathname
    # Facebook-like distraction free mode
    distractionFreeMode: false

# 网站关键字
keywords: Fechin

# 要使用google_analytics进行统计的话,这里需要配置ID
google_analytics: 

# 网站ico
favicon: /img/favicon.png

# rss文件
rss: atom.xml

gitalk

diaspora主题评论模块使用的是gitalk

创建github application

gitalk 需要一个github application,点击这里申请

填写参数如下
创建application

获取Client ID 和 Client Secret 填入diaspora配置中

client ID

至此,hexo配置就全部完成了可以开始写文章了