手把手教你搭建GitHub个人博客网站

2022-11-30 15:17:20 浏览数 (1)

1 本地环境

macOS10.14.14

node.js@6.14.4 git@1.9.2 hexo@6.4.0

1.1 安装Node.js

代码语言：javascript复制
node -v

1.2 安装配置Git

查看git是否安装成功

代码语言：javascript复制
git --version

2 GitHub操作

2.1 创建仓库

新建一个名为你的用户名.github.io的仓库，这里，我的github用户名是Wasabi1234，那么就新建Wasabi1234.github.io的仓库,必须是你的用户名，其它名称无效，将来你的网站访问地址就是 http://Wasabi1234.github.io

每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。

2.2 注册绑定域名

不绑定域名也是可以的，就用默认的 xxx.github.io 来访问; 但你肯定想更个性一点，就得拥有一个属于自己的域名

首先你要注册一个域名，推荐阿里云,暖暖的很贴心~

2.3 配置SSH key

你提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题。

  • 检查本机已存在的ssh密钥
代码语言：javascript复制
$ cd ~/. ssh

如果提示：No such file or directory 说明你是第一次使用git

  • 生成ssh key
代码语言：javascript复制
ssh-keygen -t rsa -C "邮件地址"
  • 然后连续3次回车，最终会生成一个文件在用户目录下
  • 打开用户目录
  • 找到.sshid_rsa.pub文件
  • 使用强大的VS Code打开并copy里面的内容
  • 打开你的github主页，进入个人设置
  • SSH and GPG keys 然后点击New SSH key
  • 将刚复制的内容粘贴到key那里，title随便填，Add!

2.4 测试是否成功

代码语言：javascript复制
$ ssh -T git@github.com

看到这个信息说明SSH已配置成功！

2.5 配置签名

在博客blog目录下，其中的name和email替换成你自己的用户名和邮箱

是你的github用户名，非昵称! 填写你的github注册邮箱

代码语言：javascript复制
$ git config --global user.name "Wasabi1234"
$ git config --global user.email  ""sss2855845850@gmail.com"

设置全局的签名，每次提交的时候都会有对应签名

3 优雅地使用Hexo

3.1 Hexo简介

Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具，支持Markdown格式，有众多优秀插件和主题。

官网 github

3.2 原理

由于github pages存放的都是静态文件，博客存放的不只是文章内容，还有文章列表、分类、标签、翻页等动态内容，假如每次写完一篇文章都要手动更新博文目录和相关链接信息，相信谁都会疯掉，所以hexo所做的就是将这些md文件都放在本地，每次写完文章后调用写好的命令来批量完成相关页面的生成，然后再将有改动的页面提交到github。

3.3 注意事项

Hexo不同版本差别比较大，网上很多文章的配置信息都是基于2.x的，所以注意不要被误导； hexo有2种_config.yml文件，一个是根目录下的全局的_config.yml，一个是各个theme下的；

3.4 安装Hexo

在你认为合适的地方创个文件夹，我是在D盘建了一个blog文件夹。然后通过命令行进入到该文件夹里面

代码语言：javascript复制
$ npm install -g hexo-cli

安装位置

代码语言：javascript复制
‎⁨soft⁩ ▸ ⁨usr⁩ ▸ ⁨local⁩ ▸ ⁨lib⁩ ▸ ⁨node_modules⁩

3.5 初始化

在电脑的某个地方新建一个名为hexo的文件夹（名字可以随便取），比如我的是/Volumes/doc/hexo，由于这个文件夹将来就作为你存放代码的地方，所以最好不要随便放。

代码语言：javascript复制
$ cd /f/Workspaces/hexo/
$ hexo init

hexo会自动下载一些文件到这个目录，包括node_modules

代码语言：javascript复制
$ hexo g # 生成
  • 启动服务
代码语言：javascript复制
$ hexo s

执行以上命令之后，hexo就会在public文件夹生成相关html文件，这些文件将来都是要提交到github去的

hexo s是开启本地预览服务

  • 打开浏览器访问 http://localhost:4000 即可看到内容

3.6 修改主题

默认主题丑到反人类，替换一个好看点的主题

首先下载这个主题：

代码语言：javascript复制
$ git clone https://github.com/wizardforcel/hexo-theme-landfarz.git themes/landfarz
  • 下载后的主题都在这里
  • 修改_config.yml中的theme landscape改为theme: landfarz
  • 然后重新执行hexo g来重新生成

3.7 备份

在上传代码到github之前，一定要记得先把你以前所有代码下载下来（虽然github有版本管理，但备份一下总是好的），因为从hexo提交代码时会把你以前的所有代码都删掉。

3.8 部署

如果你一切都配置好了，发布上传很容易，一句hexo d就搞定，当然关键还是你要把所有东西配置好。

  • 首先，ssh key肯定要配置好。
  • 其次，配置_config.yml中有关deploy的部分：

正确写法：

代码语言：javascript复制
deploy:
  type: git
  repository: git@github.com:liuxianan/liuxianan.github.io.git
  branch: master

错误写法：

代码语言：javascript复制
deploy:
  type: github
  repository: https://github.com/liuxianan/liuxianan.github.io.git
  branch: master

后面一种写法是hexo2.x的写法，现在已经不行了

  • 无论是哪种写法,此时直接执行hexo d会报如下错误：
  • 还需要安装一个插件
代码语言：javascript复制
sudo npm install hexo-deployer-git --save

根据警告再安装即可

发现又有警告,MD!

好了,终于没有警告了!

输入hexo d就会将本次有改动的代码全部提交，没有改动的不会

3.9 保留README.md等文件

提交之后网页上一看，发现以前其它代码都没了，此时不要慌，一些非md文件可以把他们放到source文件夹下，这里的所有文件都会原样复制（除了md文件）到public目录的：

由于hexo默认会把所有md文件都转换成html，包括README.md，所有需要每次生成之后、上传之前，手动将README.md复制到public目录，并删除README.html。

3.10 常用hexo命令

常见命令

代码语言：javascript复制
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl   c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

缩写：

代码语言：javascript复制
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

组合命令：

代码语言：javascript复制
hexo s -g #生成并本地预览
hexo d -g #生成并上传

3.11 _config.yml

这里面都是一些全局配置，每个参数的意思都比较简单明了，所以就不作详细介绍了。

需要特别注意的地方是，冒号后面必须有一个空格，否则可能会出问题。

4 写博客

4.1 新建博客

定位到我们的hexo根目录，执行命令：

hexo会帮我们在_posts下生成相关md文件：

我们只需要打开这个文件就可以开始写博客了，默认生成如下内容：

当然你也可以直接自己新建md文件，用这个命令的好处是帮我们自动生成了时间。

一般完整格式如下：

代码语言：javascript复制
---
title: postName #文章页面上的显示名称，一般是中文
date: 2019-07-11 19:11:33 #文章生成时间，一般不改，当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签，可空，多标签请用格式，注意:后面有个空格
description: 附加一段文章摘要，字数最好在140字以内，会出现在meta的description里面
---

正文

那么hexo new page 'postName'命令和hexo new 'postName'有什么区别呢？

最终部署时生成一个index.html，但是它不会作为文章出现在博文目录

4.2 撰写工具

可以用typora来进行博客的编写或者用CSDN的编辑器也是很不错的选择，用VScode的Markdown-toc插件来为我们的文章自动生成目录。

5 优雅地使用Hexo的next主题

5.1 安装

代码语言：javascript复制
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

5.2 启用

与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后，打开站点配置文件， 找到 theme 字段，并将其值更改为 next。

5.3 验证主题

首先启动 Hexo 本地站点，并开启调试模式（即加上 --debug）

代码语言：javascript复制
hexo s --debug

在服务启动的过程，注意观察命令行输出是否有任何异常信息，如果你碰到问题，这些信息将帮助他人更好的定位错误。 当命令行输出中提示出：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl C to stop. 此时即可使用浏览器访问 http://localhost:4000，检查站点是否正确运行。

5.4 配置

在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

为了描述方便，在以下说明中，将前者称为 站点配置文件， 后者称为 主题配置文件。 你可以访问 Hexo 的文档 了解如何安装 Hexo病进行 站点配置文件的配置 简单的设置可以参考： NEXT中文文档 NEXT主题详细配置

参考

github git 开源 hexo ssh

0 人点赞