FengMr 的个人博客

基于 Jekyll 和 GitHub Pages 的个人技术博客。

🚀 快速开始

前置要求

• Ruby (推荐 2.7+)
• Bundler

安装依赖

bundle install

本地运行

bundle exec jekyll serve

然后在浏览器访问 http://localhost:4000

构建网站

bundle exec jekyll build

生成的静态文件会在 _site 目录中。

📦 已配置的插件

本项目使用 github-pages gem，确保与 GitHub Pages 完全兼容，包含以下插件：

• jekyll-feed - RSS feed 生成
• jekyll-sitemap - 自动生成网站地图
• jekyll-seo-tag - SEO meta 标签
• jekyll-paginate - 文章分页
• jekyll-gist - 嵌入 GitHub Gist
• jekyll-redirect-from - 页面重定向
• jekyll-relative-links - 相对链接转换
• jekyll-optional-front-matter - 可选 front matter
• jekyll-readme-index - README 作为索引
• jekyll-default-layout - 默认布局
• jekyll-titles-from-headings - 从标题提取页面标题

详细使用说明请查看 docs/PLUGINS.md

📝 发布文章

快速创建（推荐）✨

使用提供的脚本快速创建带有基础格式的文章：

# 创建草稿
./scripts/new-post.sh "文章标题"

# 或直接创建发布文章
./scripts/new-post.sh "文章标题" post

详细使用说明请查看 docs/NEW_FILE_GUIDE.md

手动创建

在 _posts 目录下创建文件，文件名格式：YYYY-MM-DD-title.md

文章示例：

---
layout: post
title: "我的第一篇文章"
date: 2024-01-01 10:00:00 +0800
categories: [技术, Jekyll]
tags: [jekyll, github-pages]
---

文章内容...

📚 集合 (Collections)

项目包含以下集合：

• _pmp - PMP 相关内容

🔧 配置

主要配置在 _config.yml 文件中。

📄 许可证

MIT License

📚 项目文档

所有文档位于 docs/ 目录：

• ✨ FINAL_SUMMARY.md - 📊 项目完善最终总结
• NEW_FILE_GUIDE.md - 快速创建文件指南
• PLUGINS.md - 插件详细使用指南
• QUICKREF.md - 快速参考和常用命令
• DEPLOY.md - GitHub Pages 部署指南
• NAVIGATION.md - 导航配置说明
• PROJECT_STRUCTURE.md - 项目结构说明
• REORGANIZATION.md - 文件整理说明
• SUMMARY.md - 项目完善总结
• CHANGELOG.md - 更新日志

🔗 外部资源

• Jekyll 官方文档
• GitHub Pages 文档
• GitHub Pages 支持的插件
• Liquid 模板语言