11# CLAUDE.md
22
3- This file provides guidance to Claude Code (claude. ai/code) when working with code in this repository.
3+ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44
55## Project Overview
66
@@ -17,7 +17,7 @@ bundle exec rake build
1717# Serve locally at http://localhost:4000/
1818bundle exec rake serve
1919
20- # Alternative: Jekyll direct serve with incremental builds
20+ # Alternative: Jekyll direct serve with incremental builds
2121bundle exec jekyll serve --watch --future --incremental
2222```
2323
@@ -37,16 +37,16 @@ bundle exec rake lint # Markdown linter
3737
3838# Post-build validation (requires built site)
3939bundle exec rake check:markup # Validate HTML markup
40- bundle exec rake check: links # Check for broken links (needs local server running)
40+ bundle exec rake check:links # Check for broken links (needs local server running)
4141```
4242
4343### Creating News Posts
4444
4545``` bash
4646# Create news post template for specific language
47- bundle exec rake new_post: en # English
47+ bundle exec rake new_post:en # English
4848bundle exec rake new_post:ja # Japanese
49- bundle exec rake new_post: fr # French
49+ bundle exec rake new_post:fr # French
5050# ... etc for: bg, de, es, id, it, ja, ko, pl, pt, ru, tr, vi, zh_cn, zh_tw
5151```
5252
@@ -61,7 +61,7 @@ bundle exec rake new_post: fr # French
6161
6262### Jekyll Configuration
6363
64- - ** Markdown** : Kramdown with Rouge syntax highlighting
64+ - ** Markdown** : Kramdown with Rouge syntax highlighting
6565- ** Timezone** : UTC (critical for news posts)
6666- ** Permalinks** : Pretty URLs
6767- ** Build output** : ` _site/ ` directory
@@ -71,7 +71,7 @@ bundle exec rake new_post: fr # French
7171- ` _layouts/ ` : Page templates (default, homepage, news_post, news_archive_month, etc.)
7272- ` _includes/ ` : Reusable components (header, footer, navigation, toc, sidebar)
7373- ` _plugins/ ` : Custom Jekyll plugins (news archive generator, posted_by, translation_status)
74- - ` _data/ ` : YAML data files (releases.yml, downloads. yml, branches.yml, locales/)
74+ - ` _data/ ` : YAML data files (releases.yml, downloads.yml, branches.yml, locales/)
7575- ` lib/ ` : Ruby utilities (linter, markup checker, draft release)
7676- ` test/ ` : Test files for plugins and linter
7777- ` stylesheets/ ` : CSS source (includes partials that Jekyll excludes by default: directories prefixed with ` _ ` and files starting with ` _ ` )
@@ -133,7 +133,7 @@ default.html (base)
133133``` yaml
134134---
135135layout : page
136- title : " Page Title"
136+ title : " Page Title"
137137lang : en
138138---
139139```
@@ -145,7 +145,7 @@ layout: news_post
145145title : " Post Title"
146146author : " Author Name"
147147translator : " Translator Name" # Required for non-original language
148- date : YYYY-MM-DD HH:MM: SS +0000 # Must be UTC
148+ date : YYYY-MM-DD HH:MM:SS +0000 # Must be UTC
149149lang : en
150150---
151151```
@@ -178,8 +178,8 @@ lang: en
1781782 . ** File naming** : News posts must be ` YYYY-MM-DD-title.md ` matching the date in front matter
1791793 . ** Language codes** : Must match directory structure (e.g., ` lang: en ` for files in ` /en/ ` )
1801804 . ** Translator field** : Required for translated news posts, not for original posts
181- 5 . ** Line endings** : LF only, no CRLF
182- 6 . ** Release posts** : Must include valid SHA checksums if referencing downloads
181+ 5 . ** Line endings** : LF only, no CRLF
182+ 6 . ** Release posts** : Must include valid SHA checksums if referencing downloads
183183
184184## CI/CD
185185
0 commit comments