Repositori contoh blockly berisi beberapa kategori project yang berbeda. Halaman ini dimaksudkan untuk membantu Anda memahami di mana berbagai kategori berada, dan apa yang dapat dimuat oleh setiap project dalam suatu kategori.
Codelab
Codelab adalah tutorial interaktif yang ditulis dalam sintaksis markdown dan dipublikasikan di blocklycodelabs.dev. Codelab menggunakan paduan natural language, contoh kode, dan screenshot untuk membuat pengalaman tutorial yang lebih menarik. Pengguna target mengikuti dan menjalankan kode saat mereka membacanya.
Direktori codelab memiliki template dan satu folder per codelab. Setiap folder codelab berisi file markdown dan semua aset (png, gif, dll.) untuk codelab.
Contoh
Contohnya adalah project contoh mandiri yang menunjukkan teknik untuk menyertakan dan memperluas library Blockly. Parameter ini biasanya terdiri dari halaman web demo, dan beberapa kode pendukung. Meskipun Codelabs memandu Anda dalam membangun sesuatu langkah demi langkah, Contoh akan menunjukkan produk jadi, dan memungkinkan Anda mempelajarinya sesuai keinginan Anda.
Kode contoh dimaksudkan untuk dikomentari dengan sangat baik sehingga mudah untuk disalin. Pengguna target mungkin membaca kode, menjalankannya secara lokal, atau menyalin cuplikan kode.
Direktori contoh memiliki satu folder per contoh. Setiap contoh dapat dijalankan dengan npm install && npm run
start, dan memiliki file README.md dengan konteks atau petunjuk tambahan.
Plugin
Plugin adalah potongan kode mandiri yang menambahkan fungsi ke Blockly. Plugin dapat menambahkan kolom, menentukan tema, membuat perender, dan banyak lagi. Pengguna target adalah developer yang menemukan dan menggunakan plugin melalui npm. Plugin yang ditentukan dalam repositori ini adalah plugin pihak pertama, yang berarti plugin tersebut didukung oleh tim Blockly.
Direktori plugin memiliki satu folder per plugin. Setiap plugin memiliki direktori src, tempat kode
dimuat, dan direktori test, tempat halaman demo berada. Plugin juga berisi
file README.md, yang memberikan informasi kepada developer tentang fungsi plugin,
dan cara menggunakannya.
Halaman GitHub
Contoh Blockly memiliki halaman web tempat banyak plugin dan demo tersedia di lingkungan playground. Halaman ini dihosting di halaman GitHub, dan kode untuk situs ini berada di direktori gh-pages dari contoh blockly. Direktori ini berisi template untuk halaman-halaman di situs. Konten situs sebenarnya dibuat berdasarkan template dan metadata ini dari setiap plugin atau contoh yang dihosting.