2018-04-24 hexo搭建自己的博客

git建库

首先要先建立一个以dreamthen(我的用户名).github.io结尾的repository,作为hexo托管代码的库,github默认.github.io结尾作为用户的网站二级域名。所以github用户搭建自己的个人网站很容易。

hexo安装

首先要用npm外部依赖包管理工具安装全局命令hexo-cli

npm install hexo-cli -g

然后使用hexo初始化博客文件夹,比如blog文件夹

hexo init blog

之后,进入生成的blog文件夹,下载外部依赖包

npm i/npm install

最后启动hexo自身搭建的服务,生成本地的博客网站,默认端口在本地ip地址下的4000端口,假如你不想启动在4000端口,也可使用-p 其他端口号进行配置,比如-p 9977

hexo server
hexo server -p 9977

默认的主题风格theme是landscape,假如你想更换,可以通过https://hexo.io/themes/进行筛选,筛选之后进行配置,主题配置见下文

hexo配置

  • hexo git配置

要想部署到自己搭建的个人网站github库里面,首先要下载hexo-git插件

npm install hexo-deployer-git --save

然后就要在你自己的本地hexo博客的项目里面,更改根目录底下的_config.yml文件,全局搜索git,更改deploy配置

deploy:
    type: git
    repo: git@github.com:dreamthen/dreamthen.github.io.git(你的个人网站github库的链接地址,最好使用git:开头的,https:开头的会报错)
    branch: master(分支名)
  • hexo theme主题配置

筛选好自己选中的主题之后,就需要在项目里面进行配置更换。首先需要下载远程github库里面的主题项目到项目根目录里面的themes文件夹底下,比如本人用的是next主题的hexo

git clone https://github.com/iissnan/hexo-theme-next.git themes/next

随后更改根目录里面的_config.yml文件,全局搜索theme,更改theme配置

theme: next

接着选择主题展示的方式,需要在主题的项目目录下,更改_config.yml文件,全局搜索Scheme,更改Scheme配置,比如next主题底下的Scheme配置

scheme:
    #scheme: Muse
    scheme: Mist
    #scheme: Pisces
    #scheme: Gemini
  • hexo language语言配置

每个主题的语言都是根据作者的母语来配置的,要想配置开发者自己国家的语言,还是更改项目根目录底下的_config.yml文件,全局搜索language,更改language配置

language: zh-CN

再更改主题项目目录底下的language文件夹底下的zh-Hans.yml文件,将其重命名为zh-CN.yml,再更改其目录底下的_config.yml文件,全局搜索language,更改language配置

language: zh-CN    
  • hexo page 页面配置

hexo提供了几个可供筛选的页面,常用的有这么几个:home(首页)、tags(标签)、about(关于我)、archives(档案)和categories(分类),首先要创建页面

hexo new page tags
hexo new page about
hexo new page archives
hexo new page categories

接着在主题项目目录下,更改_config.yml文件,全局搜索menu,更改menu配置,当然每个主题的配置不尽相同

menu:
    home: / || home
    about: /about/ || user
    tags: /tags/ || tags
    categories: /categories/ || th
    archives: /archives/ || archive

随后更改source目录底下创建的页面,以tags为例

----------------------------
    title: about
    date: 2018-04-24 17:57:26
    type: "tags"
    comments: false
----------------------------
  • hexo avatar 头像配置

配置自己个人博客网站的头像,需要更改hexo博客项目底下的_config.yml文件,添加avatar配置

avatar: https://avatars1.githubusercontent.com/u/13704681?s=400&u=bfc4636397a7c4384f63d4836a33d1797cd2c660&v=4(头像url链接)
  • hexo search 全站搜索配置

假如想要配置自己hexo个人博客网站的全站搜索配置,首先要下载hexo search外部依赖包

npm install hexo-generator-search --save
npm install hexo-generator-searchdb --save

更改hexo博客项目根目录底下的_config.yml文件,添加search配置

search:
    path: search.xml
    field: post
    format: html
    limit: 10000

开启主题项目目录底下的_config.yml文件中的local_search配置

local_search:
    enable: true        
  • hexo new_post_name配置

假如想要更改每一篇博客的文件名称,不再是默认的:title.md的文件名,需要更改hexo博客项目根目录底下的_config.yml文件,更改new_post_name配置

new_post_name: :year-:month-:day-:title.md
  • hexo auto_excerpt阅读全文配置

博客文章一般都会很长的,所以在首页要对博客进行超长截断,要想看所有的内容,点击阅读全文或者文章标题进入全文查看,需要更改主题项目目录底下的_config.yml文件,全局搜索auto_excerpt,更改auto_excerpt配置

auto_excerpt:
    enable: true
    length: 200
  • hexo 其他配置

更改hexo博客项目根目录底下的_config.yml文件,更改网站title(标题)、author(作者)、keywords(关键字)、description(描述)配置,比如本人的配置

title: yinwk_Gary Blog
author: yinwk_Gary
keywords: hexo,hexo-cli,hexo博客,hexo博客个人网站
description: Gary's blog,记录_从今天开始

设置个人的github(github托管代码网址)、google(google个人资料网址)、gmail(gmail邮箱网址)、twitter(twitter个人微博网址)等等,比如本人的配置

social:
  GitHub: https://github.com/dreamthen || github
  E-Mail: https://dreamthen.00@gmail.com || envelope
  Google: https://plus.google.com/u/0/103833130011211353424 || google       

#hexo命令

首先建立一篇名为hexo配置的博客

hexo new hexo配置

在hexo博客项目source目录底下的_post目录下找到名为hexo配置的博客文件,在里面用markdown进行记录自己的博客,当然可以在hexo server自带的服务器运行监听的情况下,进行添加和修改自己的博客。之后,进行生成静态文件

hexo generate

生成静态文件之后,进行部署

hexo deploy

生成静态文件和部署可以使用一句命令执行

hexo generate -deploy
hexo deploy -generate

为了防止存在静态文件和缓存,造成没有重新渲染页面的问题,在每一次部署之前,要运行一下清理静态文件和缓存的命令

hexo clean
hexo generate
hexo deploy

hexo deploy部署之后,根据hexo博客项目根目录底下_config.yml配置文件的deploy git配置,会提交到远程github repository库