Hướng dẫn Đa ngôn ngữ

Cấu hình OpenSpec để tạo ra các tài liệu (artifacts) bằng các ngôn ngữ khác tiếng Anh.

Thiết lập nhanh

Đối với dự án mới, hãy đặt ngôn ngữ trong quá trình khởi tạo:

openspec init --language "Tiếng Bồ Đào Nha (pt-BR)"

Lệnh này sẽ ghi hướng dẫn về ngôn ngữ vào openspec/config.yaml. Nếu dự án đã có cấu hình, hãy chỉnh sửa trực tiếp trường context của nó để giữ nguyên các hướng dẫn hiện có của dự án.

Bạn cũng có thể cấu hình hành vi tương tự một cách thủ công:

Thêm hướng dẫn về ngôn ngữ vào openspec/config.yaml của bạn:

schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.
  Keep OpenSpec structural headings and SHALL/MUST keywords in English.

  # Your other project context below...
  Tech stack: TypeScript, React, Node.js

Đó là tất cả. Tất cả các tài liệu được tạo ra bây giờ sẽ bằng tiếng Bồ Đào Nha.

Cấu trúc tài liệu và các từ khóa chuẩn SHALL/MUST của OpenSpec vẫn giữ nguyên tiếng Anh vì việc xác thực phụ thuộc vào chúng. Phần văn bản mô tả yêu cầu và kịch bản xung quanh có thể sử dụng ngôn ngữ bạn đã chọn.

Ví dụ về ngôn ngữ

Tiếng Bồ Đào Nha (Brazil)

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

Tiếng Tây Ban Nha

context: |
  Idioma: Español
  Todos los artefactos deben escribirse en español.

Tiếng Trung (Giản thể)

context: |
  语言：中文（简体）
  所有产出物必须用简体中文撰写。

Tiếng Nhật

context: |
  言語：日本語
  すべての成果物は日本語で作成してください。

Tiếng Pháp

context: |
  Langue : Français
  Tous les artefacts doivent être rédigés en français.

Tiếng Đức

context: |
  Sprache: Deutsch
  Alle Artefakte müssen auf Deutsch verfasst werden.

Mẹo

Xử lý thuật ngữ kỹ thuật

Quyết định cách xử lý thuật ngữ chuyên ngành:

context: |
  Language: Japanese
  Write in Japanese, but:
  - Keep technical terms like "API", "REST", "GraphQL" in English
  - Code examples and file paths remain in English

Kết hợp với ngữ cảnh khác

Cài đặt ngôn ngữ hoạt động cùng với các ngữ cảnh dự án khác của bạn:

schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

  Tech stack: TypeScript, React 18, Node.js 20
  Database: PostgreSQL with Prisma ORM

Xác minh

Để xác minh cấu hình ngôn ngữ của bạn đang hoạt động:

# Kiểm tra các hướng dẫn - sẽ hiển thị ngữ cảnh ngôn ngữ của bạn
openspec instructions proposal --change my-change

# Đầu ra sẽ bao gồm ngữ cảnh ngôn ngữ của bạn

Tài liệu liên quan

• Hướng dẫn tùy chỉnh - Các tùy chọn cấu hình dự án
• Hướng dẫn quy trình làm việc - Tài liệu đầy đủ về quy trình làm việc