Tutorial

May 12, 2021

用Hexo创建个人博客

工具

Node.js
Git

安装环境

安装Node.js

可以去Node.js官网下载安装包安装或命令行安装。

命令行

我们使用NVM (Node Version Manager) 来安装管理Node.js

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
# Or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

# 验证安装及版本
nvm -v

# 如果出现zsh: command not found: nvm 
# 检查.bash_profile文件末尾是否有如下代码，如果没有添加以下代码到.bash_profile文件末尾
# .bash_profile文件是个隐藏文件。Mac显示隐藏文件"cmd + shift + ."。路径为/Users/你的用户名/.bash_profile。
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

# 使配置生效
source .bash_profile

# 使用nvm安装最新版本的Node.js。"node" is an alias for the latest version
nvm install node

# 安装特定版本的Node.js
nvm install 14.7.0 

# 验证安装及检查版本
node -v

安装包

安装包包含Node.js和npm包管理器

验证安装并检查版本

去命令提示符CMD查看Node.js和npm版本

node -v

npm -v

注：如果在国内的小伙伴安装速度过慢，可以先安装一个cnpm(淘宝源)来提升安装速度。命令如下：

1	npm install -g cnpm --registry=https://registry.npm.taobao.org

输入

cnpm

来验证安装是否成功

输入

cnpm -v

来查看版本

至此，Node.js安装过程完毕

安装Git

自MacOS Mavericks(10.9)以后，Mac最简单安装Git的方式就是通过安装Xcode Command Line Tools来使用Git。

1 2	# 安装Command Line Tools xcode-select --install

1 2	# 或使用Homebrew安装Git brew install git

或者去Git官网下载Binary installer安装包安装。

第一次使用Git需要配置信息，设置你的Git用户名和邮箱。建议这里的用户名和邮箱与你的GitHub的用户名及邮箱保持一致。

每次 Git 提交时都会附带这两条信息，用于记录是谁提交的更新，并且会随更新内容一起被记录到历史记录中。简单说，是用来标记的你的身份的

1 2	$ git config --global user.name Your_user_name $ git config --global user.email [email protected]

安装Hexo

命令提示符CMD内输入代码来全局安装(-g) Hexo。

1	sudo npm install -g hexo-cli

如果安装国内镜像源cnpm的输入以下代码来全局安装Hexo

1	sudo cnpm install -g hexo-cli

验证安装及查看版本

hexo -v

使用Hexo来搭建博客

在自己想要的磁盘位置建立文件夹，文件夹名字可以随便命名

注：如果在博客搭建过程中出现任何错误，只需要删除这个文件夹重新再来就好

在命令提示符CMD内进入刚刚建立的博客文件夹内
使用命令来初始化博客
1
hexo init

初始化完成后刚刚创建的MyBlog文件夹下会出现hexo的相关文件

至此，hexo博客搭建已经完成

运行博客

输入以下代码来启动博客

1 2	# hexo server hexo s

打开浏览器输入 localhost:4000 即可打开我们创建好的hexo博客首页

写博客

使用以下代码来生成Markdown类型文件并编辑它。

1	hexo new "文章名称"

也可以通过其他IDE来生成Markdown文件并编辑，编辑完成之后保存后缀为.md的Markdown格式文件，放入hexo博客生成文件夹目录下的source –> _posts

⚠️注意：确保自己在Markdown文件顶部加了合适的title部分。

之后运行命令

1 2	# 删除hexo生成的静态文件夹public hexo clean

生成静态页面文件夹public

1 2	# hexo generate hexo g

启动hexo

hexo s

即可浏览刚刚编辑的博文了

部署博客到服务器 (Eg. GitHub Pages, ECS云服务器等)

如果想要部署我们写好的博客到服务器的话，那么我们就需要如下步骤

第一步，更改博客文件夹根目录下的_config.yml内的Deployment部分

deploy:
	type: git
	repo: https://github.com/GitHub用户名/仓库名.git   
	// Eg. https://github.com/JinchuanL/JinchuanL.github.io.git
	branch: master

保存即可。

第二步，部署

1 2	# hexo deploy hexo d

这样我们就可以把我们的博客部署上线啦，其他人也可以浏览我们的博客了。

部署博客到阿里云ECS云服务器的具体方法请参考我的另一篇博文 - Create your personal blog on ECS Server。

总结

Hexo写博客的思路

hexo clean (清理之前生成的public文件)
hexo new “博文”
hexo g (生成静态页面)
hexo s (启动博客)
hexo d (部署博客到服务器)

参考资料

About this Post

This post is written by Andy, licensed under CC BY-NC 4.0.

#Hexo #Blog