1

这是一篇有关如何使用Github Pages和Hexo搭建自己独立博客的详尽教程,里面介绍了如何使用和配置Hexo框架,还有我在搭建自己博客过程中所遇到的各种困难。

Hexo基本配置

  1. 安装NodeJS

    # 添加环境变量
    # 检查是否安装成功...
    node -v
    npm -v
  2. 安装Git,Git的相关教程可以参看廖雪峰

    # 配置信息
    git config --global user.name "ichinose"
    git config --global user.email xxxx@gmail.com
    # 查看配置情况
    git config --list
    
    # 配置SSH key
    ssh-keygen -t rsa -C "youremail@example.com"
    # 会在c/Users/ichinose/.ssh生成秘钥和公钥
    # 将公钥添加到Github的Setting->SSH中

    img

  3. 安装Hexo

    Hexo就是我们的个人博客网站的框架,这里我们可以先创建一个hexotext文件夹来存放所有的hexo相关文件,我们需要利用npm命令来安装相应的包,在hexotext文件夹中右键打开git bash或者使用cmder

    使用npm命令安装Hexo,输入:

    npm install hexo-cli -g

    初始化Blog:

    hexo init Blog
    # 会初始化一个Blog文件夹,这就是我们的博客

    启动服务:

    cd Blog
    npm install
    hexo s

    遇到的问题

    打开localhost:4000没有页面,这可能是端口被占用,需要修改端口号。Hexo3.0开始,把服务器做成了独立的模块,因此需要安装hexo-server

    方法:

    npm install hexo-server --save
    # 暂时修改端口,以其他端口打开服务
    hexo s -p 4001
    
    # 全局修改
    # 找到node_modules\hexo-server\index.js文件,可以修改默认的port值(不建议)

博客部署

安装工具包:

npm install hexo-deployer-git --save

现在本地的博客已经搭建起来了,但是我们只可以通过本地连接查看我们的博客。如果我们需要博客在网络上被别人看到,就需要将博客发布到服务器上,而Github Pages就帮我完成了这件事情。我们需要新建一个Github项目。(可以不初始化README)

img

复制你新建的仓库的SSH链接,配置到config.yml中:

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:username/username.github.io.git
  branch: master

生成博客,并部署:

hexo clean
hexo g
hexo d

完成上述配置就可以在你的Github Page访问了,地址:https://username.github.io


lingjiu
38 声望6 粉丝

我也想成为一个有趣的人...