todo.md

برنامه‌ریزی جامع ترجمه، تفسیر و تولید کتاب PDF: کتاب کار با میکروپایتون در رسپبری‌پای پیکو

کتاب مبنا: Get Started with MicroPython on Raspberry Pi Pico
نویسنده / مولف: گرث هالفاکری (Gareth Halfacree) و بن اورارد (Ben Everard)
وضعیت: 🟡 در انتظار شروع ترجمه (Backlog)
هدف نهایی: ارائه ترجمه تفسیری، روان و کاملاً بومی‌سازی‌شده به همراه دیاگرام‌ها، نمونه کدها، تفسیر سناریوهای عملیاتی و تولید یک فایل PDF کامل، نفیس و استاندارد با کیفیت چاپ با موتور Typst.

---

۱. استانداردهای نگارش و ترجمه تفسیری

1. رویکرد تفسیری (Conceptual & Interpretive): پرهیز از ترجمه ماشینی یا تحت‌اللفظی؛ انتقال کامل منطق فنی و معماری.
2. ادبیات مهندسی (Developer Persian): دست‌نخورده باقی ماندن اصطلاحات استاندارد صنعتی و برنامه‌نویسی.
3. صفحه‌آرایی مدرن Typst: خروجی چاپی با قلم زیبای وزیرمتن، باکس‌های نکته، هشدار و کدهای تمیز.

---

۲. فازبندی اجرایی پروژه

• فاز ۰: راه‌اندازی تمپلیت و تایپوگرافی Typst

  • آماده‌سازی book.typ و پیکربندی قلم وزیرمتن
  • تنظیم هدر، فوتر، شماره‌گذاری صفحات و استایل کدهای منبع

• فاز 1: فصل ۱ - آشنایی با سخت‌افزار میکروکنترلر Raspberry Pi Pico

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۱
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 2: فصل ۲ - شروع برنامه‌نویسی سخت‌افزار با MicroPython

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۲
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 3: فصل ۳ - رایانش فیزیکی و کنترل پایه‌های GPIO

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۳
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 4: فصل ۴ - تعامل با کلیدها و کنترلرهای ورودی

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۴
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 5: فصل ۵ - مبدل آنالوگ به دیجیتال (ADC) و خواندن حسگرها

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۵
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 6: فصل ۶ - پروتکل‌های ارتباطی I2C و SPI و اتصال نمایشگرها

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۶
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 7: فصل ۷ - ورودی/خروجی برنامه‌پذیر پیشرفته (PIO)

  • استخراج سرفصل‌ها و مفاهیم بنیادین فصل ۷
  • نگارش و بازتفسیر مفهومی متن به فارسی مهندسی (Developer Persian)
  • استخراج و جای‌گذاری دیاگرام‌ها و فرمول‌ها در Typst
  • کامپایل و اعتبارسنجی اولیه فصل

• فاز 8: بازبینی و تضمین کیفیت نهایی (Review Phase) [الزامی]

  • بررسی اصطلاحات با grep و اطمینان از عدم وجود ترجمه‌های تحت‌اللفظی ممنوعه
  • بازخوانی روان‌شناختی متن فارسی و انطباق کامل با روح متن انگلیسی
  • کامپایل نهایی پروژه با typst compile book.typ بدون هیچ خطا و اخطار
  • تولید نسخه انتشار (Release) و درج لینک در پورتال اصلی کتاب‌ها