Hexo博客搭建和简单部署

Hexo简介·

Hexo是一款基于Node.js的静态博客框架,可以方便的生成静态网页托管在GitHub和Coding上或者自己的服务器上,是搭建博客的首选框架。大家可以进入hexo官网进行详细查看,因为Hexo的创建者是台湾人,对中文的支持很友好,可以选择中文进行查看。

Hexo搭建步骤·

  1. 安装Git
  2. 安装Node.js
  3. 安装Hexo
  4. GitHub创建个人仓库
  5. 生成SSH添加到GitHub
  6. 将hexo部署到GitHub
  7. 设置个人域名
  8. 发布文章

安装Git·

windows:到git官网上下载,下载后会有一个Git Bash的命令行工具,以后就用这个工具来使用git。
linux:只需要一行代码,sudo apt-get install git

安装好后,用 git --version 来查看一下版本

安装Node.js·

Hexo是基于Node.js编写的,所以需要安装一下Node.js和里面的npm工具。

windows:Node.js选择LTS版本就行了。
linux:也是通过命令来安装

1
2
sudo apt-get install nodejs
sudo apt-get install npm

安装完后,在命令行输入以下代码进行验证

1
2
node -v
npm -v

安装hexo·

先创建一个文件夹,命名为blog(这里假设路径为 D:\blog),然后cd到这个文件夹下(不知道怎么操作,可以去搜索命令提示符进入指定文件夹)。
输入命令

1
2
3
cd D:\blog

npm install -g hexo-cli

然后用hexo -v命令,查看一下版本。
接下来初始化一下hexo,这里的myblog可以自己取名字,作为你的博客源文件夹了。

1
2
3
4
5
hexo init myblog

cd myblog

npm install

新建完成后,指定文件夹目录下有:

  • node_modules: 依赖包(或插件)
  • public:存放生成的页面(这个文件夹可能会没有,但当你使用hexo g 构建时,就会有了。)
  • scaffolds:生成文章的一些模板
  • source:用来存放你的博客资源
    • _posts:用来存放你的文章
  • themes:主题
  • _config.yml:博客的配置文件
  • package.json:一些应用程序的信息、命令的配置

然后使用以下命令,生成静态文件和启动本地服务器。

1
2
hexo generate
hexo server

这两个命令可以简写为hexo ghexo s

这样就打开hexo的服务,在浏览器输入 http://localhost:4000 就可以看到你生成的博客了。

提示:清理缓存

每次对服务器的配置进行了大改动后发现改动的配置未生效,我建议使用 hexo clean 命令进行缓存清理,而且这样可以解决一些小问题。

安装“部署”插件·

如果需要把你的博客简单的发布到网上,那你需要先安装deploy-git插件,也就是部署的命令,这样你才能用命令部署到coding、GitHub亦或是你自己的服务器上。

cd到你的博客文件夹,输入下面的命令

1
2
3
cd D:\blog

npm install --save hexo-deployer-git

部署到coding(国内访问)·

coding已经无法再像GitHub那样部署使用了,请使用其他方式代替coding(2022年3月15日)!

  1. coding的官网,注册一个账号。

  2. 注册完后,新建一个项目并进入项目,打开代码仓库

  3. 复制代码仓库的地址,留作后用。

  4. 打开你的博客文件夹里的 _config.yml 文件,在最下面的deploy:里,

    1
    2
    3
    type: 'git' 
    repo:
    coding: https://e.coding.net/yunying61/blog-yunying61.git,master

注意缩进,而这里的coding: ,注意英文冒号(:)后面还有一个空格,而这里就是刚才你复制的 已公开源码 地址,再加上(英文逗号) ,master

  1. 当你再次hexo g , hexo d的时候,就会自动推送到coding的仓库里。

  2. 然后去你的coding仓库,找到左侧的构建与部署,点击进入静态网站。

  3. 然后 立即发布静态网站,填写信息,保存。

到这里,你的博客就算是部署到了coding上了,通过coding给出的访问地址就可以访问你自己搭建的博客了。

如果你有域名,那可以把域名绑定到coding给出的网址上,并且在coding的静态网站设置界面,添加你的域名。

部署到github(国外访问)·

  1. Github的官网,注册一个账号。

  2. 注册完,然后New repository新建一个仓库,名称为 你的账户名.github.io (账户名就是创建者下面那个英文名) ,然后点击创建仓库。

名称这个一定要是这样,否则可能没有用,后续你就可以用你的账户名.github.io 这个直接进入你的博客了。

  1. 然后去你电脑上的博客文件夹,右键 git bash 到这个文件夹下,输入以下命令
1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

可以用以下两条,检查一下你有没有输入正确

1
2
git config user.name
git config user.email

至于SSH要不要配置,那看你们自己了,配置了SSH就可以控制git上传你的文件到GitHub上。

  1. 打开你的博客文件夹里的 _config.yml 文件,在最下面的deploy:里,

    1
    2
    3
    type: 'git' 
    repo:
    github: https://github.com/yunying61/yunying61.github.io.git,master

注意缩进,而这里的github: ,注意英文冒号(:)后面还有一个空格,而这里就是刚才你复制的 HTTPS 地址,再加上(英文逗号) ,master

  1. 当你再次hexo g , hexo d的时候,就会自动推送到github的仓库里。
    注意deploy时可能要你输入username和password,就是你GitHub的账号密码。

  2. 推送完,就可以直接访问 https://你的名称.github.io/ 进入你的博客了