您的位置: 首页  >  文章  >  github + hexo快速搭建属于自己的博客

github + hexo快速搭建属于自己的博客

分类: 文章 • 2023-11-05 14:51:46

准备步骤

  1. 安装node.js（这个安装很简单的，就不说了）
  2. 安装git
  3. 注册github

配置SSH keys

生成SSH Keys

建立博客之前要先用SSH keys让我们的本地git项目与远程的github建立联系。
首先我们需要检查你电脑上现有的ssh key。右键打开Git Bash，输入：
（如果提示：No such file or directory 说明你是第一次使用git。）

生成新的SSH Key
（此处的邮箱地址请输入你自己的邮箱地址）



1






$ ssh-****** -t rsa -C "邮件地址@youremail.com"











然后回车



然后系统会要你输入密码。这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。

（输入密码的时候没有*字样的，你直接输入就可以了）







1


2






Enter passphrase (empty for no passphrase):<输入加密串>


Enter same passphrase again:<再次输入加密串>










看到这样的界面就成功设置ssh key了。
github + hexo快速搭建属于自己的博客



将SSH Key添加到Github上


    

  1. 打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。路径也有可能是C:\Users\Administrator.ssh，你可以直接在C盘中查找id_rsa.pub文件。此文件里面内容为刚才生成人**。如果看不到这个文件，你需要设置显示隐藏文件。打开，准确的复制这个文件的内容。
    2. 

  2. 登陆github系统。点击右上角的图像—>Settings —> SSH and GPG keys。
    github + hexo快速搭建属于自己的博客

    3. 

  3. 点击右上角New SSH key，把你刚刚复制的本地生成的**文件内容黏贴到里面（Key文本框中）， 点击Add SSH key就ok了
    github + hexo快速搭建属于自己的博客

    4. 




测试一下



可以输入下面的命令，看看设置是否成功，[email protected]的部分不要修改：







1






$ ssh -T [email protected]











然后输入yes

然后就会看到







1






Hi seminelee! You've successfully authenticated, but GitHub does not provide shell access.











设置用户信息



现在你已经可以通过SSH链接到GitHub了，还有一些个人信息需要完善的。

Git会根据用户的名字和邮箱来记录提交。GitHub也是用这些信息来做权限的处理，输入下面的代码进行个人信息的设置，把名称和邮箱替换成你自己的。







1


2






$ git config --global user.name "seminelee"//用户名


$ git config --global user.email "[email protected]"//填写自己的邮箱










完成以上步骤后本机就已成功连接到github



开始建立博客



与GitHub建立好链接之后，就可以方便的使用它提供的Pages服务，GitHub Pages分两种，一种是你的GitHub用户名建立的username.github.io这样的用户&组织页（站），另一种是依附项目的pages。

想建立个人博客是用的第一种，形如playboygit.github.io这样的可访问的站，每个用户名下面只能建立一个。



Github上建立仓库



登陆Github，建立一个名为playboygit.github.io的仓库。

注意！Github Pages的Repository名字是特定的，比如我Github账号是playboygit，那么我Github Pages Repository名字就是playboygit.github.io。

详细建立仓库过程略过。



安装Hexo



Hexo是一个简单、快速、强大的博客发布工具，支持Markdown格式。

打开Git Bash







1






$ npm install -g hexo










安装完毕后，在我的电脑某个位置中建立一个名字叫hexo的文件夹，然后在此文件夹中右键打开Git Bash。







1






$ hexo init










Hexo随后会自动在目标文件夹建立网站所需要的所有文件。

现在我们已经搭建起本地的hexo博客了。

在hexo目录下输入







1


2






$ hexo g


$ hexo s










然后到浏览器输入localhost:4000看看，可以看到默认主题下的博客，这就实现了本地预览了。



更换主题



每次更换主题前清空一下database







1


2


3






$ hexo clean


$ hexo g


$ hexo s










通过git clone克隆主题，这里用的是next主题







1






$ git clone https://github.com/iissnan/hexo-theme-next.git










更多主题可以参考有哪些好看的 Hexo 主题? - GitHub - 知乎



启用主题







1






theme: hexo-theme-next










修改hexo目录下的config.yml配置文件中的theme属性，将其设置为hexo-theme-next。

（注意：Hexo有两个config.yml文件，一个在根目录，一个在theme下，此时修改的是在根目录下的。）



更新主题







1


2






$ cd themes/hexo-theme-next


$ git pull










然后可以本地预览一下







1


2






$ hexo g #generate生成



$ hexo s #server测试环境，启动本地服务，进行文章预览调试











上传到Github仓库



打开hexo目录下的_config.yml，拉到最下面

配置为这样子,只需要把playboygit改为你自己的github用户名就可以了。（注意格式，冒号后要有空格，你可以直接复制以下代码再作修改）







1


2


3


4


5


6






# Deployment


## Docs: http://hexo.io/docs/deployment.html


deploy:


 type: git


 repository: https://github.com/playboygit/playboygit.github.io.git


 branch: master










然后执行命令







1


2






$ hexo g #generate生成



$ hexo d #deploy开发环境











如果看到结果最后一行是INFO Deploy done:git则没有问题。否则，则可以把上面的配置改为下面这种使用SSH方式的提交，把用户名改为你自己的用户名







1


2


3


4


5


6






# Deployment


## Docs: http://hexo.io/docs/deployment.html


deploy:


 type: git


 repository: [email protected]:playboygit/playboygit.github.io.git


 branch: master










再次执行命令







1


2






$ hexo g #generate生成



$ hexo d #deploy开发环境











如果在执行 hexo deploy 后,出现 error deployer not found:github 的错误，网上说是hexo 更新到3.0之后的一个坑，则需要安装hexo-deployer-git







1






$ npm install hexo-deployer-git --save










再次执行命令之后，打开https://{你的github用户名}.github.io/就能看到你建立好的博客了！


															

																					

								

									相关推荐