คู่มือหลายภาษา

กำหนดค่า OpenSpec เพื่อสร้างอาร์ติแฟกต์ในภาษาอื่นที่ไม่ใช่ภาษาอังกฤษ

การตั้งค่าอย่างรวดเร็ว

สำหรับโปรเจกต์ใหม่ ให้ตั้งค่าภาษาในช่วงเริ่มต้น:

openspec init --language "Portuguese (pt-BR)"

คำสั่งนี้จะเขียนคำแนะนำเกี่ยวกับภาษาไปยังไฟล์ openspec/config.yaml หากโปรเจกต์มีไฟล์การตั้งค่าอยู่แล้ว ให้แก้ไขฟิลด์ context โดยตรงเพื่อให้คงคำแนะนำเดิมของโปรเจกต์ไว้

คุณสามารถกำหนดค่าพฤติกรรมเดียวกันนี้ได้ด้วยตนเอง:

เพิ่มคำแนะนำเกี่ยวกับภาษาลงในไฟล์ openspec/config.yaml:

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

เพียงเท่านี้ อาร์ติแฟกต์ที่สร้างขึ้นทั้งหมดจะอยู่ในภาษาโปรตุเกส

โครงสร้างเอกสารและคำสำคัญเชิงบังคับ SHALL/MUST ของ OpenSpec ยังคงเป็นภาษาอังกฤษเนื่องจากกระบวนการตรวจสอบอาศัยสิ่งเหล่านี้ ส่วนข้อความอธิบายข้อกำหนดและสถานการณ์สามารถเลือกใช้ภาษาที่คุณกำหนดได้

ตัวอย่างภาษา

โปรตุเกส (บราซิล)

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

สเปน

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

จีน (ตัวย่อ)

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

ญี่ปุ่น

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

ฝรั่งเศส

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

เยอรมัน

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

เคล็ดลับ

จัดการกับศัพท์เทคนิค

ตัดสินใจเกี่ยวกับการจัดการศัพท์ทางเทคนิค:

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

ผสมผสานกับบริบทอื่นๆ

การตั้งค่าภาษาทำงานร่วมกับบริบทโปรเจกต์อื่นๆ ของคุณ:

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

การตรวจสอบ

เพื่อตรวจสอบว่าการตั้งค่าภาษาของคุณทำงานถูกต้อง:

# ตรวจสอบคำแนะนำ - ควรแสดงบริบทภาษาของคุณ
openspec instructions proposal --change my-change

# ผลลัพธ์จะรวมบริบทภาษาของคุณไว้ด้วย

เอกสารที่เกี่ยวข้อง

• คู่มือการปรับแต่ง - ตัวเลือกการกำหนดค่าโปรเจกต์
• คู่มือเวิร์กโฟลว์ - เอกสารประกอบเวิร์กโฟลว์แบบครบถ้วน