Merge branch 'master' into to-ruby-from-javascript-2767

Author: HundredBillion

.github/workflows/ci.yml

@@ -21,14 +21,23 @@ jobs:
       - name: Dump environment
         run: env | sort
       - name: Checkout ruby/www.ruby-lang.org
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 1
       - name: Setup Ruby
-        uses: ruby/setup-ruby@a6e6f86333f0a2523ece813039b8b4be04560854 # v1.190.0
+        uses: ruby/setup-ruby@4c56a21280b36d862b5fc31348f463d60bdc55d5 # v1.301.0
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
+      - name: Setup Node.js
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: '22'
+          cache: 'npm'
+      - name: Install npm dependencies
+        run: npm ci
+      - name: Build CSS
+        run: npm run build-css
       - name: Dump Ruby version
         run: ruby -v
       - name: Run tests

.github/workflows/draft-release.yml

@@ -16,14 +16,14 @@ jobs:
     runs-on: ubuntu-latest
     if: github.repository == 'ruby/www.ruby-lang.org'
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           repository: ruby/ruby
           path: ruby
 
-      - uses: ruby/setup-ruby@v1
+      - uses: ruby/setup-ruby@4c56a21280b36d862b5fc31348f463d60bdc55d5 # v1.301.0
         with:
           ruby-version: 3.3.4
 
@@ -33,7 +33,7 @@ jobs:
 
       - name: Update data files
         run: |
-          tool/format-release .. ${{ github.event.client_payload.version || github.event.inputs.version }} .
+          tool/format-release .. ${{ github.event.client_payload.version || github.event.inputs.version }} . | (cd .. && git apply)
         working-directory: ruby
 
       - name: Cleanup ruby directory
@@ -50,7 +50,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.MATZBOT_AUTO_UPDATE_TOKEN }}
 
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
         with:
           token: ${{ secrets.MATZBOT_AUTO_UPDATE_TOKEN }}
           branch: releases/${{ github.event.client_payload.version || github.event.inputs.version }}

.github/workflows/jekyll.yml

@@ -21,21 +21,30 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - name: Setup Ruby
-        uses: ruby/setup-ruby@a6e6f86333f0a2523ece813039b8b4be04560854 # v1.190.0
+        uses: ruby/setup-ruby@4c56a21280b36d862b5fc31348f463d60bdc55d5 # v1.301.0
         with:
           ruby-version: '3.2'
           bundler-cache: true
+      - name: Setup Node.js
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: '22'
+          cache: 'npm'
+      - name: Install npm dependencies
+        run: npm ci
+      - name: Build CSS
+        run: npm run build-css
       - name: Setup Pages
         id: pages
-        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
+        uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
       - name: Build with Jekyll
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
         env:
           JEKYLL_ENV: production
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
 
   deploy:
     if: github.repository_owner == 'ruby'
@@ -47,4 +56,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0

.gitignore

@@ -8,3 +8,7 @@ vendor
 .env
 bin
 .jekyll*
+node_modules/
+stylesheets/compiled.css
+_figma/
+_svg-backup/

404.md

@@ -2,9 +2,23 @@
 layout: page
 title: "404: Not Found"
 lang: en
-permalink: 404.html
+permalink: /404.html
 ---
 
+<script>
+(function() {
+  // Detect language from URL path
+  var path = window.location.pathname;
+  var match = path.match(/^\/(bg|de|en|es|fr|id|it|ja|ko|pl|pt|ru|tr|ua|vi|zh_cn|zh_tw)\//);
+
+  if (match && match[1] !== 'en') {
+    var lang = match[1];
+    // Redirect to language-specific 404 page
+    window.location.href = '/' + lang + '/404.html';
+  }
+})();
+</script>
+
 The requested page does not exist.
 
 You might try and start from the [home page](/).

CLAUDE.md

@@ -0,0 +1,197 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the Jekyll-based source for the official Ruby programming language website (www.ruby-lang.org), featuring multi-language support for 16+ languages and a Tailwind CSS-based design system.
+
+## Build & Development Commands
+
+### Jekyll Site Operations
+
+```bash
+# Build the site (takes several minutes)
+bundle exec rake build
+
+# Serve locally at http://localhost:4000/
+bundle exec rake serve
+
+# Alternative: Jekyll direct serve with incremental builds
+bundle exec jekyll serve --watch --future --incremental
+```
+
+### CSS (Tailwind)
+
+```bash
+# Build CSS (production)
+npm run build-css
+
+# Watch CSS for development
+npm run watch-css
+```
+
+### Testing & Quality Assurance
+
+```bash
+# Run all tests (includes linter, lint, build)
+bundle exec rake test
+
+# Run individual test suites
+bundle exec rake test-news-plugin     # News archive plugin tests
+bundle exec rake test-linter          # Linter library tests
+
+# Linting
+bundle exec rake lint                 # Markdown linter
+
+# Post-build validation (requires built site)
+bundle exec rake check:markup         # Validate HTML markup
+bundle exec rake check:links          # Check for broken links (needs local server running)
+```
+
+### Creating News Posts
+
+```bash
+# Create news post template for specific language
+bundle exec rake new_post:en    # English
+bundle exec rake new_post:ja    # Japanese
+bundle exec rake new_post:fr    # French
+# ... etc for: bg, de, es, id, it, ko, pl, pt, ru, tr, vi, zh_cn, zh_tw
+```
+
+## Architecture & Structure
+
+### Multi-Language System
+
+- **16 supported languages**: bg, de, en, es, fr, id, it, ja, ko, pl, pt, ru, tr, vi, zh_cn, zh_tw
+- Language-specific content organized in top-level directories (e.g., `/en/`, `/ja/`)
+- Locale data stored in `_data/locales/*.yml`
+- Language switching handled by `_includes/language_selector.html`
+
+### Jekyll Configuration
+
+- **Markdown**: Kramdown with Rouge syntax highlighting
+- **Timezone**: UTC (critical for news posts)
+- **Permalinks**: Pretty URLs
+- **Build output**: `_site/` directory
+
+### Key Directories
+
+- `_layouts/`: Page templates (default, homepage, news_post, news_archive_month, etc.)
+- `_includes/`: Reusable components (header, footer, navigation, toc, sidebar)
+- `_plugins/`: Custom Jekyll plugins (news archive generator, posted_by, translation_status)
+- `_data/`: YAML data files (releases.yml, downloads.yml, branches.yml, locales/)
+- `lib/`: Ruby utilities (linter, markup checker, draft release)
+- `test/`: Test files for plugins and linter
+- `stylesheets/`: CSS source and compiled output
+- `_javascripts_src/`: TypeScript source files
+- `javascripts/`: Compiled JavaScript output
+
+### Design System (Tailwind CSS)
+
+The site uses a custom Tailwind configuration with:
+
+- **Semantic color tokens** via CSS variables (defined in `tailesheets/semantic-colors.css`)
+  - Accessible via `bg-semantic-*`, `text-semantic-*`, `border-semantic-*` classes
+  - Automatically handles light/dark mode via `prefers-color-scheme`
+- **Brand colors**: Ruby (red) and Gold palettes
+- **Typography plugin** for prose styling
+- **Custom breakpoints**: Container max-widths configured for content layouts
+- **Dark mode**: Enabled via OS preference (`darkMode: 'media'`)
+
+Input: `stylesheets/tailwind.css` → Output: `stylesheets/compiled.css`
+
+### News System
+
+The news system is powered by a custom Jekyll plugin (`_plugins/news.rb`):
+
+- **Archive generation**: Automatically creates yearly/monthly archive pages
+- **Post structure**: Posts stored in `{lang}/news/_posts/YYYY-MM-DD-title.md`
+- **Archive pages**: Index, yearly archives, monthly archives
+- **RSS feeds**: Generated per language via `news_feed.rss` layout
+
+### Linter (`lib/linter.rb`)
+
+Enforces strict content quality rules:
+
+- YAML front matter validation (lang, author, translator, date)
+- File naming conventions (date must match filename)
+- UTC timezone enforcement for news posts
+- Line ending consistency (LF only, no CRLF)
+- Trailing whitespace checks
+- Release post SHA hash validation (SHA1/SHA256/SHA512)
+- Release data validation against `_data/releases.yml`
+
+### Layout Hierarchy
+
+```
+default.html (base)
+├── homepage.html
+├── page.html
+├── news.html
+├── news_post.html
+├── news_archive_year.html
+├── news_archive_month.html
+└── news_feed.rss
+```
+
+### Front Matter Requirements
+
+**Standard pages:**
+```yaml
+---
+layout: page
+title: "Page Title"
+lang: en
+---
+```
+
+**News posts:**
+```yaml
+---
+layout: news_post
+title: "Post Title"
+author: "Author Name"
+translator: "Translator Name"  # Required for non-original language
+date: YYYY-MM-DD HH:MM:SS +0000  # Must be UTC
+lang: en
+---
+```
+
+## TypeScript/JavaScript
+
+- Source files in `_javascripts_src/` (TypeScript)
+- Compiled to `javascripts/` (JavaScript)
+- Files: `examples.ts`, `page.ts`
+- No build command specified - likely manual compilation or external process
+
+## Dependencies
+
+**Ruby (Gemfile):**
+- `jekyll` - Static site generator
+- `rouge` - Syntax highlighting
+- `rake` - Task automation
+- `html-proofer` - Markup validation
+- `validate-website` - Link checking
+- `minitest` - Testing framework
+- `csv`, `base64` - Ruby 3.4+ compatibility
+
+**Node (package.json):**
+- `tailwindcss` - CSS framework
+- `@tailwindcss/typography` - Prose styling plugin
+
+## Important Conventions
+
+1. **All news posts must use UTC timezone** (`+0000`) in the date field
+2. **File naming**: News posts must be `YYYY-MM-DD-title.md` matching the date in front matter
+3. **Language codes**: Must match directory structure (e.g., `lang: en` for files in `/en/`)
+4. **Translator field**: Required for translated news posts, not for original posts
+5. **Line endings**: LF only, no CRLF
+6. **Release posts**: Must include valid SHA checksums if referencing downloads
+
+## CI/CD
+
+GitHub Actions workflow (`.github/workflows/ci.yml`):
+- Runs on: Ruby 3.2, Ubuntu latest
+- Executes: `bundle exec rake test` (includes linter, lint, build)
+- Triggers: Push and pull requests

Gemfile

@@ -14,3 +14,6 @@ gem "validate-website", "~> 1.6"
 # Jekyll need them for Ruby 3.4+
 gem "csv"
 gem "base64"
+
+# Jekyll need this for Ruby 4.0.0+
+gem "logger"