|
| 1 | +# CLAUDE.md |
| 2 | + |
| 3 | +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. |
| 4 | + |
| 5 | +## Project Overview |
| 6 | + |
| 7 | +This is a Jekyll-based personal website/blog hosted on GitHub Pages. The site includes: |
| 8 | +- Personal blog posts (markdown files in `_posts/`) |
| 9 | +- Static pages (like `/about/`) |
| 10 | +- Both standard posts and link posts |
| 11 | +- Social media integration (Twitter, Facebook Open Graph) |
| 12 | +- RSS/Atom feed generation |
| 13 | + |
| 14 | +## Architecture |
| 15 | + |
| 16 | +### Key Directories |
| 17 | +- `_posts/` - Blog posts in markdown format with YAML frontmatter |
| 18 | +- `_layouts/` - Jekyll layout templates (default.html, post.html, page.html, link.html) |
| 19 | +- `_includes/` - Reusable template partials (head.html, foot.html) |
| 20 | +- `_drafts/` - Unpublished draft posts |
| 21 | +- `css/` - Stylesheets including compiled LESS |
| 22 | +- `img/` - Image assets organized by year |
| 23 | +- `about/` - Static about page |
| 24 | + |
| 25 | +### Template Structure |
| 26 | +- `default.html` - Base layout with header, navigation, and footer |
| 27 | +- `post.html` - Blog post layout extending default |
| 28 | +- `page.html` - Static page layout extending default |
| 29 | +- `link.html` - Special layout for link posts extending default |
| 30 | + |
| 31 | +### Key Features |
| 32 | +- Jekyll plugins: mentions, emoji, redirects, sitemap, feed, pagination |
| 33 | +- Security headers (CSP, XSS protection, frame options) |
| 34 | +- Social media meta tags for Twitter cards and Facebook Open Graph |
| 35 | +- Custom CSS with version cache busting |
| 36 | +- Octicons for icons |
| 37 | +- Google Analytics integration |
| 38 | +- "Improve this page" GitHub edit links |
| 39 | + |
| 40 | +## Development Commands |
| 41 | + |
| 42 | +### Local Development |
| 43 | +```bash |
| 44 | +# Install dependencies (if Jekyll/bundler not installed) |
| 45 | +gem install jekyll bundler |
| 46 | + |
| 47 | +# Serve locally with auto-regeneration |
| 48 | +jekyll serve |
| 49 | + |
| 50 | +# Build for production |
| 51 | +jekyll build |
| 52 | +``` |
| 53 | + |
| 54 | +### Deployment |
| 55 | +The site is automatically deployed via GitHub Pages when changes are pushed to the main branch. No manual deployment is needed. |
| 56 | + |
| 57 | +## Content Guidelines |
| 58 | + |
| 59 | +### Blog Posts |
| 60 | +- Use YAML frontmatter with title, date, and optional layout |
| 61 | +- Default layout is "post" |
| 62 | +- For link posts, use layout "link" and include a "link" field in frontmatter |
| 63 | +- Images should be placed in `/img/YYYY/` folders organized by year |
| 64 | +- Posts should use markdown format with `.md` extension |
| 65 | + |
| 66 | +### Styling |
| 67 | +- Main styles are in `/css/styles.css` |
| 68 | +- LESS source is in `/css/styles.less` |
| 69 | +- Theme uses "theme-base-08" color scheme |
| 70 | +- Responsive design with mobile-first approach |
0 commit comments