hexo+github静态博客的搭建

发表于 | 更新于 | 分类于 | Comments： | 阅读次数：

曙光

个人静态博客的从无到有

目录

  • 1.安装hexo到本地
  • 2.搭桥到github
  • 3.修改配置
  • 4.常见问题

1.1安装Git到本地

从官网或者本文提供的百度网盘下载Git安装包，由于众所周知的原因，官网下载十分缓慢。下
载完安装即可,这里推荐装在c盘根目录下,不然可能报错.

  • 下载地址
  • 安装: 一路默认就可以
  • 检测: 打开命令行模式(使用win+r,输入cmd),输入命令Git version
    (git已经自动将环境变量配好,所以在任何目录下都可运行) 看到这个
    git
    这就表示安装成功,可以进行下一步.

1.2安装NODE.JS到本地

从官网或者本文提供的百度网盘下载NODE安装包

  • 下载地址
  • 安装: 一路默认就好(如果在Custom Setup这一步Add to PATH前面有框的话 记得勾选 如果没有框 就已经默认选择了)
  • 检测: 打开命令行模式,查看版本 输入命令node -v
    看到这个
    node
    这就表示安装成功,可以进行下一步.

1.3安装Hexo到本地

首先在你想要的位置下建一个文件夹(例如hexo),在命令行中定位到该文件夹下(也可在我的电脑中这个文件夹的上方路径处输入cmd)

  • 安装: 在你定位到该文件夹下后,输入命令npm install -g hexo
  • 检测:输入命令hexo -version
    看到这个
    hexo
    这就表示安装成功 接下来:
  • 初始化hexo: 输入命令hexo init,完成后会看到以下文件
    init
  • 然后就开始搭桥到github

2.1注册github账号

2.2创建REPOSITORY

创建一个新的repository,名称为yourname.githubio(yourname是你github的用户名)
hexo
hexo

  • 回到命令行中,进行配置,将下面的XXX换成自己的用户名和邮箱
    1
    2
    git config --global user.name "XXX"
    git config --global user.email"XXX"

2.3 创建ssh,生成key,输入以下命令

1
ssh-keygen -t rsa -C "youremail@example.com"

输完命令后敲击三次回车，设置的密码为空，生成key成功

2.4将获取的好的ssh放到github中

定位到ssh文件下(C:\用户\你的用户名目录进入.ssh文件夹),用编辑器打开id_rsa.pub文件,复制里面的内容,然后按下面步骤进行
ssh
ssh
添加一个 New SSH key ，title随便取，key就填复制的那一段.

  • 检测: 这个可以在gitbash(前面安装好git后,会有一个gitbash,打开也是命令行模式的)中检测,输入命令ssh -T git@github.com
    如果显示hi,XXX 代表添加成功.

3.1hexo(你创建的文件夹)文件夹下_config.yml的配置

注意_config.yml文件共有两个 一个在hexo主题下 一个在theme下的主题文件下 在配置文件中所有冒号后面都有一个英文状态下的空格

  • 打开hexo文件夹下的_config.yml文件,进行修改(XXX是你的用户名)
    1
    2
    3
    4
    deploy:
      type: git
      repo: git@github.com:XXX/XXX.github.io.git
      branch: master

3.2在本地运行

  • 在命令行中定位到你的文件下,执行下面命令 
    1
    2
    3
    hexo clean
    hexo generate
    hexo server

3.3上传到github,在网页上显示

  • 为hexo安装Git插件 输入命令
    1
    npm install hexo-deployer-git --save
  • 在命令行中定位到你的文件下,执行下面命令
    1
    2
    3
    hexo clean
    hexo generate
    hexo deploy

即可完成部署，然后访问xxx.github.io就能访问你的博客了(注意deploy的过程中要输入你的username及passward)

3.4域名绑定

  • 如果想使用自己的域名，只需要把域名CNAME解析到xxx.github.io，然后在~\hexo\source目录
    中创建文件CNAME（没有后缀名）,文件里填上你的自定义域名（没有http://或者https://）然后执行一遍

3.5文章创建

  • 在cmd中,输入下面命令
    1
    hexo new 你的文件名

就会发现在hexo/source/posts中出现 你的文件名.md 文档,用编辑器打开就可以进行编辑了
语法参考第一篇hello_world或者这个模版

  • 改动后再次执行下面命令(前提是cmd切换到了hexo目录)
  • 预览
    1
    2
    3
    hexo clean
    hexo generate
    hexo server
  • 发布
    1
    2
    3
    hexo clean
    hexo generate
    hexo deploy

4.常见问题

  • ssh
    注意两个错误:
    1.ssh-keygen中间没有空格
    2.rsa -C “youremail@example.com“中-C C是大写
  • 配置文件
    在每个冒号后都有一个英文空格
    如果配置文件是格式问题时可用这个网站来纠正yamllint
  • 单词释义: clean 清除 generate 生成
    deploy 部署 server 服务器
    .md markdown的缩写,markdown也是一种标记
    .yml YML文件格式是YAML (YAML Aint Markup Language)编写的文件格式
    hexo generate可缩写为 hexo g
    hexo deploy 可缩写为 hexo d
    本文参考资料: visugar的博客 hexo官方文档 Dr34m’s blog
咦~~~~ 这是嘛呀!!!
0%