mac上怎么搭建github博客

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 环境,最后编写并发布博客。

希望这篇文章可以帮助到你。如果你有任何问题,请在评论区留言。谢谢!