1. 简介
在当今时代,拥有一个博客是很重要的。它可以让你与世界分享你的想法、经验和知识。Github Pages 为你提供了一个免费的博客搭建平台,允许你轻松地创建和发布博客。在本文中,我们将介绍如何在 Mac 上搭建 Github 博客。
2. 创建 Github Pages Repo
2.1 创建 Github 账号
首先,你需要在 Github 上创建一个账号。如果你已经有了 Github 账号,那么请跳过这一步。
打开 Github 官网,在右上角选择 "Sign up" 创建账号。
# Github 官网
https://github.com/
2.2 创建 Github Pages Repo
登陆 Github 账号后,在 Github 主页点击 "New",创建一个新的仓库,取名为 "你的用户名.github.io",如我的仓库名为 "fuzhenghua.github.io"。
在仓库设置中,选择 "master branch" 作为 "GitHub Pages" 的默认分支。如果你想使用自定义域名,也可以在这里配置。
# Github Pages Repo 仓库
https://github.com/你的用户名/你的用户名.github.io/
3. 安装 Jekyll
3.1 安装 Ruby
Jekyll 是一个以 Ruby 为基础的博客系统,在安装 Jekyll 之前需要先安装 Ruby 和 RubyGems。
在终端中输入以下命令安装 Ruby:
$ brew install ruby
安装完成后,可以通过以下命令检查 Ruby 的版本:
$ ruby -v
3.2 安装 Jekyll
在终端中输入以下命令安装 Jekyll:
$ gem install jekyll bundler
安装完成后,可以通过以下命令检查 Jekyll 的版本:
$ jekyll -v
4. 配置本地 Jekyll
4.1 克隆 Github Pages Repo
在终端中输入以下命令克隆 Github Pages Repo:
$ git clone https://github.com/你的用户名/你的用户名.github.io.git
4.2 配置 Jekyll
进入克隆下来的仓库目录,并在终端中输入以下命令初始化 Jekyll:
$ bundle init
$ bundle add jekyll
等待安装完成后,输入以下命令运行 Jekyll:
$ bundle exec jekyll serve
在浏览器中输入 "localhost:4000",你将看到一个类似博客的展示页面,表示 Jekyll 配置成功。
5. 编写博客
5.1 创建博客文件
在 Github Pages Repo 中创建新的 Markdown 文件,以 ".md" 结尾,命名为你想要的页面名称。例如,我创建了一个名为 "hello-world.md" 的文件。
5.2 编写博客内容
打开 "hello-world.md" 文件,在文件头部添加以下 Front Matter:
---
layout: post
title: "Hello World"
date: 2021-05-25 08:00:00 +0800
categories: jekyll update
---
其中,layout 指定了博客页面的模板,title 指定了博客页面的标题,date 指定了博客页面的发布时间,categories 指定了博客页面的分类。实际使用时,可以根据自己的需要进行修改。
在 Front Matter 下面,你可以使用 Markdown 语法编写博客内容,例如:
# Hello World
这是我的第一篇博客。
5.3 发布博客
在终端中输入以下命令将博客文件提交到 Github:
$ git add .
$ git commit -m "Add hello-world.md"
$ git push
等待提交完成后,在浏览器中访问 "你的用户名.github.io/hello-world.html",你将看到刚才创建的博客页面。
6. 总结
Github Pages 可以帮助你快速搭建博客平台,让你轻松地创建和发布博客。在 Mac 上搭建 Github 博客需要先创建 Github Pages Repo,然后安装 Jekyll 并配置本地 Jekyll 环境,最后编写并发布博客。
希望这篇文章可以帮助到你。如果你有任何问题,请在评论区留言。谢谢!