0%

从安装Hexo开始搭建个人博客

从安装Hexo开始,一步一步搭建个人博客。


1.什么是Hexo

上篇你可能没仔细了解过什么是静态博客,简单介绍了下静态、动态博客。

现在我们先看看Hexo官方的介绍。

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

Hexo官网已经有了博客搭建的详细教程,可直接移步查看文档

至于写这一篇博客搭建的记录,主要是按着官方教程做的过程中,出现了太多意料不到的问题,对于新手小白实在不友善。因此我觉得有记录的必要。


2.安装前提

只需安装下列应用程序:

  • Node.js (Node.js 版本需不低于 8.10,建议使用 Node.js 10.0 及以上版本)
  • Git

安装完成后,才可开始安装Hexo。

2.1.安装Node.js

根据安装教程一般就直接下一步,确保要勾选Add to PATH选项(默认已勾选)

安装完后,显示出已安装Node.js和npm。

NPM(原简称节点包管理器)是一个包管理器的JavaScript的编程语言。它是JavaScript运行时环境Node.js的默认包管理器

在终端上查看,-v即version,显示版本号。以下是我的配置,这样便是安装成功

1
2
3
4
5
❯ node -v
v12.16.1

❯ npm -v
6.13.4

2.2 安装Git

初次安装完成后,需要用 git config 配置 Git。 首先要做的事情就是设置你的名字和邮件地址:

1
2
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com

对Git有疑惑的可看官方文档菜鸟教程


3.安装Hexo

当准备程序安装完成后,开始安装Hexo。

很简单一条命令:

1
npm install -g hexo-cli

安装完后通过hexo -v,如果显示出版本号即安装成功。


4.建站

安装Hexo后,将在指定文件夹中新建所需文件。这里文件夹可自己命名。我命名为blog,以后若是出了什么错误大不了把blog删掉重来。

还是几条命令:

1
2
3
hexo init blog
cd blog
npm install

新建完,去blog查看目录。_conofig.yml是Hexo的配置文件。_posts是存放本地发布的文章。themes存放主题文件。

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

5.生成静态页面

现在可以开启Hexo博客的预览了。

1
2
3
hexo cl
hexo g
hexo s

ggeneratesserver,此时会提供一个本地预览端口http://localhost:4000

点击进入可以看到Hexo的静态网页已生成,如此便是安装成功了。


6.问题解决

就这几个步骤,我卡了半天。因为在国内原因npm下载太慢了,不成功的同学可以把npm换成淘宝的镜像cnpm来下载。以后即可都用cnpm代替npm。

安装cnpm

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

确认cnpm安装成功

1
cnpm -v

利用cnpm来安装Hexo

1
cnpm install hexo-cli -g

确认Hexo安装成功

1
hexo -v

7.最后

安装好Hexo后,我们要对网站进行配置,安装主题和部署到远端服务器。

不慌,慢慢来。


8.参考

文档