ข้ามไปยังเนื้อหาหลัก

ข้อมูลอ้างอิง CLI

คำสั่ง​

i18n-rosetta init              Interactive setup wizard (--yes for quick defaults)
i18n-rosetta sync              Translate & sync all locale files
i18n-rosetta watch             Auto-sync when the source file changes
i18n-rosetta audit             List all untranslated [EN] fallback values
i18n-rosetta lint              Scan source code for hardcoded strings
i18n-rosetta wrap              Auto-wrap hardcoded strings in t() calls (with undo)
i18n-rosetta seo <sub>         Generate hreflang, sitemap.xml, or JSON-LD schema
i18n-rosetta integrity         Audit locale files for format/encoding issues
i18n-rosetta verify            Verify translations are present and correct (CI gate)
i18n-rosetta status            Show pair configuration, plugins, and quality tiers
i18n-rosetta provenance        Audit translation resource licensing
i18n-rosetta plugin <sub>      Manage method plugins (install, remove, list)
i18n-rosetta fonts <sub>       Download web fonts for PUA script converters
i18n-rosetta tm <sub>          Manage Translation Memory cache (stats, clear)
i18n-rosetta xliff <sub>       Export/import XLIFF 1.2 for professional review

รัน i18n-rosetta <command> --help เพื่อดูความช่วยเหลือโดยละเอียดสำหรับคำสั่งใดๆ

ตัวเลือกส่วนกลาง​

--help, -h              Show help (global or per-command)
--version, -v           Print version and exit
--yes, -y               Skip interactive prompts, use defaults
--config <path>         Custom config file path
--dir <path>            Override locales directory
--content-dir <path>    Hugo/Docusaurus content directory for Markdown translation
--source <code>         Override source locale (default: en)
--model <model>         Override translation model
--method <method>       Translation method: llm, google-translate (default: from config)
--format <fmt>          Locale file format: json, toml, yaml, or auto
--dry, --dry-run        Preview changes without writing files
--concurrency <n>       Max parallel API calls (sets both JSON and content, default: 48)
--json-concurrency <n>  Max parallel locale translations for JSON keys (default: 200)
--content-concurrency <n> Max parallel API calls for content translation (default: 48)
--force-content         Re-translate all content files (clears content lock)
--force-keys <keys>     Comma-separated dot-notation keys to force re-translate
--no-tm                 Skip Translation Memory cache for this sync run
--no-verify             Skip post-sync verification pass
--locale <code>         Target locale (xliff export, tm clear)
--quiet                 Errors and warnings only — suppress banner, progress bar, and info lines
--json                  Machine-readable NDJSON output — one JSON object per event

init​

วิซาร์ดการตั้งค่าแบบอินเทอร์แอกทีฟที่จะสร้าง i18n-rosetta.config.json โดยจะแนะนำคุณตลอดขั้นตอนการตั้งค่าภาษาต้นทาง, ภาษาปลายทาง, รูปแบบไฟล์ และโมเดลการแปล

i18n-rosetta init                          # interactive wizard
i18n-rosetta init --yes                    # skip wizard, use defaults
i18n-rosetta init --yes --langs fr,de,ja   # quick setup with specific languages
i18n-rosetta init --source en --dir ./i18n # overrides with defaults

ตัวเลือก --langs: รายการรหัสภาษาปลายทางที่คั่นด้วยเครื่องหมายจุลภาค (comma) ข้ามการถามภาษาและใช้พรีเซ็ตระดับภาษาเริ่มต้นสำหรับแต่ละภาษา ใช้ร่วมกับ --yes เพื่อการตั้งค่าแบบไม่อินเทอร์แอกทีฟโดยสมบูรณ์

พรีเซ็ตภาษา: เมื่อระบบถามถึงภาษาปลายทาง คุณสามารถพิมพ์ชื่อพรีเซ็ตได้:

  • european → fr, de, es, it, pt, nl
  • asian → ja, zh, ko
  • global → fr, es, de, ja, zh, ko, pt, ar
  • nordic → da, fi, nb, sv

ผสมพรีเซ็ตและรหัสภาษาแต่ละรายการ: european, ja → fr, de, es, it, pt, nl, ja

sync​

แปลคีย์ที่ขาดหายไปและคีย์ที่เก่าแล้วในไฟล์ locale ทั้งหมด โดยจะรันการตรวจสอบหลังการซิงค์ (post-sync verification) เป็นค่าเริ่มต้น

i18n-rosetta sync                                   # translate everything
i18n-rosetta sync --dry-run                         # preview only
i18n-rosetta sync --force-keys "hero.title"         # force re-translate
i18n-rosetta sync --force-keys "a.title,a.subtitle" # multiple keys
i18n-rosetta sync --force-content                   # re-translate all Markdown/MDX
i18n-rosetta sync --content-dir ./content           # include Hugo Markdown
i18n-rosetta sync --method google-translate          # force Google Translate
i18n-rosetta sync --concurrency 20                  # 20 parallel API calls (both phases)
i18n-rosetta sync --json-concurrency 30              # 30 parallel locale translations (JSON)
i18n-rosetta sync --content-concurrency 8            # 8 parallel content translations
i18n-rosetta sync --no-verify                        # skip post-sync verification
i18n-rosetta sync --no-tm                            # skip cache, fresh API calls

Translation Memory: ตามค่าเริ่มต้น sync จะโหลด .rosetta/tm.json และให้บริการคำแปลที่แคชไว้สำหรับค่าต้นทางที่ไม่เปลี่ยนแปลง ใช้ --no-tm เพื่อข้ามแคช (มีประโยชน์เมื่อเปลี่ยนผู้ให้บริการแปลภาษาหรือดีบักคุณภาพ) ดู Translation Memory

การตรวจจับการเปลี่ยนแปลง: rosetta จะจัดเก็บแฮช SHA-256 ไว้ใน .i18n-rosetta.lock เมื่อค่าต้นทางเปลี่ยนไป การซิงค์ครั้งถัดไปจะแปลคีย์เหล่านั้นใหม่โดยอัตโนมัติ โปรดคอมมิตไฟล์ lock เพื่อให้นักพัฒนาทุกคนใช้บรรทัดฐาน (baseline) เดียวกัน

การทำงานแบบขนาน (Parallelism): ทั้งการแปลคีย์ JSON และการแปลเนื้อหาจะทำงานแบบขนานกัน JSON locale จะถูกแปลพร้อมกัน (ค่าเริ่มต้น: 200 locale พร้อมกัน) โดยที่แบตช์ภายในแต่ละ locale ก็จะทำงานแบบขนานด้วย (4 แบตช์พร้อมกัน) การแปลเนื้อหา (Markdown, MDX, โพสต์บล็อก) จะทำงานในพูลรายการงานแบบแบนราบ (ค่าเริ่มต้น: การเรียก API 48 รายการพร้อมกัน) แทนที่ค่าด้วย --json-concurrency, --content-concurrency หรือ --concurrency (ตั้งค่าทั้งสองอย่าง)

เอาต์พุต: Sync จะแสดงแบนเนอร์เวอร์ชัน, การตรวจจับรูปแบบ/เฟรมเวิร์ก, การประเมินต้นทุน และแถบความคืบหน้าของแต่ละ locale:

i18n-rosetta v3.3.2

[INFO] Detected format: json (auto)
[INFO] Source: en.json (2,847 keys)
[INFO] Pairs: es-MX:llm, fr:deepl

[INFO] es-MX.json — 2,847 missing
     ████████████████████████████████ 2,847/2,847 keys
[INFO] fr.json — 2,847 missing
     ████████████████████████████████ 2,847/2,847 keys
[OK] Synced 5,694 keys total.

แถบความคืบหน้าจะอัปเดตในตำแหน่งเดิมหลังจากแต่ละแบตช์ (~80 คีย์) ใช้ --quiet สำหรับข้อผิดพลาด/คำเตือนเท่านั้น หรือ --json สำหรับเอาต์พุต NDJSON ที่เครื่องอ่านได้ ทั้งสองตัวเลือกจะซ่อนแถบความคืบหน้าและแบนเนอร์

watch​

ซิงค์อัตโนมัติเมื่อไฟล์ locale ต้นทางมีการเปลี่ยนแปลง โดยจะทำงานไปเรื่อยๆ จนกว่าจะถูกขัดจังหวะด้วย Ctrl+C

i18n-rosetta watch

audit​

แสดงรายการค่า fallback ที่ขึ้นต้นด้วย [EN] ซึ่งยังไม่ได้แปลจากการรันครั้งก่อนหน้าทั้งหมด จะออกด้วยรหัส 1 หากพบรายการใดๆ — ใช้เป็น CI gate เพื่อให้บิลด์ล้มเหลวหากมีการแปลที่ไม่สมบูรณ์

i18n-rosetta audit

verify​

อ่านไฟล์ locale ทั้งหมดจากดิสก์อีกครั้งและตรวจสอบว่ามีคำแปลอยู่จริงและถูกต้อง นี่คือการตรวจสอบเดียวกันกับที่ทำงานโดยอัตโนมัติเมื่อสิ้นสุดทุกๆ sync (เว้นแต่จะมีการส่ง --no-verify)

i18n-rosetta verify                    # verify all locale files
i18n-rosetta verify --warn-only        # non-blocking
i18n-rosetta verify && echo "All good" # CI gate

สิ่งที่ตรวจสอบ:

  • ความเท่าเทียมกันของคีย์ — คีย์ต้นทางทั้งหมดต้องมีอยู่ในแต่ละเป้าหมาย
  • เครื่องหมาย fallback [EN] จากการรันครั้งก่อนหน้า
  • คำแปลที่ว่างเปล่า
  • ความสอดคล้องของสคริปต์ — locale ที่ไม่ใช่ภาษาละตินควรมีคำแปลที่ไม่ใช่ ASCII
  • การรักษา Placeholder — ICU placeholder ต้องตรงกับต้นทาง
  • ปัญหาการเข้ารหัส — เครื่องหมาย BOM, อักขระที่มองไม่เห็น
  • การสะท้อนต้นทาง — ค่าที่เหมือนกับต้นทางทุกประการ (คำเตือน)

lint​

สแกนซอร์สโค้ดเพื่อหาสตริงที่แสดงต่อผู้ใช้ซึ่งถูกฮาร์ดโค้ดไว้และควรใช้การเรียกการแปล i18n ตรวจจับเฟรมเวิร์กของคุณโดยอัตโนมัติ (next-intl, react-i18next, vue-i18n, Hugo)

i18n-rosetta lint                    # exits 1 if issues found
i18n-rosetta lint --warn-only        # always exits 0
i18n-rosetta lint --src ./app        # custom source directory
i18n-rosetta lint --min-length 4     # minimum string length to flag

สิ่งที่ตรวจจับ:

  • สตริงที่ถูกฮาร์ดโค้ดในข้อความ JSX, placeholder, alt, aria-label, title
  • ไฟล์ที่มีเนื้อหาแสดงต่อผู้ใช้แต่ไม่มีการอิมพอร์ตเฟรมเวิร์ก i18n
  • คีย์ที่ไม่ได้ใช้งาน — คีย์ locale ที่ไม่มีซอร์สไฟล์ใดอ้างอิงถึง
  • คะแนนความครอบคลุม — เปอร์เซ็นต์ของสตริงที่ผ่าน i18n

ข้อยกเว้น: สร้าง .rosettaignore ในรูทโปรเจ็กต์ของคุณ (รูปแบบ glob เช่น .gitignore)

wrap​

ห่อหุ้มสตริงที่ถูกฮาร์ดโค้ดซึ่งตรวจพบโดย lint ให้อยู่ในการเรียก t() โดยอัตโนมัติ สร้างการสำรองข้อมูลอัตโนมัติก่อนแก้ไขไฟล์

i18n-rosetta wrap                    # auto-wrap with backup
i18n-rosetta wrap --dry              # preview wrapping changes
i18n-rosetta wrap --undo             # restore from .rosetta-backup/

ด่านความปลอดภัย:

  1. การตรวจสอบ Git-clean (ข้ามในโหมด dry-run)
  2. การสำรองข้อมูลอัตโนมัติไปยัง .rosetta-backup/
  3. การแสดงตัวอย่าง Diff ก่อนเขียนแต่ละไฟล์
  4. รองรับ --undo เพื่อกู้คืนจากการสำรองข้อมูล

seo​

สร้างอาร์ติแฟกต์ SEO สำหรับเว็บไซต์หลายภาษา

i18n-rosetta seo hreflang                                        # print hreflang tags
i18n-rosetta seo sitemap --base-url https://example.com --out sitemap.xml
i18n-rosetta seo jsonld --base-url https://example.com           # JSON-LD schema
คำสั่งย่อยเอาต์พุต
hreflangแท็ก <link rel="alternate" hreflang>
sitemapsitemap.xml หลายภาษา
jsonldสคีมาภาษา JSON-LD WebSite

integrity​

ตรวจจับความเสียหายและการเบี่ยงเบน (drift) ในไฟล์ locale ที่แปลแล้ว

i18n-rosetta integrity               # exits 1 if issues found
i18n-rosetta integrity --warn-only   # non-blocking

สิ่งที่ตรวจสอบ:

  • ความเสียหายของ Placeholder (เช่น มี {name} ในต้นทางแต่ขาดหายไปในเป้าหมาย)
  • ปัญหาการเข้ารหัส (mojibake, Unicode ที่ไม่ถูกต้อง)
  • สำเนาที่ไม่ได้แปล (ค่าเป้าหมายเหมือนกับต้นทางทุกประการ)
  • คีย์กำพร้า (คีย์ในเป้าหมายที่ไม่มีอยู่ในต้นทาง)
  • ความสมบูรณ์ของหมวดหมู่พหูพจน์ ICU MessageFormat (เช่น ภาษาอาหรับต้องการ 6 หมวดหมู่)

tm​

จัดการแคช Translation Memory (.rosetta/tm.json) TM จะจัดเก็บคำแปลก่อนหน้าและให้บริการในการซิงค์ครั้งถัดไปแทนการเรียก API

i18n-rosetta tm stats                  # show cache statistics
i18n-rosetta tm clear                  # clear cache (with confirmation)
i18n-rosetta tm clear --yes            # clear without confirmation
i18n-rosetta tm clear --locale fr      # clear only French entries
คำสั่งย่อยเอาต์พุต
statsจำนวนรายการ, ขนาดไฟล์, การแจกแจงตามแต่ละ locale
clearลบไฟล์แคช (ทั้งหมดหรือตามแต่ละ locale)
ตัวเลือกผลลัพธ์
--locale <code>ล้างเฉพาะรายการสำหรับหนึ่ง locale
--yesข้ามการถามเพื่อยืนยัน

ดู Translation Memory สำหรับวิธีการทำงานของ TM และเวลาที่ควรล้างแคช

xliff​

ส่งออกและนำเข้าไฟล์ XLIFF 1.2 สำหรับการตรวจสอบโดยนักแปลมืออาชีพ XLIFF เป็นรูปแบบการแลกเปลี่ยนสากลที่รองรับโดยเครื่องมือ CAT เช่น memoQ, SDL Trados และ Phrase

i18n-rosetta xliff export --locale fr                   # export French XLIFF
i18n-rosetta xliff export --locale ja --out ./review/   # custom output path
i18n-rosetta xliff import .rosetta/xliff/fr.xliff       # import reviewed file
i18n-rosetta xliff import ./reviewed.xliff --dry        # preview import
คำสั่งย่อยเอาต์พุต
exportสร้าง .xliff จากไฟล์ locale ต้นทาง + เป้าหมาย
importผสานคำแปล .xliff ที่ตรวจสอบแล้วลงในไฟล์ locale
ตัวเลือกผลลัพธ์
--locale <code>locale เป้าหมายสำหรับการส่งออก (จำเป็น)
--out <path>พาธหรือไดเรกทอรีเอาต์พุตแบบกำหนดเอง
--dryแสดงตัวอย่างการนำเข้าโดยไม่เขียนไฟล์

ดู Working with Professional Translators สำหรับเวิร์กโฟลว์ฉบับเต็ม

status​

แสดงการกำหนดค่าคู่ภาษา, ปลั๊กอินที่ติดตั้ง, ระดับคุณภาพ และคะแนนเบนช์มาร์ก

i18n-rosetta status

provenance​

ตรวจสอบไลเซนส์ทรัพยากรการแปลสำหรับปลั๊กอินที่ติดตั้งทั้งหมด

i18n-rosetta provenance

plugin​

จัดการปลั๊กอินวิธีการแปล ปลั๊กอินคือสูตรการแปลที่แพ็กเกจไว้ล่วงหน้าซึ่งติดตั้งไว้ที่ .rosetta/methods/

i18n-rosetta plugin list                      # show installed plugins
i18n-rosetta plugin install ./my-method/      # install from local directory
i18n-rosetta plugin remove crk-coached-v1     # remove a plugin

ดู Plugin Specification สำหรับรูปแบบ manifest ของปลั๊กอิน

fonts​

ดาวน์โหลดและจัดการเว็บฟอนต์ PUA สำหรับตัวแปลงสคริปต์ภาษาประดิษฐ์ (constructed language) ภาษาที่ใช้อักขระ Private Use Area (Klingon, Sindarin, Kryptonian) จำเป็นต้องใช้เว็บฟอนต์แบบกำหนดเองเพื่อเรนเดอร์สคริปต์ คำสั่งนี้จะดาวน์โหลดฟอนต์จากพื้นที่เก็บข้อมูลโอเพนซอร์สที่ผ่านการตรวจสอบแล้ว

i18n-rosetta fonts list                           # show needed fonts
i18n-rosetta fonts install                        # download all needed fonts
i18n-rosetta fonts install --css                  # also generate CSS snippet
i18n-rosetta fonts install --dir ./public/fonts   # custom output directory
คำสั่งย่อยเอาต์พุต
listแสดงว่าจำเป็นต้องใช้ฟอนต์ PUA ใดบ้างและสถานะการติดตั้ง
installดาวน์โหลดฟอนต์สำหรับภาษาที่กำหนดค่าไว้
ตัวเลือกผลลัพธ์
--dir <path>แทนที่ไดเรกทอรีเอาต์พุตของฟอนต์ (ตรวจจับอัตโนมัติจากประเภทโปรเจ็กต์)
--cssสร้างสนิปเปต conlang-fonts.css ควบคู่ไปกับฟอนต์
--config <path>พาธไปยังไฟล์คอนฟิก (ใช้เพื่อตรวจจับว่าภาษาใดต้องการฟอนต์)

การตรวจจับอัตโนมัติ: ไดเรกทอรีเอาต์พุตจะถูกอนุมานจากโครงสร้างโปรเจ็กต์ของคุณ:

  • Docusaurus → static/fonts/ หรือ website/static/fonts/
  • Hugo → static/fonts/
  • ค่าเริ่มต้น → public/fonts/

ตัวแปลง Unicode แบบเนทีฟ (crk → Cree Syllabics, sr → Serbian Cyrillic) ไม่จำเป็นต้องติดตั้งฟอนต์

ดู Conlangs, Scripts & Orthography สำหรับรายละเอียดฟอนต์ PUA ฉบับเต็ม

ไปป์ไลน์แบบสามชั้น​

ใช้ lint, sync และ audit ร่วมกันเพื่อ i18n ที่ไร้ช่องโหว่:

package.json
{
  "scripts": {
    "i18n:lint": "i18n-rosetta lint",
    "i18n:sync": "i18n-rosetta sync",
    "i18n:audit": "i18n-rosetta audit"
  }
}
ชั้น (Layer)คำสั่งเมื่อใดวัตถุประสงค์
Lintlintก่อนคอมมิต (Pre-commit)บล็อกการคอมมิตที่มีสตริงแบบฮาร์ดโค้ด
Syncsyncหลังคอมมิต (Post-commit) / CIแปลคีย์ที่ขาดหายไปและคีย์ที่เปลี่ยนแปลง
Verifyverifyหลังซิงค์ (Post-sync) / CIยืนยันว่ามีคำแปลอยู่จริงและถูกต้อง
Auditauditขั้นตอนบิลด์ (Build step)ให้การปรับใช้ล้มเหลวหาก locale ใดๆ มีเครื่องหมาย [EN]

ดูเพิ่มเติม​

  • Configuration — ข้อมูลอ้างอิงไฟล์คอนฟิก
  • Translation Methods — การเลือกวิธีการสำหรับแต่ละคู่ภาษา
  • Translation Memory — การแคชและการประหยัดต้นทุน
  • Working with Professional Translators — เวิร์กโฟลว์ XLIFF
  • Plugin Specification — รูปแบบ manifest ของปลั๊กอิน
  • CI/CD Guide — การทำให้คำสั่ง CLI เป็นอัตโนมัติในไปป์ไลน์ของคุณ
  • How Sync Works — ทำความเข้าใจไปป์ไลน์การซิงค์
  • Quality Gate — วิธีการตรวจสอบความถูกต้องของคำแปล