Meiting Wang

利用 Github Pages + jekyll-TeXt-theme 初步搭建个人博客

 
  • Meiting Wang
  • Aug 04, 2023

依据B站视频零基础-通过Github Pages搭建个人博客，在结合自己的习惯，这里记录一下自己第一次搭建个人博客的整个过程，以便自己后续查阅。

准备工作

Git环境搭建

  • 打开 git bash

  • 配置用户名和邮箱

git config --global user.name "wangmeiting"
git config --global user.email "wangmeiting92@gmail.com"
  • 生成ssh公钥
ssh-keygen -t rsa -C "wangmeiting92@gmail.com"
  • 配置公钥至github：
    1. 打开文件~/.ssh/id_rsa.pub，复制里面的公钥
    2. 打开github网站>点击右上角个人头像>点击setting>点击SSH and GPG keys>点击 new SSH key>填写好title，key type 选择 Authentication Key，粘贴前面复制的公钥至Key中>点击Add SSH key
    3. git bash里输入ssh -T git@github.com，检测以上操作是否成功。
  • git代理设置（基于v2rayN代理软件）。如果需要通过命令行访问外网，就需要为命令行单独设置代理，因为只是配置好v2rayN并不能使得终端走代理。
# 设置 HTTP 代理：
git config --global http.proxy "http://127.0.0.1:10809"
git config --global https.proxy "http://127.0.0.1:10809"

# 设置 SOCKS5 代理(HTTP代理与 SOCKS5 代理只能选择其一，均可使用)：
git config --global http.proxy "socks5://127.0.0.1:10808"
git config --global https.proxy "socks5://127.0.0.1:10808"

# 查看代理设置情况
cat ~/.gitconfig

# 取消代理设置：
git config --global --unset http.proxy
git config --global --unset https.proxy

# 测试 HTTPS clone 速度
git clone https://github.com/XXXXXX/XXXXXX.git
  • 为了后期使用git的便捷，这里创建一个命令，将add、commit、push三个命令合并到一起。创建完成之后，便可以使用类似git cmp "modified information"的语句进行调用：
git config --global alias.cmp '!f() { git add -A && git commit -m "$@" && git push; }; f'

更详细的Git环境搭建与代理设置参见Git的配置与代理设置。

博客环境搭建

博客使用的主题为jekyll-TeXt-theme，博客环境搭建过为：

  • 克隆该项目至本地：
git clone git@github.com:kitian616/jekyll-TeXt-theme.git
  • 新建一个管理自己博客的文件夹（下称文件夹），复制以上项目的所有文件和文件夹至该文件夹内（除了.git文件夹）
  • 在github网页端新建立一个仓库，命名为Meiting-Wang.github.io
  • 在文件夹内进入git bash，运行以下代码。
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:Meiting-Wang/Meiting-Wang.github.io.git
git push -u origin main
  • 过一小段时间，博客网页就搭建好了，网页为：https://meiting-wang.github.io/

这里值得注意的是，一个用户只能有一个名为<username>.github.io的仓库，此时站点为https://<username>.github.io/。然而，我们可能还会需要多个github pages，这也是可以实现的。其他的流程同上，不同的部分在github网页端，具体如下：(1)新建一个仓库，名称随意；(2)点击仓库的setting>Pages>Build and deployment>Branch，选择你要用来部署page的分支，如main，文件夹选/(root)，再点击save。(3)博客网页将为：https://<username>.github.io/<repository>/。以上阐述参考资料为如何拥有多个GitHub Pages。

jekyll-TeXt-theme 的初步使用

配置

我们可以通过修改文件夹根目录下的_config.yml文件来实现博客的个性化配置。以下为一些关键字：

关键字 含义
text_skin 皮肤
highlight_theme 代码高亮主题
title 网站标题
lang 语言
timezone 时区
mathjax 数学公式
mathjax_autoNumber 数学公式的自动编号

写博客

所有的文章都在 /_posts 文件夹中。我们所有以 markdown 格式书写的文章都需要放在这个文件夹中。

jekyll-TeXt-theme结语

以上仅为该主题的初步使用。原作者提供了详细的使用教程，参见jekyll-TeXt-theme中文官方教程。

相关网站

Search