Skip to content

fix: rename zh-CN/ to zh/ to conform to Mintlify i18n spec#837

Closed
comfyui-wiki wants to merge 4 commits intomainfrom
fix/rename-zh-CN-to-zh
Closed

fix: rename zh-CN/ to zh/ to conform to Mintlify i18n spec#837
comfyui-wiki wants to merge 4 commits intomainfrom
fix/rename-zh-CN-to-zh

Conversation

@comfyui-wiki
Copy link
Copy Markdown
Member

Summary

  • Rename zh-CN/ directory to zh/ to use ISO 639-1 two-letter code as required by Mintlify internationalization spec
  • docs.json already had "language": "zh" — this PR aligns the file paths to match
  • Update all internal link references from /zh-CN/ to /zh/ across all MDX files, snippets, and JS scripts
  • Add wildcard redirect in docs.json: /zh-CN/:slug*/zh/:slug* for backward compatibility
  • Update language-switcher-fix.js and giscus-comments.js URL patterns
  • Update GitHub Actions workflow (zh-cn-sync-check.yml) and validate-links.py to use zh/ paths
  • Update README.md and README.zh-CN.md references

Test plan

  • Verify Chinese docs load at /zh/ paths
  • Verify old /zh-CN/ URLs redirect to /zh/ equivalents
  • Check CI passes (zh translation sync check, validate-links, mint-checks)

🤖 Generated with Claude Code

comfyui-wiki and others added 3 commits March 29, 2026 23:01
Mintlify requires ISO 639-1 two-letter language codes (zh, not zh-CN).
- Rename zh-CN/ directory to zh/
- Update all zh-CN/ path references in docs.json, snippets, JS files, CI scripts
- Add redirect rule in docs.json: /zh-CN/:slug* → /zh/:slug*
- Update language-switcher-fix.js and giscus-comments.js URL patterns
- Update GitHub Actions workflow and validate-links.py

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Update docs.json navigation paths that remained zh-CN after conflict resolution
- Update translationFrom metadata in ja/ files to reflect renamed zh/ directory
- Update internal links in zh/ content files

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…tion

The original PR added /zh-CN/:slug* → /zh/:slug* for backward compatibility,
but it was dropped during rebase conflict resolution.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant