如何建立自己的博客(旧博客)

如何建立自己的博客

本文章从本网站旧的 Hexo NexT 博客复制，可能过时或有编排问题

论怎么免费用 Hexo 建立自己的博客

介绍：
Github Pages 是由开源网站 Github 开发的网站自建工具，每一个用户都可以免费设立自己的博客网站

提示：
此教程包含不少访问国外网站的要求，如无法访问，请使用科学上网或见文章末尾。

要求：

  1. 一台正常的 Windows 计算机
  2. 能访问 Github 的网络 ( 如果不能/网络高峰期需要 Watt Toolkit 等加速 )
  3. 一定的知识储备

第一步 开始

使用 Hexo 需要安装必需软件：

此外，还需要使用 Github 账号创建 GitHub Pages 存储库，如果有账号，可以跳过注册账号这一步。

  • 进入 Github 网站后，点击 Sign Up (注册) 注册账号
  • 根据网站提示注册完成
  • 点击上方栏中加号，选择新建存储库 (New repository)， Owner 旁边存储库名必须为 “账户名.github.io” 才能建立 Pages，Create Reponsitory 完成。

第二步 配置

在你的电脑中设置一个空文件夹，作为网站根目录
右击菜单点击 Git Bash 打开 Git 命令行。
在命令行中输入如下命令，配置Git用户名和邮箱地址

1
2
git config --global user.name "你的Github用户名"  
git config --global user.email "你的Github邮箱"

安装 Hexo 以及推送程序

1
2
npm install -g hexo-cli   
npm install hexo-deployer-git --save

新建 SSH 密钥

  • 查看用户目录下 .ssh 文件夹是否有文件，如果有且没有配置 ssh，请删除用户目录下 .ssh 文件夹中的 id_rsa 文件

  • 生成密钥并复制此密钥，格式如下

    1
    2
    ssh-keygen -t rsa -C "你的Github邮箱"  
    cat id_rsa.pub

  • 密钥格式：

    ssh-rsa ……(密钥字符)

上传密钥

打开 Github，进入 Setting -> SSH and GPG keys -> New SSH key
新建密钥，名字自由填写，密钥填入刚刚复制的密钥
点击 Add SSH Key 完成

验证配置
在 Git Bash 上使用下列命令验证 Git 是否登录完成

1
ssh -T git@github.com

如果出现下列输出

1
Connection closed by 198.18.0.4 port 22

请使用另一方案

1
ssh -T -p 443 git@ssh.github.com

出现下列情况即为成功

1
Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.

第三步 创建你自己的网站

打开先前的网站根目录，使用 Git Bash 执行下列命令初始化网站

1
2
3
hexo init ...(填写你的博客根目录文件夹名)  
cd ...(你的博客根目录文件夹名)  
npm install

生成静态文件并启动本地网页 

1
2
hexo g  
hexo s

成功后示例输出，点击链接(本地网站)访问

博客根目录(以下简称”根目录”)文件夹下的 source 和 themes 是我们需要的文件夹，下面是网站初始状态的文件

1
2
3
4
5
source  
    _posts  
        hello-world.md  
themes  
    .gitkeep

posts 用于存放博客
themes 文件夹内通常放置主题文件夹，示例如下

1
2
3
4
5
6
7
8
9
10
themes  
    主题文件夹  
        .github  
        languages  
        layout  
            _scripts   
            _third-party    
        scripts  
        source  
        _config.yml

更改基本设置

打开根目录中的 _config.yml。

找到 #Site 部分，示例配置如下
language(语言) 和 timezone(时区) 根据个人情况而定

从下图示例位置(你的存储库中点击 Code -> Local -> SSH 复制ssh git)
找到 #Depolyment 部分，配置如下

1
2
3
4
deploy:  
  type: git  
  repo: git@github.com: 你获取的ssh git  
  branch: 你的主分支

以上推送配置完成

更换你的主题
在 Hexo 主题 网页中有许多的主题，可以自行下载喜欢的。
下载之后将主题文件夹 (文件夹名以下简称 th) 放入根目录 themes 文件夹中
th 文件夹中应该直接包含 _config.yml 和 source (文件夹)。

打开根目录中的 _config.yml ，将主题修改为 th，将语言修改为 zh-CN。

1
2
theme: th  
language: zh-CN

发布博客

使用命令新建文章，文章在 _posts 文件夹里

1
hexo new post 文章题目

找到文章(MarkDown 文件)，使用 MarkDown 语法编辑文章即可

第四步 推送网站

使用命令推送网站，等待 Github Actions 完成即可访问。

1
hexo g -d

感谢阅读！