مستندات فارسی جنگو ۳.۲

خانه | فهرست محتوا | فهرست کلی | فهرست ماژول ها | درباره | صفحه در مستندات رسمی

« قبلی | بعدی »

مستندات جنگو

هر آنچه باید در مورد جنگو بدانید.

اولین گامها

آیا در جنگو و یا برنامه نویسی تازه وارد هستید؟ محل شروع اینجاست!

• شروع از صفر: بررسی اجمالی | نصب و راه اندازی
• آموزش: بخش ۱: Requests and responses | بخش ۲: Models and admin site | بخش ۳: Views and templates | بخش ۴: Forms and generic views | بخش ۵: Testing | بخش ۶: Static files | بخش ۷: Customizing the admin site
• آموزش های پیشرفته: چگونه برنامه هایی با قابلیت استفاده مجدد بنویسیم | نوشتن تغیرات برای اصلاح و یا بهبود جنگو

دریافت کمک

مشکل یا سوالی وجود دارد؟ ما میخواهیم کمک کنیم!

• به سوالات متداول نگاهی بیندازید – این بخش برای بسیاری از سوالات رایج پاسخ دارد.
• به دنبال اطلاعات خاصی هستید؟ از فهرست کلی ، فهرست ماژول ها و یا از فهرست جامع و کامل طبقه بندی شده استفاده کنید.
• هنوز به جواب نرسیده اید؟ برای گرفتن اطلاعات در مورد دریافت پشتیبانی و پرسیدن سوال از انجمن به سوالات متداول: دریافت کمک مراجعه کنید.
• اشکالات و باگ های جنگو را در ticket tracker به ما گزارش دهید.

نحوه سازماندهی مستندات

جنگو مستندات زیادی دارد. یک دید کلی و سطح بالا از نحوه سازماندهی آن میتواند به شما کمک کند تا بدانید کجا باید به دنبال موارد خاص باشید.

• آموزش ها از طریق یک سری مراحل برای ساخت یک وب اپلیکیشن دست شمارا میگیرند و به شما کمک میکنند. اگر در جنگو و یا توسعه وب اپلیکیشن ها تازه وارد هستید از اینجا شروع کنید. همچنین نگاهی به اولین گامها بیندازید.
• راهنماهای موضوعات شامل بحث هایی در خصوص موضوعات و مفاهیم کلیدی در سطح نسبتا بالا هستند و اطلاعات که توضیحات مفید در مورد آنها را ارائه میدهند.
• راهنماهای مرجع حاوی مرجع فنی و تکنیکی برای API ها و مباحث و جنبه های دیگر در ساختارهای جنگو میباشند. آنها نحوه عملکرد و استفاده از جنگو را توضیح میدهند ، اما فرض میشود که شما درک و دانش اولیه ای از مفاهیم کلیدی جنگو دارید.
• راهنماهای “چطور” به اصطلاح دستورهای پخت میباشند. آنها شمارا از طریق راه ها و مراحل مربوط به حل مشکلات کلیدی و زمان و محل استفاده آن ها در حالت ها و شرایط های مختلف راهنمایی میکنند. این بخش از آموزش ها پیشرفته تر هستند و فرض میشود که شما دانشی از چگونگی کار جنگو دارید.

لایه مدل (model)

جنگو لایه ای انتزاعی تحت عنوان مدل ها (models) برای ساختاردهی و دستکاری دیتابیس و داده های برنامه وب شما فراهم میکند. در مورد انها بیشتر بدانید:

• Models (مدل ها) : Introduction to models (آشنایی با مدل ها) | Field types (انواع فیلدها) | Indexes (ایندکس ها) | Meta options (آپشن های متا) | Model class (کلاس مدل)
• QuerySets (کوئری ها) : Making queries (ایجاد کوئری ها) | QuerySet method reference (مرجع متد کوئری ها) | Lookup expressions (عبارات جستجو)
• Model instances (نمونه های مدل) : Instance methods (متدهای نمونه مدل) | Accessing related objects (دسترسی به اشیا مرتبط)
• Migrations (مهاجرت ها : مهاجرت تغیرات مدل ها به کدهای دیتابیسی) : Introduction to Migrations (آشنایی با مهاجرت ها) | Operations reference (مرجع عملیات ها) | SchemaEditor (ویرایشگر الگو) | Writing migrations (نوشتن مهاجرت ها)
• Advanced (پیشرفته) : Managers (مدیران) | Raw SQL (sql خام) | Transactions (تراکنش ها [راه های مدیریت تراکنش های دیتابیس در جنگو]) | Aggregation (انبوه [مباحث مرتبط با داده های گرفته شده از دیگر داده ها]) | Search (جستجو) | Custom fields (فیلدهای سفارشی) | Multiple databases (پایگاه های داده متعدد) | Custom lookups (جستجوهای سفارشی) | Query Expressions (عبارات کوئری) | Conditional Expressions (عبارات شرطی) | Database Functions (توابع پایگاه داده)
• Other (سایرموارد) : Supported databases (پایگاه های داده ی پشتیبانی شده) | Legacy databases (پایگاه های داده قدیمی) | Providing initial data (ارائه داده های اولیه) | Optimize database access (بهینه سازی دسترسی های پایگاه داده) | PostgreSQL specific features (ویژگی های خاص پایگاه داده PostgreSQL)

لایه ویو (view)

جنگو مفهومی تحت عنوان ویوها (views) دارد که برای بیان منطق مدیریت پردازش درخواست های کاربر (requests) و همچنین بازگرداندن پاسخ مناسب به آن (responses) ایجاد شده است. از طریق لینک های زیر هرآنچه برای دانستن نیاز دارید را میتوانید پیدا کنید:

• The basics (اصول اولیه) : URLconfs (پیکربندی url ها) | View functions (توابع ویو) | Shortcuts (میانبرها) | Decorators (دکوریتورها) | Asynchronous Support (پشتیبانی ناهمزمان)
• Reference (ارجاعات) : Built-in Views (ویوهای داخلی جنگو) | Request/response objects (اشیاء درخواست/پاسخ ؟منظور از اشیا و یا همان object ها ، نمونه های یک کلاس میباشد که در این بخش توضیحات در خصوص خواص و ویژگی های object های دو کلاس request و response آمده است.) | TemplateResponse objects (اشیاء TemplateResponse)
• File uploads (آپلود فایل ها) : Overview (بررسی اجمالی) | File objects (اشیاء File ؟منظور از اشیا و یا همان object ها ، نمونه های یک کلاس میباشد که در این بخش توضیحات در خصوص خواص و ویژگی های object های کلاس File آمده است.) | Storage API (API های کلاس Storage) | Managing files (مدیریت فایل ها) | Custom storage (ذخیره سازی سفارشی)
• Class-based views (ویوهای برپایه ی class) : Overview (بررسی اجمالی) | Built-in display views (ویوهای نمایشی داخلی جنگو ؟توضیحات در خصوص ویوهای کلس بیس خود جنگو که برای نشان دادن object ها به کار برده میشود) | Built-in editing views (ویوهای ویرایشی داخلی جنگو ؟توضیحات در خصوص ویوهای کلس بیس خود جنگو که برای تغییرات object ها به کار برده میشود مانند حذف یا ویرایش آنها) | Using mixins (استفاده از میکسین ها) | API reference (مرجع API ویوهای کلس بیس) | Flattened index (نمایه مسطح ؟ارائه خلاصه و مفید ویوهای عمومی کلاس بیس به همراه ویژگی ها و متدهای موثر هر کلاس)
• Advanced (پیشرفته) : Generating CSV (ایجاد CSV) | Generating PDF (ایجاد PDF)
• Middleware (میان افزارها) : Overview (بررسی اجمالی) | Built-in middleware classes (کلاس های میان افزار داخلی جنگو)

لایه قالب (template)

لایه قالب یا تمپلیت یک سینتکس طراح پسند را برای تفسیر و پردازش اطلاعاتی فراهم میکند که قرار است به کاربر ارائه شوند. بیاموزید که چگونه سینتکس ان میتواند توسط طراحان مورد استفاده قرار بگیرد و چگونه میتواند توسط برنامه نویسان گسترش پیدا کند:

• The basics (اصول اولیه) : Overview (بررسی اجمالی)
• For designers (برای طراحان) : Language overview (بررسی اجمالی زبان قالب در جنگو) | Built-in tags and filters (تگ ها و فیلتر های داخلی جنگو) | Humanization (انسان سازی ؟مجموعه از از فیلترهای جنگو که برای قابل فهم کردن دیتاها به کار میروند)
• For programmers (برای برنامه نویسان) : Template API (API لایه قالب در جنگو ؟توضیحات لایه قالب به صورت فنی و نحوه کار و گسترش آن) | Custom tags and filters (تگ ها و فیلترهای سفارشی) | Custom template backend (قالب سفارشی)

فرم ها (Forms)

جنگو چهارچوب غنی و کاملی برای ساخت فرم ها و دستکاری داده های آن فراهم میکند.

• The basics (اصول اولیه) : Overview (بررسی اجمالی) | Form API (API بخش Form ؟توضیحات متدها و روش های فرم ها در جنگو) | Built-in fields (فیلدهای داخلی جنگو) | Built-in widgets (ویجت های داخلی جنگو)
• Advanced (پیشرفته) : Forms for models (فرم ها برای مدل ها) | Integrating media (یکپارچه سازی رسانه ها) | Formsets (مجموعه فرم ها) | Customizing validation (سفارشی کردن اعتبارسنجی)

فرآیند توسعه

در مورد اجزاهای مختلف و ابزارهایی که به شما در توسعه و تست نویسی در جنگو وب اپلیکیشن ها کمک میکنند بیشتر بدانید:

• Settings (تنظیمات) : Overview (بررسی اجمالی) | Full list of settings (لیست کامل تنظیمات)
• Applications (اپلیکیشن ها) : Overview (بررسی اجمالی)
• Exceptions (ارورهای جنگو) : Overview (بررسی اجمالی)
• django-admin و manage.py : Overview (بررسی اجمالی) | Adding custom commands (اضافه کردن دستورات سفارشی)
• Testing (تست نویسی) : Introduction (معرفی) | Writing and running tests (نوشتن و اجرا کردن تست ها) | Included testing tools (ابزارهای تست نویسی) | Advanced topics (موضوعات پیشرفته)
• Deployment (راه اندازی پروژه) : Overview (بررسی اجمالی) | WSGI servers (سرورهای WSGI) | ASGI servers (سرورهای ASGI) | Deploying static files (استقرار فایل های استاتیک) | Tracking code errors by email (ردیابی خطاهای کد از طریق ایمیل) | Deployment checklist (چک لیست مورد نیاز راه اندازی پروژه)

مدیر (Admin)

تمام چیزهای مورد نیاز در خصوص رابط مدیر خودکار بدانید، یکی از محبوب ترین ویژگی های جنگو:

• Admin site (ادمین پنل)
• Admin actions (اکشن ها در ادمین پنل)
• Admin documentation generator (تولید کننده مستندات ادمین)

امنیت (Security)

امنیت موضوعی بسیار مهم در توسعه وب اپلیکیشن ها میباشد و جنگو در این راستا ابزارها و مکانیسم های حفاظتی متعددی را فراهم میکند:

• Security overview (بررسی اجمالی امنیت)
• Disclosed security issues in Django (مشکلات امنیتی گزارش شده در جنگو )
• Clickjacking protection (حفاظت از Clickjacking)
• Cross Site Request Forgery protection (حفاظت از جعل درخواست کراس سایت)
• Cryptographic signing (امضای رمزنگاری)
• Security Middleware (میان افزار امنیتی)

بین المللی و بومی سازی (Internationalization and localization)

جنگو چهارچوبی قدرتمند برای بین المللی سازی و بومی سازی در جهت ساخت و توسعه برنامه های کاربردی برای چندین زبان مختلف دنیا را ارائه میدهد:

• Overview (بررسی اجمالی) | Internationalization (بین المللی سازی) | Localization (بومی سازی) | Localized Web UI formatting and form input (قالب بندی UI و ورودی فرم بومی)
• Time zones (محدوده های زمانی)

عملکرد و بهینه سازی

در جنگو تکنیک ها و ابزارهای متنوعی وجود دارد که میتوانند شما را برای اجرای کدی موثرتر، سریعتر و در عین حال با استفاده از کمترین منابع، کمک کنند.

• Performance and optimization overview (بررسی اجمالی عملکرد و بهینه سازی)

چارچوب جغرافیایی (Geographic framework)

GeoDjango قصد دارد تا به یک وب فریم ورک جفرافیایی در سطح جهانی تبدیل شود و هدف آن این است که ساخت وب اپلیکیشن های GIS را تا حد امکان آسان کند و از قدرت داده های فعال مکانی استفاده کند.

ابزارهای کاربردی رایج وب اپلیکیشن

جنگو ابزارهای متعددی را ارائه می دهد که معمولاً در توسعه وب مورد نیاز هستند برنامه های کاربردی:

جنگو ابزارهای متعددی ارائه میدهد که معمولا در توسعه وب اپلیکیشن ها مورد نیاز هستند:

• Authentication (احراز هویت) : Overview (بررسی اجمالی) | Using the authentication system (استفاده از سیستم احراز هویت) | Password management (مدیریت رمزعبور) | Customizing authentication (سفارشی سازی سیستم احرازهویت) | API Reference (مرجع API)
• Caching (ذخیره سازی)
• Logging (ورود به سیستم)
• Sending emails (ارسال ایمیل ها)
• Syndication feeds (RSS/Atom)
• Pagination (صفحه بندی)
• Messages framework (فریم ورک پیام ها)
• Serialization (سریال سازی)
• Sessions (نشست ها)
• Sitemaps (نقشه های سایت)
• Static files management (مدیریت فایل های استتیک)
• Data validation (اعتبار سنجی داده ها)

سایر قابلیت های اصلی

با برخی دیگر از قابلیت های اصلی فریم ورک جنگو اشنا شوید:

• Conditional content processing (پردازش محتواهای شرطی)
• Content types and generic relations (Content type ها و ارتباطات کلی)
• Flatpages (صفحات ثابت)
• Redirects (تغییرمسیرها)
• Signals (سیگنال ها)
• System check framework (فریم ورک بررسی سیستم)
• The sites framework (فریم ورک site جنگو)
• Unicode in Django (یونیکد در جنگو)

پروژه اپن سورس جنگو

در مورد فرایند توسعه خود پروژه جنگو و چگونگی مشارکت در پروژه را بدانید:

• Community (انجمن) : How to get involved (نحوه درگیر شدن در پروژه) | The release process (فرایند انتشار) | Team organization (سازماندهی تیم) | The Django source code repository (مخزن سورس کد جنگو) | Security policies | (سیاست های امنیتی) Mailing lists (لیست های پستی)
• Design philosophies (فلسفه های طراحی) : Overview (بررسی اجمالی)
• Documentation (مستندات) : About this documentation (درباره این مستندات)
• Third-party distributions (توزیع های شخص ثالث) : Overview (بررسی اجمالی)
• Django over time (جنگو در طول زمان) : API stability (پایداری API) | Release notes and upgrading instructions (نسخه ها و دستورعمل های ارتقا) | Deprecation Timeline (جدول زمانی منسوخ شدن)