اجرای سورس کدپروژه مترجم

---

شرح پروژه

  فریلنسر باید دقیقاً این مراحل را دنبال کند. --- ### **عنوان پروژه** **اجرای و تست پروژه مترجم آفلاین انگلیسی به فارسی** --- ### **🔍 هدف پروژه** فریلنسر باید: 1. پروژه را روی سیستم خود نصب و اجرا کند. 2. فایل‌های متنی انگلیسی ارائه‌شده توسط شما را ترجمه آفلاین کند. 3. خروجی ترجمه‌شده را به‌صورت فایل‌های متنی فارسی تحویل دهد. 4. گزارش عملکرد و تست را ارائه دهد. --- ### **📂 نیازمندی‌های سخت‌افزاری و نرم‌افزاری** #### **حداقل سخت‌افزاری** - سیستم‌عامل: **Windows 10/11** (ضروری) - رم: **حداقل ۴GB** (۸GB توصیه می‌شود) - فضای دیسک: **حداقل ۵GB** (برای نصب پایتون، کتابخانه‌ها و مدل ترجمه) - اتصال به اینترنت **فقط برای بارگیری اولیه کتابخانه‌ها و مدل** (پس از نصب، اینترنت نیاز نیست). #### **نرم‌افزاری** 1. **Python 3.8 یا بالاتر** - لینک دانلود: [python.org](https://www.python.org/downloads/) - **حین نصب حتماً گزینه `Add Python to PATH` را تیک بزنید.** 2. **Git** (اختیاری - برای کلون کردن ریپوزیتوری) - لینک دانلود: [git-scm.com](https://git-scm.com/) --- ### **📦 مراحل اجرای پروژه** --- #### **مرحله ۱: دریافت کد پروژه** فریلنسر باید کد پروژه را دریافت کند. دو روش وجود دارد: **روش الف) کلون کردن از GitHub (ترجیحی)** ```bash git clone https://github.com/[نام-ریپوزیتوری-شما]/offline-translator.git cd offline-translator ``` **روش ب) دانلود ZIP** 1. به ریپوزیتوری گیت‌هاب پروژه بروید. 2. روی `Code` → `Download ZIP` کلیک کنید. 3. فایل ZIP را استخراج کنید. > 📌 **توجه:** اگر ریپوزیتوری خصوصی است، دسترسی را به فریلنسر بدهید. --- #### **مرحله ۲: نصب وابستگی‌ها** در پوشه پروژه، **ترمینال (Command Prompt)** را باز کنید و دستور زیر را اجرا کنید: ```bash pip install -r requirements.txt ``` > ✅ این دستور تمام کتابخانه‌های مورد نیاز (PyTorch, Transformers, ...) را نصب می‌کند. > ⏳ این فرآیند ممکن است ۱۰-۲۰ دقیقه طول بکشد و **اینترنت نیاز دارد**. #### **مرحله ۳: بارگیری مدل ترجمه (فقط یکبار نیاز است)** وقتی برنامه را برای اولین بار اجرا می‌کنید، **مدل ترجمه به‌صورت خودکار دانلود می‌شود** (حدود ۳۰۰MB). فریلنسر باید در این مرحله **اینترنت داشته باشد**. ```bash # اجرای برنامه برای بارگیری مدل python src/main.py --no-gui "C:\test_input" "C:\test_output" ``` > پس از بارگیری مدل، **دیگر نیاز به اینترنت نیست**. --- #### **مرحله ۴: آماده‌سازی فایل‌های ورودی** شما باید **فایل‌های متنی انگلیسی** را به فریلنسر تحویل دهید. فریلنسر باید این فایل‌ها را در یک پوشه قرار دهد. مثال: ``` C:\input_root\ │ ├── file1.txt ├── folder1\ │ ├── subfile1.txt │ └── subfile2.txt └── folder2\ └── file2.txt ``` > 📌 **نکته:** ساختار پوشه‌ها **دقیقاً حفظ خواهد شد**. --- #### **مرحله ۵: اجرای برنامه ترجمه** فریلنسر باید یکی از روش‌های زیر را اجرا کند: ##### **الف) اجرای با رابط گرافیکی (GUI - پیش‌فرض)** ```bash python src/main.py "C:\input_root" "D:\output_root" ``` یا اگر از فایل اجرایی استفاده می‌کنید: ```bash Translate.exe C:\input_root D:\output_root ``` > ✨ یک پنجره با نوار پیشرفت نمایش داده می‌شود. پس از اتمام، پنجره به‌صورت خودکار بسته می‌شود. ##### **ب) اجرای خط‌مشی (بدون GUI)** ```bash python src/main.py "C:\input_root" "D:\output_root" --no-gui ``` > خروجی پیشرفت در ترمینال نمایش داده می‌شود. --- #### **مرحله ۶: بررسی خروجی** پس از اتمام، فریلنسر باید پوشه خروجی (`D:\output_root`) را بررسی کند: - ساختار پوشه‌ها **دقیقاً مثل ورودی** کپی شده است. - فایل‌های ترجمه‌شده با **همان نام** در مسیر مشخص شده ذخیره شده‌اند. مثال: اگر `C:\input_root\folder1\abc.txt` وجود داشت، خروجی در `D:\output_root\folder1\abc.txt` ذخیره می‌شود. --- ### **🧪 تست‌های ضروری (فریلنسر باید انجام دهد)** 1. **تست ترجمه یک متن ساده** فایل `test.txt` با محتوای زیر ایجاد کند: ``` Hello world! This is a test. Artificial intelligence is amazing. ``` نتیجه ترجمه باید باشد: ``` سلام دنیا! این یک تست است. هوش مصنوعی شگفت‌انگیز است. ``` 2. **تست فایل‌های خالی** یک فایل خالی ایجاد کند → برنامه نباید خطا دهد. 3. **تست پوشه‌های توداری** ساختار چندلایه پوشه ایجاد کند و مطمئن شود ترجمه در همه سطوح انجام می‌شود. 4. **تست فایل ترجمه‌شده قبلی** یک فایل ترجمه‌شده را در مسیر خروجی قرار دهد → برنامه **باید از ترجمه آن عبور کند**. 5. **قطع برق/قطع اینترنت** برنامه را در حین اجرا **بسته** کند و دوباره اجرا نماید → فقط فایل‌های **ترجمه‌نشده** پردازش شوند. --- ### **📤 تحویل نهایی به شما** فریلنسر باید پس از اتمام، موارد زیر را به شما تحویل دهد: 1. **پوشه خروجی (`output_root`)** حاوی تمام فایل‌های ترجمه‌شده. 2. **گزارش تست** شامل: - تعداد فایل‌های ترجمه‌شده - مدت زمان کل ترجمه - نمونه‌هایی از ترجمه‌ها (عمدتاً متن‌های تستی شما) - هرگونه خطا یا مشکل پیش‌آمده 3. **فایل اجرایی `Translate.exe`** (اگر ساخته شده باشد). > ✅ **تأکید:** تمام فرآیند **بدون اتصال به اینترنت** انجام شده است (به جز بارگیری اولیه مدل). --- ### **⚠️ هشدارهای مهم برای فریلنسر** - **هرگز از API آنلاین یا سرویس‌های تحت وب استفاده نکنید!** - ساختار پوشه‌ها **دقیقاً** باید حفظ شود. - اگر فایل خروجی وجود دارد، **ترجمه تکرار نشود**. - برنامه **بدون تنظیمات اضافی** باید اجرا شود. --- با ارائه این دستورالعمل، فریلنسر به‌راحتی می‌تواند پروژه را اجرا، تست و نتیجه را به شما تحویل دهد! 

این پروژه شامل 1 فایل مهم است، لطفا قبل از ارسال پیشنهاد حتما نسبت به بررسی این فایل اقدام فرمایید.

مهارت ها و تخصص های مورد نیاز

---

---