使用Hexo + Github搭建自己的私人博客

Java基础

浏览数:66

2019-10-16

使用Hexo + Github搭建自己的私人博客

背景介绍

目前有很多博客平台,简书、CSDN等等,但是作为程序猿,就应该装逼搞个自己的私人博客平台,能够自己DIY。网上有很多这种博客,写这篇文章的目的,主要是记录自己创建博客的一个历程,如果你还没有创建过,不妨跟着这篇博客做起来。这篇文章是基于Windows平台的,mac和Linux 的请绕道。

准备阶段

如果搭建node.js 之后出现express不是内部或外部命令,请移步 nodejs小问题:express不是内部或外部命令,先不要急着操作,因为前面的是入坑,真正的解决方法在后面。
安装成功后,测试创建node.js项目的时候,怎么就默认创建到了个人文件夹??我想创建到指定目录,比如F:\nodejs\workspcace,怎么去实现呢??网上也没找到教程,通过 nodejs的express使用介绍 项目创建都依赖于 package.json
打开express的安装目录F:\nodejs\node_modules\express 这个是windows 下安装nodejs及其配置环境npm config set prefix “F:\nodejs” 的全局路径,打开express文件夹底下,打开package.json 修改以下代码中的”C:\XXX\XXX”到指定的目录,进入cmd 运行express helloworld 但是没有效果,不知道是什么原因,如果有知道的请告知,谢谢。

"_args": [
[
  {
    "raw": "express",
    "scope": null,
    "escapedName": "express",
    "name": "express",
    "rawSpec": "",
    "spec": "latest",
    "type": "tag"
  },
  "C:\\XXX\\XXX"
]   
]
还有一个地方
"_where": "C:\\XXX\\XXX",

这样就只能cd 命令先进入我们想要的指定文件夹 XXX/XXXX/workspace,然后创建项目了。

github账户的注册和配置

如果已经拥有账号,请跳过此步
打开https://github.com/,在下图的框中,分别输入自己的用户名,邮箱,密码。

2017-05-14_133901.png

然后打开邮箱确认注册,再进行登陆,就可以使用github pages了。登陆之后,点击页面右上角的加号,选择New repository:

2017-05-14_134352.png

在Repository name下填写yourname.github.io,Description (optional)下填写一些简单的描述(不写也没有关系),如图所示:

2017-05-14_140311.png

注意:比如我的github名称是philos ,这里你就填 philos.github.io

接下来开启gh-pages功能,点击界面右侧的Settings,你将会打开这个库的setting页面,向下拖动,直到看见GitHub Pages,如图:

点击Automatic page generator,Github将会自动替你创建出一个gh-pages的页面。
如果你的配置没有问题,那么大约15分钟之后,yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了,那么Github一侧的配置已经全部结束了。

到此搭建hexo博客的相关环境配置已经完成,下面开始讲解Hexo的相关配置

Hexo的相关配置

hexo简介

Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。

官网: http://hexo.io
github: https://github.com/hexojs/hexo

hexo原理

由于github pages存放的都是静态文件,博客存放的不只是文章内容,还有文章列表、分类、标签、翻页等动态内容,假如每次写完一篇文章都要手动更新博文目录和相关链接信息,相信谁都会疯掉,所以hexo所做的就是将这些md文件都放在本地,每次写完文章后调用写好的命令来批量完成相关页面的生成,然后再将有改动的页面提交到github。

注意:hexo有2种_config.yml文件,一个是根目录下的全局的_config.yml,一个是各个theme下的

hexo安装

$ npm install -g hexo

初始化博客工作空间

新建一个文件夹(比如名字为blog),你的博客项目的代码和文件都会保存到这里。

$ cd /f/blog/
$ hexo init

hexo 会自动下载一些文件到这个目录,包括node_moudules,目录结构如下:

2017-05-16_015259.png

hexo s是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题请参考这篇文章:

http://blog.liuxianan.com/windows-port-bind.html

第一次初始化的时候hexo已经帮我们写了一篇名为 Hello World 的文章,默认的主题比较丑,打开时就是这个样子:


20160818_132443_202_6848.png

修改主题

个人比较喜欢的2个主题:hexo-theme-jekyllhexo-theme-yilia

首先下载这个主题:

$ cd /f/blog
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

下载后的主题都在这里:

2017-05-16_023839.png

修改/f/blog 里面的_config.yml中的theme: landscape改为theme: yilia,然后重新执行hexo g来重新生成。打开http://localhost:4000看到具体的效果如下:

2017-05-16_024643.png

如果出现一些莫名其妙的问题,可以先执行hexo clean来清理一下public的内容,然后再来重新生成和发布。

上传之前

在上传代码到github之前,一定要记得先把你以前所有代码下载下来(虽然github有版本管理,但备份一下总是好的),因为从hexo提交代码时会把你以前的所有代码都删掉。

配置 SSH key

在上传之前需要先配置一下 SSH key

$ cd ~/. ssh #检查本机已存在的ssh密钥

如果提示:No such file or directory 说明你是第一次使用git。

ssh-keygen -t rsa -C "邮件地址"

然后连续3次回车,最终会生成一个文件在用户目录下,打开用户目录,找到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key:

2017-05-16_025817.png

测试是否成功

$ ssh -T git@github.com # 注意邮箱地址不用改

此时你还需要配置(全局配置):

$ git config --global user.name "philos"// 你的github用户名,非昵称
$ git config --global user.email  "xxx@qq.com"// 

配置_config.yml

这里面都是一些全局配置,需要特别注意的地方是,冒号后面必须有一个空格,否则可能会出问题。

配置_config.yml中有关deploy的部分:
正确写法:

deploy:
  type: git #注意这里不是github
  repository: git@github.com:philos3/philos.github.io.git
  branch: master

填写你的github注册邮箱

上传到github

由于hexo默认会把所有md文件都转换成html,包括README.md,所有需要每次生成之后、上传之前,手动将README.md复制到public目录,并删除README.html。

打开你的git bash,输入hexo d就会将本次有改动的代码全部提交

常用hexo命令

常见命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

缩写:

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

组合命令:

hexo s -g #生成并本地预览
hexo d -g #生成并上传

写博客

千呼万唤始出来,这个才是以后我们的日常目的。在/f/blog/ 文件夹下 执行命令

hexo new 'my-first-blog 我的博客名字'

hexo会帮我们在_posts下生成相关md文件。
我们只需要打开这个文件就可以开始写博客了,默认生成如下内容:


当然你也可以直接自己新建md文件,用这个命令的好处是帮我们自动生成了时间。

一般完整格式如下:

---
title: postName #文章页面上的显示名称,一般是中文
date: 2013-12-02 15:30:16 #文章生成时间,一般不改,当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签,可空,多标签请用格式,注意:后面有个空格
description: 附加一段文章摘要,字数最好在140字以内,会出现在meta的description里面
---

以下是正文

如何让博文列表不显示全部内容

默认情况下,生成的博文目录会显示全部的文章内容,如何设置文章摘要的长度呢?

答案是在合适的位置加上即可。

作者:三也视界