# 查看构建性能分析
bundle exec jekyll build --profile

# 输出示例：
# Filename                           | Count |  Bytes |  Time
# -----------------------------------+-------+--------+------
# _layouts/default.html              |   150 | 960000 | 2.1s
# _posts/2025-01-15-post.md          |     1 |   5000 | 0.3s
# _includes/header.html              |   150 | 120000 | 0.8s

# 增量构建（只处理修改的文件）
bundle exec jekyll build --incremental

# 或在 _config.yml 中配置
incremental: true

# _config.yml
exclude:
  - Gemfile
  - Gemfile.lock
  - node_modules
  - README.md
  - vendor
  - scripts
  - "*.config.js"
  - ".github"

# _config.yml
title: "My Blog"
description: "A tech blog about web development"
url: "https://blog.example.com"
author: "Zhang San"

plugins:
  - jekyll-seo-tag
  - jekyll-sitemap
  - jekyll-feed

---
title: "Jekyll SEO 完全指南"
description: "详细介绍如何优化 Jekyll 站点的搜索引擎排名"
date: 2025-01-15
last_modified_at: 2025-02-01
image: /images/posts/jekyll-seo.jpg
keywords: [jekyll, seo, 静态站点]
canonical_url: "https://blog.example.com/jekyll-seo-guide/"
robots: "index, follow"
---

---
layout: null
permalink: /sitemap.xml
---
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  {% for page in site.pages %}
    {% unless page.sitemap == false %}
    <url>
      <loc>{{ page.url | absolute_url }}</loc>
      <lastmod>{{ page.last_modified_at | default: page.date | date_to_xmlschema }}</lastmod>
      <changefreq>{% if page.layout == 'post' %}monthly{% else %}weekly{% endif %}</changefreq>
      <priority>{% if page.url == '/' %}1.0{% elsif page.layout == 'post' %}0.8{% else %}0.5{% endif %}</priority>
    </url>
    {% endunless %}
  {% endfor %}
</urlset>

# Gemfile
gem "jekyll-responsive-image"

# _config.yml
plugins:
  - jekyll-responsive-image

responsive_image:
  template: _includes/responsive-image.html
  default_quality: 80
  sizes:
    - width: 320
    - width: 640
    - width: 960
    - width: 1280
  output_path_format: assets/images/resized/%{width}/%{filename}

# 使用 imagemin 批量压缩
npx imagemin static/images/**/* --out-dir=assets/images --plugin=pngquant --plugin=mozjpeg

# 使用 Squoosh CLI
npx @squoosh/cli --webp '{quality:80}' static/images/*.jpg

# nginx.conf
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; style-src 'self' 'unsafe-inline';" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;

# 检查 Gem 依赖漏洞
bundle audit check --update

# 定期更新依赖
bundle update

# 锁定版本
# Gemfile.lock 应该提交到 Git

# .github/workflows/automation.yml
name: Site Automation

on:
  schedule:
    - cron: '0 0 * * 0'  # 每周日

jobs:
  update-deps:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'
      - run: bundle update
      - name: Create PR
        uses: peter-evans/create-pull-request@v5
        with:
          title: "chore: weekly dependency update"
          branch: chore/dep-update

  check-links:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'
          bundler-cache: true
      - run: |
          bundle exec jekyll build
          bundle exec htmlproofer ./_site --allow-hash-href

# 1. 导出 WordPress 数据
# 安装 WordPress 导出插件
# Tools > Export > All content

# 2. 使用 Jekyll 导入工具
gem install jekyll-import
gem install hpricot

# 3. 执行导入
ruby -r rubygems -r hpricot -r jekyll-import -e '
  JekyllImport::Importers::WordPress.run({
    "dbname"   => "wordpress_db",
    "user"     => "root",
    "password" => "",
    "host"     => "localhost",
    "prefix"   => "wp_",
    "clean_entities" => true
  })
'

# Hexo 和 Jekyll 结构相似，迁移较简单

# 1. 复制文章
cp -r hexo/source/_posts/ jekyll/_posts/

# 2. 调整 Front Matter
# Hexo 使用 <!-- more --> 作为摘要分隔
# Jekyll 默认使用 excerpt_separator

# 3. 修改模板语法
# Hexo: {% blockquote %}  → Jekyll: <blockquote>
# Hexo: {% codeblock %}   → Jekyll: ```代码块```

# Hugo 和 Jekyll 的主要差异：
# 1. 模板语言（Go Template vs Liquid）
# 2. 目录结构
# 3. Front Matter 字段名

# 迁移步骤：
# 1. 复制内容
cp -r hugo/content/post/ jekyll/_posts/

# 2. 转换 Front Matter
# Hugo: title, date, draft, tags, categories
# Jekyll: title, date, published, tags, categories

# 3. 转换模板
# {{ .Title }}        → {{ page.title }}
# {{ .Content }}      → {{ content }}
# {{ range .Pages }}  → {% for page in site.pages %}

## 迁移后检查

- [ ] 所有文章已正确导入
- [ ] Front Matter 格式正确
- [ ] 图片路径已更新
- [ ] 内部链接有效
- [ ] 分类和标签完整
- [ ] 永久链接与原站一致（或已配置重定向）
- [ ] SEO 元标签完整
- [ ] sitemap.xml 生成正确
- [ ] 旧 URL 重定向配置
- [ ] RSS feed 地址更新
- [ ] 评论系统迁移（如需要）
- [ ] 分析代码已添加

---
title: "文章标题"
date: 2025-01-15 10:30:00 +0800
last_modified_at: 2025-02-01
layout: post
permalink: /blog/article-slug/
categories: [技术, Jekyll]
tags: [tutorial, beginner]
description: "一句话描述文章内容"
author: "作者名"
image: /images/posts/article-slug.jpg
excerpt_separator: 



comments: true
toc: true
---

# 一级标题（仅用于文章标题）

## 二级标题（主要章节）

### 三级标题（子章节）

正文内容，中文与英文之间加空格。

> 引用内容

**加粗** 和 *斜体*

- 列表项1
- 列表项2

```ruby
# 代码块标注语言
puts "Hello, World!"

#!/bin/bash
# backup.sh

BACKUP_DIR="/backups/jekyll"
DATE=$(date +%Y%m%d_%H%M%S)
SITE_DIR="/opt/jekyll-site"

# 创建备份
mkdir -p "$BACKUP_DIR"
tar -czf "$BACKUP_DIR/jekyll_backup_$DATE.tar.gz" \
    --exclude='_site' \
    --exclude='.jekyll-cache' \
    --exclude='vendor' \
    -C "$(dirname $SITE_DIR)" \
    "$(basename $SITE_DIR)"

# 保留最近 30 天的备份
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

echo "Backup completed: jekyll_backup_$DATE.tar.gz"

# _config.yml
google_analytics: "G-XXXXXXXXXX"

# 仅在生产环境启用
# 在 _layouts/default.html 中
{% include analytics.html %}