التثبيت
المتطلبات
- Node.js 20.11+ (ESM أصلي)
- مفتاح API للترجمة (انظر أدناه)
التثبيت
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev champollion
npx champollion sync
pnpm add -D champollion
yarn add --dev champollion
الحصول على مفتاح API
يحتاج Champollion إلى خدمة ترجمة خلفية. اختر واحدة:
| المزوّد | متغير البيئة | الأنسب لـ |
|---|---|---|
| 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 | أزواج المفاتيح والقيم بكميات كبيرة، أكثر من 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، والمشاريع التي تحتاج إلى حماية واعية بالمحتوى (كتل التعليمات البرمجية، والرموز المختصرة، ومتغيرات الاستيفاء).
export GOOGLE_TRANSLATE_API_KEY=...
الأنسب لـ: أزواج المفاتيح والقيم النصية بكميات كبيرة (أكثر من 130 لغة). غير موصى به لمحتوى Markdown — فخدمة Google Translate ليس لديها أي وعي بكتل التعليمات البرمجية أو الرموز المختصرة أو متغيرات الاستيفاء.
:::tip اكتشاف ذكي
إذا تم تعيين GOOGLE_TRANSLATE_API_KEY فقط (دون مفتاح OpenRouter)، يتحول champollion تلقائياً إلى Google Translate. لا حاجة لتغيير الإعدادات.
:::
التحقق من التثبيت
npx champollion --help
ينبغي أن ترى قائمة الأوامر المتاحة. أنت الآن جاهز لـالبدء السريع.