ساختار مخزن نمونه های بلوکی

مخزن نمونه های بلوکی شامل چند دسته مختلف پروژه است. این صفحه به شما کمک می‌کند تا بفهمید دسته‌های مختلف در کجا زندگی می‌کنند و هر پروژه در یک دسته ممکن است شامل چه مواردی باشد.

Codelabs

Codelabs آموزش های تعاملی هستند که به صورت markdown نوشته شده و در blocklycodelabs.dev منتشر می شوند. Codelabs از ترکیبی از زبان طبیعی، نمونه کد و اسکرین شات برای ایجاد یک تجربه آموزشی جالب‌تر استفاده می‌کند. کاربر هدف در حین خواندن کد را دنبال می کند و اجرا می کند.

دایرکتوری codelabs دارای یک الگو و یک پوشه در هر کدلب است. هر پوشه Codelab حاوی یک فایل علامت گذاری و تمام دارایی ها (pngs، gif و غیره) برای کد لبه است.

مثال ها

نمونه‌ها پروژه‌های نمونه مستقلی هستند که تکنیک‌هایی را برای گنجاندن و گسترش کتابخانه Blockly نشان می‌دهند. آنها معمولاً از یک صفحه وب آزمایشی و تعدادی کد پشتیبانی تشکیل می شوند. در حالی که Codelabs شما را در ساختن چیزی قدم به قدم راهنمایی می‌کند، مثال‌ها یک محصول نهایی را به شما نشان می‌دهند و به شما امکان می‌دهند آن را با سرعت خود کاوش کنید.

کد مثال باید بسیار خوب نظر داده شود تا کپی کردن آن آسان باشد. کاربر مورد نظر ممکن است در حال خواندن کد، اجرای آن به صورت محلی یا کپی کردن قطعه کد باشد.

دایرکتوری نمونه در هر نمونه یک پوشه دارد. هر نمونه را می توان با npm install && npm run start اجرا کرد و دارای یک فایل README.md با متن یا دستورالعمل های اضافی است.

پلاگین ها

پلاگین ها تکه های کد مستقلی هستند که قابلیت هایی را به Blockly اضافه می کنند. پلاگین ها می توانند فیلدها را اضافه کنند، تم ها را تعریف کنند، رندر ایجاد کنند و خیلی چیزهای دیگر. کاربر هدف توسعه دهنده ای است که افزونه را از طریق npm پیدا کرده و از آن استفاده می کند. پلاگین های تعریف شده در این مخزن پلاگین های شخص اول هستند، به این معنی که توسط تیم Blockly پشتیبانی می شوند.

دایرکتوری افزونه ها دارای یک پوشه برای هر افزونه است. هر افزونه دارای یک دایرکتوری src است که کد در آن قرار دارد و یک دایرکتوری test که یک صفحه نمایشی در آن زندگی می کند. آنها همچنین حاوی یک فایل README.md هستند که به توسعه دهندگان اطلاعاتی درباره کارهایی که افزونه انجام می دهد و نحوه استفاده از آن می دهد.

صفحات Github

Blockly-samples یک صفحه وب دارد که در آن بسیاری از پلاگین ها و دموها در یک محیط زمین بازی در دسترس هستند. این صفحه در صفحات GitHub میزبانی می شود و کد این سایت در فهرست gh-pages blockly-samples قرار دارد. این فهرست شامل قالب هایی برای صفحات سایت است. محتوای واقعی سایت بر اساس این الگوها و ابرداده ها از هر افزونه یا نمونه میزبانی شده تولید می شود.