🌿 جزوه کامل برای یادگیری SQLAlchemy 🌿

🌿 جزوه کامل برای یادگیری SQLAlchemy 🌿

⚠️ توصیه بسیار مهم قبل از شروع ⚠️

📌 برای مطالعه بهتر این جزوه، حتماً نسخه PDF آن را باز کنید!

  • :در نسخه PDF
    • متن فارسی راست‌چین و متن انگلیسی چپ‌چین شده است
    • استایل‌ها و فونت‌ها برای خوانایی و زیبایی بهتر تنظیم شده‌اند
    • جدول‌ها، کدها و نقل‌قول‌ها به صورت حرفه‌ای نمایش داده می‌شوند

با مشاهده نسخه PDF، تجربه خواندن بسیار راحت‌تر و جذاب‌تر خواهد بود.

📖 درباره این جزوه

این جزوه یا راهنما بر اساس مستندات رسمی SQLAlchemy و با کمک ChatGPT و Claude تهیه شده است.
هدف اصلی از نوشتن این مطالب، آماده شدن برای یادگیری FastAPI بوده است. با تجربه‌ای که از Django ORM داشتم، یادگیری SQLAlchemy چندان دشوار نبود و تجربه جالب و آموزنده‌ای بود.

مطالعه کامل این مباحث بیش از یک تا دو روز طول نمی‌کشد و سعی شده توضیحات تا حد امکان کامل و کاربردی باشد.

اگر ایراد یا نقصی مشاهده کردید، خوشحال می‌شوم برای اصلاح آن همکاری کنید.

📚 نسخه‌های موجود

این جزوه در دو نسخه ارائه شده است:

⚡ با توجه به استایل‌های زیبا، جدول‌ها و کدهای قالب‌بندی شده، نسخه PDF خوانایی بیشتری نسبت به فایل Markdown دارد.

📥 دانلود فایل‌های PDF

برای دانلود فایل‌های PDF می‌توانید از روش‌های زیر استفاده کنید:

🔗 دانلود مستقیم از GitHub

  1. روی لینک‌های PDF در بالا کلیک کنید
  2. در صفحه باز شده، روی دکمه “Download” کلیک کنید
  3. یا می‌توانید کل پروژه را به صورت ZIP دانلود کنید

🌐 مشاهده آنلاین از طریق GitHub Pages

می‌توانید این جزوه را به صورت آنلاین و با قالب‌بندی زیبا مشاهده کنید:

💡 نکته: نسخه آنلاین GitHub Pages دارای همان استایل‌های زیبا و قالب‌بندی حرفه‌ای نسخه PDF است و برای مطالعه راحت‌تر طراحی شده است.

🛠️ ساخت فایل PDF (برای توسعه‌دهندگان)

اگر می‌خواهید خودتان فایل PDF بسازید، مراحل زیر را دنبال کنید:

📦 نصب ابزار مورد نیاز

ابتدا پکیج md-to-pdf را نصب کنید:

npm install -g md-to-pdf

📄 ساخت فایل PDF

برای ساخت فایل PDF از دستورات زیر استفاده کنید:

برای نسخه فارسی:

md-to-pdf fa_README.md --stylesheet fa_style.css

برای نسخه انگلیسی:

md-to-pdf en_README.md --stylesheet en_style.css

پس از اجرای دستورات، فایل‌های PDF در همان مسیر ساخته خواهند شد.

⚙️ تنظیمات GitHub Pages

فایل _config.yml برای پیکربندی GitHub Pages استفاده می‌شود و شامل تنظیمات زیر است:

  • Theme: استفاده از قالب minima برای نمایش زیبا
  • Language & Direction: تنظیم زبان فارسی و جهت راست‌چین
  • Markdown Processing: استفاده از kramdown با پشتیبانی از GitHub Flavored Markdown
  • Plugins: افزونه‌های مختلف برای بهبود عملکرد GitHub Pages
  • Default README: تنظیم فایل مارک داون به عنوان صفحه اصلی

این فایل باعث می‌شود که GitHub Pages بتواند محتوای فارسی را به درستی نمایش دهد و از استایل‌های مناسب استفاده کند.