Jekyll 与 al-folio 博客维护笔记

这个站点基于 Jekyll 和 al-folio。日常维护主要是写 Markdown、调整 front matter、跑本地构建确认没有破坏页面。

文章文件命名

文章放在 _posts/：

_posts/2025-07-14-jekyll-al-folio.md

文件名格式是：

YYYY-MM-DD-slug.md

日期会影响文章排序，slug 建议用英文，避免链接里出现编码问题。

front matter

每篇文章开头都有一段 YAML：

---
layout: post
title: 文章标题
date: 2025-06-22 12:00:00
tags: [jekyll, blog]
categories: notes
permalink: /blog/example/
---

其中：

• layout 决定页面模板。
• title 是文章标题。
• date 决定排序。
• tags 用于标签聚合。
• permalink 决定最终访问路径。

本地构建

常用命令：

bundle exec jekyll build --baseurl /al-folio

构建通过后，再看 _site/ 生成结果是否符合预期。

写作建议

• 标题直接说主题，不要太抽象。
• 一篇文章解决一个问题。
• 命令用代码块包起来。
• 重要步骤写清楚前提条件。
• 遇到坑要写“现象、原因、解决方式”。

适合补充的内容

• 工具使用笔记：Git、npm、Docker、Shell。
• 项目复盘：背景、技术栈、难点、收获。
• 环境配置：Node、Ruby、Python、数据库。
• 团队协作规范：分支、提交、PR、CI。

博客不是一次写完的文档，更像持续整理的知识库。先写能用的，再慢慢补细节。