w
guide

Multilingual Content Management

This guide explains how to manage and maintain multilingual content on our platform, ensuring all language versions remain synchronized and consistent.

Supported Languages

The platform currently supports the following languages:

  • Simplified Chinese (zh) - Primary language
  • Traditional Chinese (zh-Hant) - Traditional Chinese version
  • English (en) - International language
  • Japanese (ja) - For Japanese users
  • Korean (ko) - For Korean users
  • French (fr) - For French users
  • German (de) - For German users
  • Spanish (es) - For Spanish users
  • Indonesian (id) - For Indonesian users
  • Brazilian Portuguese (pt-BR) - For Brazilian users
  • Russian (ru) - For Russian users
  • Turkish (tr) - For Turkish users

Directory Structure

Multilingual content is organized in the following structure:

content/
โ”œโ”€โ”€ zh/                    # Simplified Chinese (primary language)
โ”‚   โ”œโ”€โ”€ 01.docs/          # Documentation
โ”‚   โ”œโ”€โ”€ 02.guides/        # Guides
โ”‚   โ””โ”€โ”€ 03.tools/         # Tools
โ”œโ”€โ”€ en/                    # English
โ”œโ”€โ”€ ja/                    # Japanese
โ”œโ”€โ”€ ko/                    # Korean
โ”œโ”€โ”€ fr/                    # French
โ”œโ”€โ”€ de/                    # German
โ”œโ”€โ”€ es/                    # Spanish
โ”œโ”€โ”€ id/                    # Indonesian
โ”œโ”€โ”€ pt-BR/                 # Brazilian Portuguese
โ”œโ”€โ”€ ru/                    # Russian
โ”œโ”€โ”€ tr/                    # Turkish
โ””โ”€โ”€ zh-Hant/               # Traditional Chinese

Content Synchronization Principles

1. Primary Language Priority

  • Simplified Chinese (zh) is the primary language, all new content is first created in the Chinese version
  • Other language versions are translated based on the Chinese version

2. File Structure Consistency

  • All language versions must maintain the same directory structure
  • File names and paths must be completely consistent
  • Ensure each language version has corresponding files

3. Content Completeness

  • Important documents must have corresponding versions in all languages
  • Prioritize translation of core functionality and user guides
  • Technical documentation can be prioritized for the primary language

Translation Workflow

1. Content Creation

  1. Create new content in the Chinese version
  2. Ensure content structure is clear and easy to translate
  3. Use standard Markdown format

2. Translation Priority

High Priority:

  • User interface text
  • Frequently asked questions
  • Quick start guides
  • Core functionality documentation

Medium Priority:

  • Detailed technical documentation
  • API reference documentation
  • Configuration guides

Low Priority:

  • Advanced feature documentation
  • Developer tool documentation
  • Example code comments

3. Translation Quality Check

  • Ensure translation accuracy and completeness
  • Maintain consistency of technical terms
  • Check for grammar and spelling errors
  • Verify links and references

Automation Tools

Multilingual Content Check Script

Use the built-in check script to verify content synchronization status:

# Check content synchronization status for all languages
node scripts/multilingual-content.js check

# Create missing file structure
node scripts/multilingual-content.js init

# Create welcome pages
node scripts/multilingual-content.js welcome

Content Synchronization Status

The script displays missing files for each language version, helping identify content that needs translation.

Translation Guidelines

1. Terminology Consistency

Establish a terminology glossary to ensure technical terms remain consistent across all languages:

  • API - Keep in English
  • HTTP - Keep in English
  • JSON - Keep in English
  • UUID - Keep in English
  • Base64 - Keep in English

2. Format Standards

  • Use standard Markdown syntax
  • Maintain consistent heading levels
  • Ensure code block formatting is correct
  • Maintain consistency of links and image references

3. Cultural Adaptation

  • Consider expression habits of different cultures
  • Adapt examples and explanations for local users
  • Pay attention to localization of dates, numbers, and other formats

Maintenance and Updates

1. Regular Checks

  • Check content synchronization status weekly
  • Identify missing or outdated translations
  • Update terminology glossary and translation guidelines

2. Version Control

  • Manage all translation changes through Git
  • Use clear commit messages
  • Create translation branches for collaboration

3. Quality Assurance

  • Establish translation review process
  • Collect user feedback
  • Continuously improve translation quality

Contribution Guidelines

How to Contribute Translations

  1. Fork the project repository
  2. Create a translation branch
  3. Translate specified content
  4. Submit a Pull Request
  5. Wait for review and merge

Translation Requirements

  • Familiar with target language and domain terminology
  • Maintain accuracy and completeness of original text
  • Follow project translation conventions
  • Respond promptly to feedback and modification suggestions

Frequently Asked Questions

Q: How to handle translation for new features?

A: When releasing new features, handle translation as follows:

  1. Complete feature documentation in Chinese version
  2. Determine translation priority
  3. Assign translation tasks
  4. Gradually complete versions in each language

Q: How to handle translation of technical terms?

A: Principles for handling technical terms:

  1. Establish a unified terminology glossary
  2. Prioritize industry-standard translations
  3. Keep English original when necessary
  4. Provide term explanations in documentation

Q: How to ensure translation quality?

A: Quality assurance measures:

  1. Establish translation review process
  2. Use automated checking tools
  3. Collect user feedback
  4. Regularly update translation guidelines

Contact and Support

If you encounter problems during translation:

Last Updated: December 2024 Document Version: 1.0.0

Was this page helpful?