基于hexo搭建博客

参考文章:

我的Hexo博客搭建过程

hexo史上最全搭建教程

1. Git安装和配置

  • Git官网

    Git的安装比较简单

  • 准备一个Github账号,我们的博客要挂在github上

  • 首先打开CMD,设置你的账号和邮箱,输入

    git config --global user.name "yourname"
    git config --global user.email "youremail"
    其中”yourname”是你的github账号,”youremail”是你的github账号邮箱

  • 可以用以下两条命令检查输入
    git config user.name
    git config user.email

  • 然后用以下命令创建SSH秘钥
    ssh-keygen -t rsa -C "youremail"
    后续连敲3次回车,不需要任何输入。
    完成之后会告诉你生成了.ssh文件夹(应该在C:\Users\Administrator路径下),找到文件夹,其中id_rsa是秘钥,id_rsa.pub是公钥,用文本编辑器打开id_rsa.pub,复制所有内容。

  • 添加公钥到Github

    登录Github,右上角 头像->Settings -> SSH and GPG keys -> New SSH key。 把公钥粘贴到key中,填好title并点击Add SSH key。

  • 回到CMD,输入命令
    ssh -T git@github.com
    选yes,提示成功。

2. 安装Nodejs

  • Nodejs官网

    windows:选择LTS版本就行了,下载完成后安装。

  • 安装完成有两个组件,nodejs和npm,可以在git bash下使用以下命令查看版本

    node -v

    npm -v

  • 用npm安装cnpm淘宝镜像源

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

    用以下命令查看版本
    cnpm -v
    安装完成以后就都是用cnpm下载了

3. 安装博客框架Hexo

  • 安装命令
    cnpm install -g hexo-cli
  • 查看版本
    hexo -v

4. 搭建Hexo博客

hexo常用命令

  • 新建一个文件夹,例如D:\blog

  • 在上述文件夹D:\blog右键,git bash打开

  • 初始化一下hexo

    hexo init myblog

    这个myblog可以自己取什么名字都行,然后我们会看到在myblog文件夹下,有一些文件:

    • node_modules: 依赖包
    • public:存放生成的页面
    • scaffolds:生成文章的一些模板
    • source:用来存放你的文章
    • themes:主题
    • _config.yml: 博客的配置文件
  • 启动博客

    1
    2
    hexo g		// hexo generate的缩写,生成静态文章
    hexo s // hexo server的缩写,启动本地服务器

    然后在浏览器输入localhost:4000就可以看到你生成的博客了,hexo本地web服务器监听了4000端口。

    结束本地服务器按Ctrl+C

  • 远程部署到Github

    将hexo和GitHub关联起来,也就是将hexo生成的文章部署到GitHub上

    • 登录Github,新建一个仓库:右上角+号 -> new repository
    • 项目命名必须是 “yourname.github.io”,比如我的是 “BambooWine.github.io”,描述写一下,选public,然后点Create Repository
    • 为Hexo安装Github部署插件:输入命令 cnpm install --save hexo-deployer-git
    • 打开站点配置文件 _config.yml,翻到最后,修改为:其中YourgithubName你的GitHub账户名
    1
    2
    3
    4
    deploy:
    type: git
    repo: https://github.com/YourgithubName/YourgithubName.github.io.git
    branch: master
    • 部署到Github:hexo deploy 或者 hexo d

      这个过程就是使用你Git中SSH关联的账号往你刚刚新建的仓库中push文件,等待部署完成之后,打开你的github即可查看效果。通常部署完成之后要等待一段时间,一些效果才会正常显示

5. 写文章,更换主题等操作

5.1 撰写文章

  • 创建博客文章

    hexo n "我的第一篇博客文章"

    n是new的简写,创建完成后文章会放到source/_posts文件夹下面,md文件,markdown语法自行学习。

    打开文件之后,开头的部分内容官方称为Font-matter,这里你可以设定文章标题,文章创建更新时间,标签,分类等等,具体请查阅。front-matter官网介绍

  • 写完一篇博客之后,可以看一下效果

    1
    hexo cl      // 清理(必要时清理,不必每次都清理)
    1
    hexo g       // hexo generate的缩写,生成静态文章
    1
    hexo s       // hexo server的缩写,启动本地服务器

5.2 更换主题

默认情况博客采用的是landscape主题,略丑陋,本博客采用indigo主题

  • 安装主题

    在blog文件夹下,右键git bash,输入以下命令

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

    之后会在themes下新建indigo文件夹,然后将主题克隆到此文件夹下

  • 配置hexo全局设置文件_config.yml

    找到theme字段,默认是landscape,改成indigo

  • 启动本地服务器查看效果

至此大概就初步完成了,后续美化等操作,大家可以自行挖掘