Github+Hexo搭建个人博客

稻草人,我是Huiyu。我喜欢你,你应该知道的。
Welcome to my new territory!
技术概况:
采用Hexo 博客框架,使用 Github 托管,并将自己的域名关联到 Github Pages 上。
推荐您要尽可能参考官方文档,然后适当结合此教程,遇到特殊情况灵活处理。

安装git

  • Windows 下载并安装Git
  • 查看Git是否安装成功:win+r 并输入 cmd,在命令行窗口中输入git --version,如果显示git版本号,则安装成功。
  • 配置git信息(方便hexo和github通过ssh通信)
    1.设置 Git 的用户名和邮箱(如果是第一次的话):
    	$ git config --global user.name "Huiyu"
    	$ git config --global user.email "Huiyu@163.com"
    
    查看是否配置成功:
       git config --global user.name
       git config --global user.email
    

安装 Node.js

  • Node.js 官网下载, 然后Next…
  • 查看 Node.js 是否安装成功:在命令行窗口中输入 node -v 查看 Node 版本。

安装 Hexo

  • 在合适的地方新建一个文件夹,用来存放自己的博客文件 (如 D:\HuiyuBlog),在该目录下右键点击Git Bash Here,打开git的控制台窗口,以后我们所有的操作都在git控制台进行,就不要用Windows自带的控制台了。然后按照hexo官网安装教程进行安装。
  • 或者直接查看Hexo文档,安装Git, Node, and Hexo。
  • 在浏览器查看本地静态网页:http://localhost:4000/, 开心地查看第一个 hexo 默认生成的 blog (在git控制台按ctrl+c可关闭本地服务器),不过只是个本地的博客而已,接下来就要把博客部署到Github上去。
    第一个 hexo 默认生成的 blog

本地博客部署到 Github Pages 上

  • 拥有一个Github 账号。

  • 创建一个新仓库 repository,用来托管博客。仓库名必须为 [name].github.io,勾选README初始化,然后Create repository。

  • 仓库建成后点击Settings,向下拉到最后有个GitHub Pages,点击Choose a theme选择一个主题。然后再回到GitHub Pages,点击箭头所指链接,就可以看到你的新主题啦。
    创建一个新仓库 repository
    在这里插入图片描述
    点击链接欣赏新主题
    新页面主题

  • 配置 SSH 密钥教程:github设置添加SSH

    ssh-keygen -t rsa -C "your_email@example.com"
    

    代码参数含义:
    -t 指定密钥类型,默认是 rsa ,可以省略。
    rsa 指定 rsa 算法。
    -C 设置注释文字,比如邮箱。
    -f 指定密钥文件存储文件名。
    以上代码省略了 -f 参数,因此,运行上面那条命令后会让你输入一个文件名,用于保存刚才生成的 SSH key 代码,如:

    Generating public/private rsa key pair.
    #Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): [Press enter]
    

    推荐直接按回车,使用默认文件名,系统会在c:/Users/Administrator/.ssh/目录下生成id_rsa 和 id_rsa.pub 两个秘钥文件, id_rsa 是密钥,id_rsa.pub 就是公钥。
    接下来提示你输入两次密码(该密码是你push文件的时候要输入的密码,而不是github管理者的密码),当然,你也可以不输入密码,直接按回车。那么push的时候就不需要输入密码,直接提交到github上了。
    若结果如下图所示,则SSH key 已经创建成功。接下来要做的是把 id_rsa.pub 的内容添加到 GitHub 上,这样你本地的 id_rsa 密钥跟 GitHub 上的 id_rsa.pub 公钥进行配对,授权成功才可以提交代码。
    创建SSH key

  • 添加SSH key 到 github

  1. 登录github账号,进入右上角的 Settings,点击菜单栏的 SSH and GPG keys 进入页面New SSH key。
    Settings
    Add SSH key
  2. 用记事本打开C:\Users\Administrator.ssh\id_rsa.pub(注意是隐藏文件夹),将其中的内容复制到SSH key所对应的输入框中,注意前后不要留有空格或者回车。上面的 Title 所对应的输入框你也可以输入一个该 SSH key 显示在 github 上的一个别名(默认使用你的邮箱名称)。
  3. 在git Bash 中输入以下代码测试SSH key.
    $ ssh -T git@github.com
    
    当你输入以上代码时,会有一段警告代码,这是正常的,你输入 yes 回车既可。如果你创建 SSH key 的时候设置了密码,接下来就会提示你输入密码(注意:输入密码时如果输错一个字就会不正确,使用删除键是无法更正的)。如果出现你的用户名,表示SSH密钥配置成功。如果你看到 “access denied” ,者表示拒绝访问,那么你就需要使用 https 去访问,而不是 SSH 。
    测试SSH key
  • 配置Deployment
    打开博客根目录,在blog目录下找到_config.yml文件(这是博客的配置文件,可以修改与博客相关的各种信息),找到#Deployment,然后按照如下修改(repository修改为自己的github项目地址,可复制刚才所创建仓库的 HTTPS 链接):
    deploy:
      type: git
      repo: git@github.com:yourname/yourname.github.io.git
      branch: master
    
  • 在博客根目录下右键打开git,安装一个扩展hexo-deployer-git自动部署发布工具。
    npm install hexo-deployer-git --save
    
    新建一篇文章:
    hexo new post "article title"
    
    打开‘D:\HuiyuBlog\hexo\blog\source_posts’的目录,可以发现下面多了一个文件夹和一个.md文件,一个用来存放图片等数据,另一个存放文章。
    编写完markdown文件后,根目录下输入hexo g生成静态网页,hexo s本地预览效果。
    效果可以的话,hexo d上传到github上,然后打开Huiyu-Li.github.io主页就能看到发布的文章啦(推荐使用hexo clean && hexo g && hexo d,每次清除缓存)。

更改模板

配置博客: Hexo 官网教程
在 Hexo 官网 选取主题
将主题在 Github 上打开,复制 Clone HTTPS ,然后在在 hexo\theme 目录下 clone 该主题。
 clone 该主题
clone 成功后,修改 Hexo 目录中的配置文件 _config.yml 的主题 ,主题名字为 clone 下来的主题文件夹名称

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-matery

hexo中插入数学公式

-原生hexo并不支持数学公式,安装插件 mathJax。
~~~
$ npm install hexo-math --save
~~~
在站点配置文件 _config.yml 中添加:

math:
  engine: 'mathjax' # or 'katex'
  mathjax:
    # src: custom_mathjax_source
    config:
      # MathJax config

在 主题配置文件_config.yml 中将 mathJax 设为 true:
在这里插入图片描述
** TODO**
发布博客
Anatole主题教程

  • 添加评论插件
  • 添加留言板
  • 。。。

补充:

  • Hexo 常用的命令行:
    hexo help #查看帮助
    hexo init #初始化一个目录
    hexo new “postName” #新建文章
    hexo new page “pageName” #新建页面
    hexo generate #生成生成静态网页,可以在 public 目录查看整个网站的文件
    hexo server #本地预览,'Ctrl+C’关闭
    hexo deploy #部署.deploy目录
    hexo clean #清除缓存,强烈建议每次执行命令前先清理缓存,每次部署前先删除 .deploy 文件夹
    简写:
    hexo n == hexo new
    hexo g == hexo generate
    hexo s == hexo server
    hexo d == hexo deploy

换电脑之后重启博客:

  • 2
    点赞
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值