CLI حوالہ¶

Co-op Translator درج ذیل کمانڈ لائن اینٹری پوائنٹس نصب کرتا ہے:

translate
evaluate
migrate-links
co-op-review
co-op-translator-mcp

translate, evaluate, migrate-links, اور co-op-review کمانڈز co_op_translator.__main__ کے ذریعے بھیجی جاتی ہیں، جو بلائے گئے اسکرپٹ کے نام کی بنیاد پر کمانڈ کا اطلاق منتخب کرتی ہے۔ MCP سرور براہِ راست co_op_translator.mcp.server استعمال کرتا ہے۔

اگر آپ CLI، Python API، اور MCP کے درمیان فیصلہ کر رہے ہیں تو اپنا ورک فلو منتخب کریں سے شروع کریں۔

کنسول آؤٹ پٹ¶

انٹرایکٹو ٹرمینلز کمانڈ ہیڈر، پروگریس، اور خلاصوں کے لیے Rich فارمیٹنگ استعمال کرتے ہیں۔ CI اور غیر-انٹرایکٹو آؤٹ پٹ خود بخود سادہ متن پر واپس چلے جاتے ہیں۔

سادہ آؤٹ پٹ زبردستی کرنے کے لیے CO_OP_TRANSLATOR_OUTPUT_STYLE=plain سیٹ کریں، یا Rich آؤٹ پٹ کے لیے CO_OP_TRANSLATOR_OUTPUT_STYLE=rich سیٹ کریں۔ زندہ پروگریس بارز کو دبا کر خلاصے برقرار رکھنے کے لیے CO_OP_TRANSLATOR_NO_PROGRESS=1 سیٹ کریں۔

جب کسی اور سسٹم کو ضرورت ہو تو translate --json-events progress.ndjson استعمال کریں مشین-قابلِ خواندگی پروگریس کے لیے۔ CLI انسانی-مخاطب آؤٹ پٹ دکھانا جاری رکھتا ہے، جبکہ NDJSON فائل ورژن شدہ co-op.translation.event.v1 ایونٹس وصول کرتی ہے جن میں مستحکم فیلڈز جیسے type, stage_key, completed, total, اور current_path.

پہلی بار CLI کا بہاؤ¶

اگر آپ ٹرمینل سے Co-op Translator استعمال کر رہے ہیں تو یہاں سے شروع کریں:

ایک LLM فراہم کنندہ ترتیب دیں جیسا کہ کنفیگریشن میں بیان ہے۔
وہ مواد منتخب کریں جسے آپ ترجمہ کرنا چاہتے ہیں۔
پہلے ایک مخصوص کمانڈ چلائیں، مثلاً صرف Markdown کا ترجمہ۔
بڑے ریپوزٹری تبدیلیوں سے پہلے --dry-run استعمال کریں۔
ساخت اور تازہ کاری چیک کرنے کے لیے ترجمہ کے بعد co-op-review استعمال کریں۔

مقصد	شروع کرنے کے لیے کمانڈ
Markdown دستاویزات کا ترجمہ کریں	`translate -l "ko" -md`
نوٹ بکس کا ترجمہ کریں	`translate -l "ko" -nb`
تصاویر کے متن کا ترجمہ کریں	`translate -l "ko" -img`
فائلیں لکھے بغیر پیش نظارہ کریں	`translate -l "ko" -md --dry-run`
موجودہ تراجم کا جائزہ لیں	`co-op-review -l "ko"`
نوٹ بکس اور Markdown لنکس کو اپ ڈیٹ کریں	`migrate-links -l "ko" --dry-run`
اوزار کو MCP کلائنٹ کے لیے دستیاب کریں	CLI کمانڈز براہِ راست چلانے کی بجائے MCP Server کو ترتیب دیں۔

translate¶

Markdown فائلیں، نوٹ بکس، اور تصویری متن ایک یا زیادہ ہدف زبانوں میں ترجمہ کریں۔

translate -l "ko ja fr"

عام مثالیں¶

صرف Markdown کا ترجمہ کریں:

translate -l "de" -md

صرف نوٹ بکس کا ترجمہ کریں:

translate -l "zh-CN" -nb

Markdown اور تصاویر کا ترجمہ کریں:

translate -l "pt-BR" -md -img

موجودہ تراجم کو حذف کر کے دوبارہ بنا کر اپ ڈیٹ کریں:

translate -l "ko" -u

انٹرایکٹو پرامپٹس کے بغیر چلائیں:

translate -l "ko ja" -md -y

لاگز محفوظ کریں:

translate -l "ko" -s

منظم شدہ پروگریس ایونٹس لکھیں:

translate -l "ko ja" -md --json-events progress.ndjson

اختیارات¶

آپشن	ضروری	وضاحت
`-l`, `--language-codes`	ہاں	اسپیس سے جدا زبانوں کے کوڈز، مثلاً `"es fr de"`، یا `"all"`۔
`-r`, `--root-dir`	نہیں	پروجیکٹ روٹ۔ ڈیفالٹ موجودہ ڈائریکٹری ہے۔
`-u`, `--update`	نہیں	منتخب زبانوں کے لیے موجودہ تراجم حذف کریں اور دوبارہ بنائیں۔
`-img`, `--images`	نہیں	صرف تصویری فائلوں کا ترجمہ کریں۔
`-md`, `--markdown`	نہیں	صرف Markdown فائلوں کا ترجمہ کریں۔
`-nb`, `--notebook`	نہیں	صرف Jupyter نوٹ بک فائلوں کا ترجمہ کریں۔
`-d`, `--debug`	نہیں	کنسول میں ڈیبگ لاگنگ فعال کریں۔
`-s`, `--save-logs`	نہیں	DEBUG سطح کے لاگز `<root-dir>/logs/` کے تحت محفوظ کریں۔
`--json-events`	نہیں	ترجمے کی پیشرفت کو NDJSON کے طور پر مشین-قابلِ خواندگی ایونٹس لکھیں۔
`-x`, `--fix`	نہیں	سابقہ تشخیصی نتائج کی بنیاد پر کم اعتماد والے Markdown فائلوں کا دوبارہ ترجمہ کریں۔
`-c`, `--min-confidence`	نہیں	`--fix` کے لیے اعتماد کی حد۔ ڈیفالٹ `0.7` ہے۔
`--add-disclaimer`, `--no-disclaimer`	نہیں	مشینی ترجمے کے ڈس کلیمرز شامل کریں یا دبا دیں۔ CLI میں ڈیفالٹ طور پر فعال ہیں۔
`-f`, `--fast`	نہیں	متروک تیز تصویر موڈ۔
`-y`, `--yes`	نہیں	پرامپٹس کو خود بخود تصدیق کریں، CI میں مفید۔
`--repo-url`	نہیں	README زبانوں کی جدول میں sparse-checkout کے مشورے کے لیے استعمال ہونے والا ریپوزٹری URL۔
`--migrate-language-folders`	نہیں	پرانے عرفی فولڈرز جیسے `cn` یا `tw` کو معیاری BCP 47 فولڈرز میں دوبارہ نام دیں۔
`--dry-run`	نہیں	فائلیں لکھے بغیر زبان فولڈر مائگریشن اور ترجمے کے اندازے کا پیش نظارہ کریں۔

اگر کوئی ٹائپ فلیگ فراہم نہ کیا جائے تو translate Markdown، نوٹ بکس، اور تصاویر کو پراسیس کرے گا۔ تصویری ترجمے کے لیے Azure AI Vision کی ترتیب درکار ہے۔

evaluate¶

کسی ایک زبان کے لیے ترجمہ شدہ Markdown کے معیار کا جائزہ لیں۔

تجرباتی

evaluate تجرباتی ہے۔ یہ قاعدہ-بنیاد اور LLM-بنیاد معیار کی جانچیں استعمال کر سکتا ہے، تشخیصی نتائج ترجمے کے میٹاڈیٹا میں لکھتا ہے، اور اس کا اسکورنگ ماڈل اور میٹاڈیٹا کا برتاؤ بدل سکتا ہے۔

evaluate -l "ko"

عام مثالیں¶

کم اعتماد کے لیے سخت تر ہدف استعمال کریں:

evaluate -l "es" -c 0.8

صرف قاعدہ-بنیاد چیکس چلائیں:

evaluate -l "fr" -f

صرف LLM-بنیاد چیکس چلائیں:

evaluate -l "ja" -D

اختیارات¶

آپشن	ضروری	وضاحت
`-l`, `--language-code`	ہاں	جائزہ لینے کے لیے ایک زبان کا کوڈ۔ عرفی کوڈز معمول پر لائے جاتے ہیں۔
`-r`, `--root-dir`	نہیں	پروجیکٹ روٹ۔ ڈیفالٹ موجودہ ڈائریکٹری ہے۔
`-c`, `--min-confidence`	نہیں	کم اعتماد تراجم کی فہرست بناتے وقت استعمال ہونے والی حد۔ ڈیفالٹ `0.7` ہے۔
`-d`, `--debug`	نہیں	ڈیبگ لاگنگ فعال کریں۔
`-s`, `--save-logs`	نہیں	DEBUG سطح کے لاگز `<root-dir>/logs/` کے تحت محفوظ کریں۔
`-f`, `--fast`	نہیں	صرف قاعدہ-بنیاد جائزہ۔
`-D`, `--deep`	نہیں	صرف LLM-بنیاد جائزہ۔

ڈیفالٹ کے طور پر، evaluate دونوں قاعدہ-بنیاد اور LLM-بنیاد جائزے استعمال کرتا ہے۔ نتائج ترجمے کے میٹاڈیٹا میں لکھے جاتے ہیں اور کنسول میں خلاصہ کیے جاتے ہیں۔

co-op-review¶

بغیر API اسناد کے قطعی (deterministic) ترجمہ دیکھ بھال کے چیکس چلائیں۔

بیٹا

co-op-review ایک بیٹا قطعی جائزہ کمانڈ ہے۔ یہ ماڈل فراہم کنندگان کو کال نہیں کرتا اور فائلیں نہیں لکھتا، مگر اس کے چیکس اور مسئلہ آؤٹ پٹ اسکیمہ تبدیل ہو سکتے ہیں۔

co-op-review -l "ko"

عام مثالیں¶

موجودہ ڈائریکٹری سے کوریائی اور جاپانی تراجم کا جائزہ لیں:

co-op-review -l "ko ja"

کسی مخصوص پروجیکٹ روٹ کا جائزہ لیں:

co-op-review -l "fr" -r ./my-course

صرف README-کے ترجمے کے بعد صرف README کا جائزہ لیں:

translate -l "ko" --readme-only -y
co-op-review -l "ko" --readme-only --format github

--readme-only دوسرے دستاویزات اور اندرونی READMEs کو نظر انداز کرتا ہے۔ یہ ناکام ہو جاتا ہے اگر روٹ README.md غائب ہو۔ --changed-from کے ساتھ ملا کر، یہ صرف اس وقت README کا جائزہ لیتا ہے جب اس ماخذ فائل میں تبدیلی ہوئی ہو۔ README-only ترجمہ ماخذ README کو بغیر تبدیل کیے چھوڑتا ہے، بشمول کسی بھی مشترکہ سیکشن مارکرز کے۔

صرف وہ ماخذ فائلیں جائزہ لیں جو ایک بیس ریف کے خلاف تبدیل ہوئی ہوں:

co-op-review -l "ko" --changed-from origin/main

CI خلاصوں کے لیے GitHub-flavored Markdown آؤٹ پٹ پرنٹ کریں:

co-op-review -l "ko ja" --changed-from origin/main --format github

اختیارات¶

آپشن	ضروری	وضاحت
`-l`, `--language-code`	نہیں	جائزہ کے لیے زبان کا کوڈ۔ اسے متعدد بار یا اسپیس سے جدا قیمت کے طور پر دیا جا سکتا ہے۔ ڈیفالٹ طور پر تمام دریافت شدہ ترجمہ زبانیں۔
`-r`, `--root-dir`	نہیں	پروجیکٹ روٹ۔ ڈیفالٹ موجودہ ڈائریکٹری ہے۔
`--changed-from`	نہیں	جائزہ کو صرف تبدیل شدہ ماخذ فائلوں تک محدود کرنے کے لیے استعمال ہونے والا Git ریف۔
`--readme-only`	نہیں	صرف روٹ `README.md` کے ترجمہ کا جائزہ لیں۔
`--format`	نہیں	آؤٹ پٹ فارمیٹ: `text` یا `github`۔ ڈیفالٹ `text` ہے۔

co-op-review فی الحال غائب ترجمہ شدہ فائلیں، غائب یا باسی ترجمہ میٹاڈیٹا، Markdown فرنٹ میٹر اور کوڈ فینس کی سالمیت، نامعتبر ترجمہ شدہ نوٹ بک JSON، اور مقامی Markdown یا تصویری لنک ٹارگٹس کی غائبگی کو چیک کرتا ہے۔ غائب لنکس ڈیفالٹ طور پر وارننگ ہیں؛ ساختی اور تازگی کے مسائل کمانڈ کو ناکام بنا دیتے ہیں۔

co-op-translator-mcp¶

ایجنٹس، ایڈیٹرز، اور MCP-مطابق کلائنٹس کے لیے Co-op Translator MCP سرور چلائیں۔

co-op-translator-mcp

ڈیفالٹ ٹرانسپورٹ stdio ہے۔ کلائنٹ کنفیگریشن، اوزار، وسائل، اور حفاظتی نوٹس کے لیے MCP Server گائیڈ دیکھیں۔

اختیارات¶

آپشن	ضروری	وضاحت
`--transport`	نہیں	MCP ٹرانسپورٹ: `stdio`, `streamable-http`, یا `sse`۔ ڈیفالٹ `stdio` ہے۔

migrate-links¶

ترجمہ شدہ Markdown فائلوں کو دوبارہ پراسیس کریں اور نوٹ بک لنکس کو اپ ڈیٹ کریں تاکہ جب دستیاب ہوں تو وہ ترجمہ شدہ نوٹ بکس کی طرف اشارہ کریں۔

migrate-links -l "ko ja"

عام مثالیں¶

لنک اپ ڈیٹس کا پیش نظارہ کریں:

migrate-links -l "ko" --dry-run

تصدیق کے بغیر تمام معاون زبانوں کو پراسیس کریں:

migrate-links -l "all" -y

صرف تب لنکس دوبارہ لکھیں جب ترجمہ شدہ نوٹ بکس موجود ہوں:

migrate-links -l "ko" --no-fallback-to-original

اختیارات¶

آپشن	ضروری	وضاحت
`-l`, `--language-codes`	ہاں	اسپیس سے جدا زبانوں کے کوڈز، یا `"all"`۔
`-r`, `--root-dir`	نہیں	پروجیکٹ روٹ۔ ڈیفالٹ موجودہ ڈائریکٹری ہے۔
`--image-dir`	نہیں	روٹ کے مقابلے میں ترجمہ شدہ تصاویر ڈائریکٹری۔ ڈیفالٹ `translated_images` ہے۔
`--dry-run`	نہیں	وہ فائلیں دکھائیں جو بدلیں گی بغیر اپ ڈیٹس لکھے۔
`--fallback-to-original`, `--no-fallback-to-original`	نہیں	جب ترجمہ شدہ نوٹ بکس غائب ہوں تو اصل نوٹ بک لنکس استعمال کریں۔ ڈیفالٹ طور پر فعال۔
`-d`, `--debug`	نہیں	ڈیبگ لاگنگ فعال کریں۔
`-s`, `--save-logs`	نہیں	DEBUG سطح کے لاگز `<root-dir>/logs/` کے تحت محفوظ کریں۔
`-y`, `--yes`	نہیں	جب تمام زبانوں کو پراسیس کر رہے ہوں تو پرامپٹس خود بخود تصدیق کریں۔

ماحول¶

جب کسی کمانڈ کو فراہم کنندہ کی اسناد کی ضرورت ہو، تو ان میں سے کسی ایک فراہم کنندہ سیٹ کو ترتیب دیں۔ translate --dry-run اور co-op-review کو فراہم کنندہ کی اسناد درکار نہیں ہیں:

# ایژور اوپن اے آئی
AZURE_OPENAI_API_KEY="..."
AZURE_OPENAI_ENDPOINT="https://<resource>.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME="gpt-4o"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="<deployment>"
AZURE_OPENAI_API_VERSION="2024-12-01-preview"

# یا اوپن اے آئی
OPENAI_API_KEY="..."
OPENAI_CHAT_MODEL_ID="gpt-4o"

# یا انتھروپک
ANTHROPIC_API_KEY="..."
ANTHROPIC_MODEL="claude-..."

تصویری ترجمے کے لیے اضافی طور پر Azure AI Vision درکار ہے:

AZURE_AI_SERVICE_API_KEY="..."
AZURE_AI_SERVICE_ENDPOINT="https://<resource>.cognitiveservices.azure.com/"

آؤٹ پٹ لے آؤٹ¶

متنی تراجم درج ذیل میں لکھے جاتے ہیں:

translations/<language-code>/<original-path>

ترجمہ شدہ تصویری آؤٹ پٹ درج ذیل میں لکھا جاتا ہے:

translated_images/<language-code>/<original-path>

مثال کے طور پر، README.md اور docs/setup.md کو کورین میں ترجمہ کرنے سے یہ پیدا ہوتا ہے:

translations/ko/README.md
translations/ko/docs/setup.md

کاپی-پیسٹ CLI مثالیں¶

Markdown کو تین زبانوں میں ترجمہ کریں:

translate -l "ko ja fr" -md

صرف نوٹ بکس کا ترجمہ کریں:

translate -l "zh-CN" -nb

صرف تصاویر کا ترجمہ کریں:

translate -l "pt-BR" -img

فائلیں لکھے بغیر Markdown ترجمے کا پیش نظارہ کریں:

translate -l "de es" -md --dry-run

کم اعتماد والے Markdown تراجم کی مرمت کریں:

evaluate -l "ko" -c 0.8
translate -l "ko" --fix -c 0.8 -md

CI-دوست Markdown ترجمہ چلائیں:

translate -l "ko ja" -md -y -s

ترجمہ شدہ آؤٹ پٹ کا جائزہ لیں:

co-op-review -l "ko ja"

لنک مائگریشن کا پیش نظارہ کریں:

migrate-links -l "ko" --dry-run