欢迎来到我的博客！这是一个基于Jekyll构建的现代化博客系统。

什么是Jekyll？

Jekyll是一个简单、博客感知的静态网站生成器。它使用Liquid模板语言，支持Markdown、Textile和Liquid标记语言，并且可以运行在GitHub Pages上。

主要特点

  • 静态网站生成：将Markdown文件转换为静态HTML
  • 模板系统：使用Liquid模板语言
  • 插件支持：丰富的插件生态系统
  • GitHub集成：完美支持GitHub Pages

开始使用

1. 安装Jekyll

gem install jekyll bundler

2. 创建新站点

jekyll new my-blog
cd my-blog

3. 启动本地服务器

bundle exec jekyll serve

项目结构

my-blog/
├── _config.yml      # 配置文件
├── _layouts/        # 布局模板
├── _posts/          # 博客文章
├── _sass/           # Sass样式文件
├── assets/          # 静态资源
└── index.md         # 首页

写作博客文章

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

---
layout: post
title: "文章标题"
date: 2024-01-15 10:00:00 +0800
categories: [分类]
tags: [标签1, 标签2]
---

文章内容...

自定义主题

你可以通过修改以下文件来自定义博客外观：

  • _layouts/default.html - 默认布局
  • _layouts/post.html - 文章布局
  • assets/css/main.scss - 样式文件

部署到GitHub Pages

  1. 将代码推送到GitHub仓库
  2. 在仓库设置中启用GitHub Pages
  3. 选择源分支（通常是main）
  4. 等待部署完成

代码块测试

/*!
 * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/)
 * Copyright 2011-2025 The Bootstrap Authors
 * Licensed under the Creative Commons Attribution 3.0 Unported License.
 */

(() => {
  'use strict'

  const getStoredTheme = () => localStorage.getItem('theme')
  const setStoredTheme = theme => localStorage.setItem('theme', theme)

  const getPreferredTheme = () => {
    const storedTheme = getStoredTheme()
    if (storedTheme) {
      return storedTheme
    }

    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
  }

  const setTheme = theme => {
    if (theme === 'auto') {
      document.documentElement.setAttribute('data-bs-theme', (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'))
    } else {
      document.documentElement.setAttribute('data-bs-theme', theme)
    }
  }

  setTheme(getPreferredTheme())

  const showActiveTheme = (theme, focus = false) => {
    const themeSwitcher = document.querySelector('#bd-theme')

    if (!themeSwitcher) {
      return
    }

    const themeSwitcherText = document.querySelector('#bd-theme-text')
    const activeThemeIcon = document.querySelector('.theme-icon-active use')
    const btnToActive = document.querySelector(`[data-bs-theme-value="${theme}"]`)
    const svgOfActiveBtn = btnToActive.querySelector('svg use').getAttribute('href')

    document.querySelectorAll('[data-bs-theme-value]').forEach(element => {
      element.classList.remove('active')
      element.setAttribute('aria-pressed', 'false')
    })

    btnToActive.classList.add('active')
    btnToActive.setAttribute('aria-pressed', 'true')
    activeThemeIcon.setAttribute('href', svgOfActiveBtn)
    const themeSwitcherLabel = `${themeSwitcherText.textContent} (${btnToActive.dataset.bsThemeValue})`
    themeSwitcher.setAttribute('aria-label', themeSwitcherLabel)

    if (focus) {
      themeSwitcher.focus()
    }
  }

  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
    const storedTheme = getStoredTheme()
    if (storedTheme !== 'light' && storedTheme !== 'dark') {
      setTheme(getPreferredTheme())
    }
  })

  window.addEventListener('DOMContentLoaded', () => {
    showActiveTheme(getPreferredTheme())

    document.querySelectorAll('[data-bs-theme-value]')
      .forEach(toggle => {
        toggle.addEventListener('click', () => {
          const theme = toggle.getAttribute('data-bs-theme-value')
          setStoredTheme(theme)
          setTheme(theme)
          showActiveTheme(theme, true)
        })
      })
  })
})()

总结

Jekyll是一个强大而灵活的静态网站生成器，特别适合个人博客和技术文档。通过简单的配置和Markdown写作，你就能拥有一个专业的博客网站。

提示：更多Jekyll使用技巧和高级功能，请关注后续文章！

如果你有任何问题或建议，欢迎在评论区留言讨论！