This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
A Jekyll-based documentation website for DanceXR — a VR character model viewer (PMX/MMD, XNALara/XPS models; VMD/BVH motions). Hosted via GitHub Pages using the alloystorm/minimal-mistakes remote theme. There is no local build step; content is all Markdown + YAML.
dancexr/ — English source documentation (features, releases, menus)
features/ — one .md file per feature topicfeatures.md — master feature index (Markdown table)releases/ — monthly release notes (e.g., 2026.3.md)jp/dancexr/, zh/dancexr/, tw/dancexr/, kr/dancexr/ — localized mirrors of dancexr/_data/nav_links.yml — sidebar nav hierarchy (releases grouped by year, feature nav)_data/ui-text.yml — theme UI string translations_config.yml — Jekyll config (theme, plugins, analytics, footer links)script/ — Python utilities for translation automationEvery content page starts with a YAML front matter block specifying its layout and metadata. Valid layout options are home, release, feature, and studio-home.
Example of a feature page:
---
layout: feature
title: "Video Player"
locale: en-US
---
Example of a home/dashboard page (such as support):
---
layout: home
title: Support
toc: false
locale: en-US
lang_path: /dancexr/support
hero_compact: true
hero_title: Support
hero_image: /images/hero.png
---
Never alter YAML front matter fields (except title, locale, permalink, sidebar.nav when translating), the language links block, or Jekyll Liquid tags.
| Language | Directory prefix | Locale | Nav suffix |
|---|---|---|---|
| Japanese | jp/dancexr/ |
ja-JP |
-jp |
| Simplified Chinese | zh/dancexr/ |
zh-CN |
-zh |
| Traditional Chinese | tw/dancexr/ |
zh-TW |
-tw |
| Korean | kr/dancexr/ |
ko-KR |
-kr |
Translation detection uses git log -1 --pretty=format:%ci on both source and destination files; if the source commit date is newer, the translation is outdated. See script/translate_pages.py and script/utils.py for the implementation.
Language links block is identical in every language version — never translate it, never alter URLs.
When translating an outdated page, prefer updating only the changed sections rather than rewriting the whole file.
Two skills under .github/skills/ define step-by-step AI workflows:
translate-docs — translates missing or outdated pages into all four languages (full spec in .github/skills/translate-docs/SKILL.md)update-feature-docs — merges release note updates into feature pages and the master features.md index (spec in .github/skills/update-feature-docs/SKILL.md)For update-feature-docs: never create a new feature page without explicit user permission; always ask first if a release note introduces a feature with no matching file in dancexr/features/.