CLAUDE.md

CLAUDE.md

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

项目概述

这是一个基于 Jekyll 的静态网站，使用了 Mundana 主题，主要用于分享知识和经验。网站内容以博客文章形式组织，支持分类和标签功能。

常用命令

本地开发

# 安装依赖
bundle install

# 启动本地服务器
bundle exec jekyll serve

# 构建站点
bundle exec jekyll build

部署

网站通过 GitHub Pages 自动部署，只需推送到 main 分支即可。

代码架构

目录结构

  • _posts/ - 博客文章，按日期命名
  • _pages/ - 静态页面
  • _layouts/ - 页面布局模板
  • _includes/ - 可复用的页面组件
  • assets/ - 静态资源（CSS、JS、图片）
  • _config.yml - Jekyll 配置文件

主要组件

  1. 首页 (index.html) - 显示最新文章列表
  2. AI 开发工具页面 (_pages/ai-coding-tools.html) - 专门展示 AI 开发工具的分类页面
  3. 文章系统 - 使用 Markdown 编写，支持分类和标签
  4. 导航菜单 - 在 _includes/menu-header.html 中定义

主题和样式

  • 使用 Bootstrap 4 框架
  • 自定义样式在 assets/css/custom.css 中
  • 响应式设计，支持移动端浏览

开发注意事项

文章格式

所有文章都位于 _posts/ 目录下，文件名格式为 YYYY-MM-DD-title.md。每篇文章需要包含以下 front matter：

---
layout: post
title: "文章标题"
date: YYYY-MM-DD HH:MM:SS +/-TTTT
categories: [分类1, 分类2]
tags: [标签1, 标签2]
image: /assets/images/文章相关图片.png
author: 作者名
---

页面创建

静态页面位于 _pages/ 目录下，需要包含以下 front matter：

---
layout: page
title: "页面标题"
permalink: "/页面路径/"
---

导航菜单

导航菜单在 _includes/menu-header.html 文件中定义，如需添加新菜单项，请在此文件中添加相应链接。

样式定制

自定义样式应添加到 assets/css/custom.css 文件中，避免修改主题核心样式文件。