GitHub Pages 博客搭建教程

GitHub Pages 博客搭建教程

lemonchann.github.io可 fork 的博客教程模板项目地址:https://gitcode.com/gh_mirrors/le/lemonchann.github.io

项目介绍

lemonchann.github.io 是一个基于 Jekyll 的博客模板项目，旨在帮助用户快速搭建个人博客。该项目提供了详细的教程和配置指南，使得即使是非技术背景的用户也能轻松上手。博客模板风格简约，支持多种自定义功能，如社交链接、网站访客统计、评论功能等。

项目快速启动

克隆项目

首先，克隆项目到本地：

git clone https://github.com/lemonchann/lemonchann.github.io.git
cd lemonchann.github.io

安装依赖

确保你已经安装了 Ruby 和 Bundler。然后安装项目依赖：

bundle install

本地预览

启动本地服务器，预览博客：

bundle exec jekyll serve

打开浏览器，访问 http://localhost:4000 即可看到博客效果。

应用案例和最佳实践

自定义配置

在 _config.yml 文件中，你可以修改博客的基本信息，如博客名称、描述、社交链接等。以下是一个示例配置：

title: 我的博客
description: 欢迎来到我的个人博客
url: "https://yourusername.github.io"
github_username: yourusername
twitter_username: yourtwitter

添加文章

在 _posts 目录下，创建一个新的 Markdown 文件，格式为 YYYY-MM-DD-title.md。在文件开头添加 YAML 头部信息：

---
layout: post
title:  "欢迎来到我的博客"
date:   2023-10-01 12:00:00 +0800
categories: 生活
---

然后，在文件中编写文章内容。

典型生态项目

Jekyll

Jekyll 是一个静态站点生成器，广泛用于搭建个人博客和项目文档。它支持 Markdown 和 Liquid 模板语言，能够生成静态 HTML 页面。

GitHub Pages

GitHub Pages 是一个免费的静态站点托管服务，直接与你的 GitHub 仓库集成。通过 GitHub Pages，你可以轻松部署和托管你的 Jekyll 博客。

Gitalk

Gitalk 是一个基于 GitHub Issues 的评论系统，适用于静态站点。通过配置 Gitalk，你可以在博客中添加评论功能，增强互动性。

通过以上步骤和配置，你可以快速搭建并自定义你的个人博客。希望这个教程对你有所帮助！

lemonchann.github.io可 fork 的博客教程模板项目地址:https://gitcode.com/gh_mirrors/le/lemonchann.github.io