המאגר של blockly-samples מכיל מספר קטגוריות שונות של פרויקטים. הדף הזה נועד לעזור לכם להבין איפה נמצאות הקטגוריות השונות, ומה עשוי לכלול כל פרויקט בקטגוריה.
Codelabs
Codelabs הם מדריכים אינטראקטיביים שכתובים בתחביר Markdown ופורסמו ב-blocklycodelabs.dev. Codelabs משתמשים בשילוב של שפה טבעית, דוגמאות קוד וצילומי מסך כדי ליצור חוויית מדריך מעניינת יותר. משתמש היעד עוקב אחרי הקוד ומפעיל את הקוד תוך כדי שהוא קורא.
בספריית Codelabs יש תבנית ותיקייה אחת לכל Codelab. כל תיקיית codelab מכילה קובץ Markdown ואת כל הנכסים (pngs, קובצי GIF וכו') ב-Codelab.
דוגמאות
דוגמאות: פרויקטים לדוגמה עצמאיים שמדגימים שיטות להכללה ולהרחבה של ספריית blockly. בדרך כלל הן כוללות דף אינטרנט להדגמה וקוד תומך. ב-Codelabs מוצגות הוראות מפורטות לבניית מוצר כלשהו, ובדוגמאות האלה אתם יכולים לראות את המוצר המוגמר ולחקור אותו בקצב שלכם.
קוד לדוגמה אמור להיות בעל תגובות טובות במיוחד, כך שקל להעתיק אותו. יכול להיות שמשתמש היעד קורא את הקוד, מפעיל אותו באופן מקומי או מעתיק קטעי קוד.
בספריית הדוגמאות יש תיקייה אחת לכל דוגמה. כל דוגמה אפשר להריץ באמצעות npm install && npm run
start, והיא כוללת קובץ README.md עם הקשר נוסף או הוראות נוספות.
יישומי פלאגין
יישומי פלאגין הם קטעי קוד עצמאיים שמוסיפים פונקציונליות ל-Blockly. יישומי פלאגין יכולים להוסיף שדות, להגדיר עיצובים, ליצור כלי רינדור ועוד. משתמש היעד הוא מפתח שמוצא את הפלאגין ומשתמש בו דרך npm. יישומי פלאגין שמוגדרים במאגר הזה הם יישומי פלאגין של צד ראשון, כלומר הם נתמכים על ידי צוותBlockly.
בספריית יישומי הפלאגין יש תיקייה אחת לכל פלאגין. לכל פלאגין יש ספריית src, שבה הקוד נמצא, וספריית test, שבה נמצא דף הדגמה. הם גם מכילים קובץ README.md, שמספק למפתחים מידע על פעולת הפלאגין ועל אופן השימוש בו.
דפי GitHub
ב-Blockly-samples יש דף אינטרנט שבו רבים מיישומי הפלאגין וההדגמות זמינים בסביבת המשחק. הדף הזה מתארח בדפי GitHub, והקוד של האתר הזה נמצא בספרייה gh-pages של blockly-samples. הספרייה הזו מכילה תבניות עבור הדפים באתר. תוכן האתר בפועל נוצר על סמך התבניות והמטא-נתונים האלה מכל פלאגין או דוגמה שמתארחת.