التثبيت
المتطلبات
- Node.js 20.11+ (ESM أصلي)
- مفتاح API للترجمة (انظر أدناه)
التثبيت
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev i18n-rosetta
npx i18n-rosetta sync
pnpm add -D i18n-rosetta
yarn add --dev i18n-rosetta
الحصول على مفتاح API
يحتاج Rosetta إلى واجهة خلفية للترجمة. اختر واحدة:
| المزود | متغير البيئة | الأفضل لـ |
|---|---|---|
| OpenRouter (موصى به) | OPENROUTER_API_KEY | المشاريع المليئة بالمحتوى، Markdown، أكثر من 200 نموذج |
| Gemini (باقة مجانية) | GEMINI_API_KEY | بداية بدون تكلفة، جودة جيدة |
| OpenAI | OPENAI_API_KEY | وصول مباشر إلى GPT-4o |
| Anthropic | ANTHROPIC_API_KEY | وصول مباشر إلى Claude، نصوص دقيقة |
| DeepL | DEEPL_API_KEY | اللغات الأوروبية، صيغة رسمية مدمجة |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | أزواج المفتاح والقيمة (key-value) بحجم كبير، أكثر من 130 لغة |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure، أكثر من 100 لغة |
| LibreTranslate | LIBRETRANSLATE_API_URL | استضافة ذاتية، الأولوية للخصوصية |
- OpenRouter (recommended)
- Google Translate
يوفر OpenRouter واجهة برمجة تطبيقات (API) موحدة لأكثر من 200 نموذج LLM. تتوفر باقة مجانية.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
أو أضفه إلى .env.local:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
الأفضل لـ: المشاريع المليئة بالمحتوى، وترجمة Markdown، والمشاريع التي تحتاج إلى حماية مدركة للمحتوى (كتل الأكواد، الأكواد القصيرة (shortcodes)، متغيرات الاستيفاء (interpolation variables)).
export GOOGLE_TRANSLATE_API_KEY=...
الأفضل لـ: أزواج المفتاح والقيمة (key-value) النصية بحجم كبير (أكثر من 130 لغة). غير موصى به لمحتوى Markdown — حيث أن Google Translate ليس لديه إدراك بكتل الأكواد، أو الأكواد القصيرة (shortcodes)، أو متغيرات الاستيفاء (interpolation variables).
:::tip اكتشاف ذكي
إذا تم تعيين GOOGLE_TRANSLATE_API_KEY فقط (بدون مفتاح OpenRouter)، سيقوم rosetta بالتبديل تلقائيًا إلى Google Translate. لا حاجة لتغيير الإعدادات.
:::
التحقق من التثبيت
npx i18n-rosetta --help
يجب أن ترى قائمة بالأوامر المتاحة. أنت الآن جاهز لـ البدء السريع.