0%

github博客构建指南

环境搭建和基本配置

准备:

  • GitHub账号、node.js、npm、gitbash(此处推荐cmder)、域名(godaddy、阿里云、腾讯云都可以买)

步骤:

  1. GitHub上创建一个名为‘你的用户名.github.io’的仓库,比如说我的就是taobowen.github.io,将来你博客的其中一个访问地址就是‘你的用户名.github.io’了。创建时间比较久,大概20-30分钟。

  2. 绑定域名

    如上图,首先我们在DNSPod上的‘DNS解析-我的域名’处添加并配置自己的域名,域名解析配置最常见有2种方式,CNAME和A记录,CNAME填写域名,A记录填写IP,IP通过ping远端博客仓库域名获取,由于不带www的域名访问方式只能采用A记录,因此最好两个都配置。
    在远端博客的根目录新建一个CNAME文件(无后缀),里面填写自己的域名,绑定了新域名后,访问原来的域名‘用户名.github.io’会自动跳转到新的域名。

  3. 配置SSH秘钥
    $ cd ~/. ssh #检查本机已存在的ssh密钥
    找不到,说明是第一次使用Git
    ssh-keygen -t rsa -C "邮件地址"
    然后连续3次回车,最终会生成一个文件在用户目录下,打开用户目录,找到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key
    将刚复制的内容粘贴到key那里,title随便填,保存
    最后,在博客blog目录下,右键选Git Baes Here,命令行中输入,其中的name和email替换成你自己的用户名和邮箱

    1
    2
    $ git config --global user.name "liuxianan"// 你的github用户名,非昵称
    $ git config --global user.email "xxx@qq.com"// 填写你的github注册邮箱
  4. 连通性测试
    输入以下命令:
    $ ssh -T git@github.com # 注意邮箱地址不用改

  5. 配置Hexo

安装:npm install -g hexo
初始化:挑选一个以后准备存放代码的地方新建一个名为hexo的文件夹

1
2
3
4
$ cd /f/Workspaces/hexo/
$ hexo init
$ hexo g # 生成
$ hexo s # 启动服务

执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的,hexo s是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,打不开多半是端口被占用了

扩展配置

根目录下的_config.yml就是我们博客的站点配置文件,我们可以在这编辑语言、博客描述、博客主题等一些基础配置。

主题

在themes目录下是我们本地所有的主题文件,我们可以在该目录下直接clone自己喜欢的主题。主题目录下的_config.yml文件就是该主题的配置文件,在这可以进行一些更详细的设置。
比如:

  1. 文章阅读计数
  2. 博客访问计数
  3. 评论

文章阅读计数

给文章阅读计数我们需要用到的是leancload。注意如果使用的是next主题,开启valine并设置visitor为true,文章阅读数才能正常显示

博客访问计数

博客站点的访问计数我们可以用‘不蒜子’,百度就可以查到,使用很方便,但是要注意使用最新的链接,网上很多参考文章里的都比较老,直接复制是用不了的。

创建博客的步骤

  1. 打开本地hexo文件夹,在根目录下输入hexo new ‘博客名’
  2. hexo会在’source/_posts/‘文件夹下生成相关md文件,然后就可以本地修改了

关于hexo命令行

  • hexo new “postName” 新建文章
  • hexo new page “pageName” 新建页面
  • hexo generate 生成静态页面至public目录
  • hexo server 开启预览访问端口(默认端口4000,’ctrl + c’关闭server)
  • hexo deploy 部署到GitHub
  • hexo help 查看帮助
  • hexo version 查看Hexo的版本

缩写

  • hexo n == hexo new
  • hexo g == hexo generate
  • hexo s == hexo server
  • hexo d == hexo deploy

组合命令

  • hexo s -g 保存并生成本地预览
  • hexo d -g 生成并上传更新

注意事项

  • 在访问博客前要设置网络的DNS服务器地址为114.114.114.114,否则会访问不了