Farice IT路上的潜行者

CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Jekyll static site blog hosted on GitHub Pages at https://farice4.github.io. The site is written primarily in Chinese and documents the author’s journey in IT, covering topics like OpenStack, Kubernetes, Python, and Linux.

Commands

Build and Serve

# Install dependencies
bundle install

# Serve locally with live reload
bundle exec jekyll serve

# Build for production
bundle exec jekyll build

Architecture

Jekyll Structure

├── _config.yml        # Site configuration (title, URL, theme, pagination, comments)
├── _layouts/          # HTML templates (default, post, page, demo)
├── _includes/         # Reusable HTML snippets (header, footer, head, comments)
├── _posts/            # Blog posts organized by category (OpenStack, Kubernetes, Python, Linux, etc.)
├── _drafts/           # Unpublished posts
├── _sass/             # SCSS partials imported by main.scss
├── css/               # Compiled stylesheets
├── js/                # JavaScript files (main.js, scroll.js, pageContent.js, etc.)
├── page/              # Static pages (about, collections)
├── index.html         # Homepage with pagination and sidebar
└── 404.md             # Custom 404 page

Key Configuration (_config.yml)

Post Front Matter

Posts use YAML front matter with these fields:

---
layout: post
title: "Post Title"
date: YYYY-MM-DD
categories: Category
tags: [tag1, tag2]
author: Author Name
---

Styling

Key Includes

Content