Blok örnekler deposunda birkaç farklı proje kategorisi bulunur. Bu sayfanın amacı, farklı kategorilerin nerede bulunduğunu ve bir kategorideki her projenin neleri içerebileceğini anlamanıza yardımcı olmaktır.
Codelab uygulamaları
Codelabs, Markdown söz dizimiyle yazılan ve blocklycodelabs.dev adresinde yayınlanan etkileşimli eğiticilerdir. Codelabs, daha ilgi çekici bir eğitim deneyimi oluşturmak için doğal dil, kod örnekleri ve ekran görüntülerinin bir karışımını kullanır. Hedef kullanıcı kodu takip eder ve okurken kodu çalıştırır.
codelabs dizininde bir şablon ve her codelab için bir klasör bulunur. Her codelab klasöründe bir Markdown dosyası ve codelab'deki tüm öğeler (png'ler, gif'ler vb.) bulunur.
Örnekler
Blockly kitaplığını dahil etme ve genişletme tekniklerini gösteren bağımsız örnek projeler örnek olarak verilebilir. Bunlar genellikle bir demo web sayfasından ve biraz destekleyici koddan oluşur. Codelab'ler bir şeyi adım adım oluşturmanıza yardımcı olurken, Örnekler tamamlanmış bir ürünü gösterir ve kendi hızınızda keşfetmenize olanak tanır.
Örnek kodun kopyalanması kolay olması için son derece iyi yorumlanması amaçlanmıştır. Hedef kullanıcı kodu okuyor, yerel olarak çalıştırıyor veya kod snippet'lerini kopyalıyor olabilir.
examples dizininde örnek başına bir klasör bulunur. Her örnek npm install && npm run
start ile çalıştırılabilir ve ek bağlam veya talimatlar içeren bir README.md dosyası içerir.
Eklentiler
Eklentiler, Blockly'ye işlevler ekleyen bağımsız kod parçalarıdır. Eklentiler alan ekleyebilir, temalar tanımlayabilir, oluşturucular oluşturabilir ve daha pek çok şey yapabilir. Hedef kullanıcı, eklentiyi npm aracılığıyla bulup kullanan bir geliştiricidir. Bu kod deposunda tanımlanan eklentiler, birinci taraf eklentilerdir. Bu da Blockly ekibi tarafından desteklendiği anlamına gelir.
Eklentiler dizininde eklenti başına bir klasör bulunur. Her eklentinin, kodun bulunduğu bir src dizini ve demo sayfasının bulunduğu bir test dizini vardır. Ayrıca, geliştiricilere eklentinin ne yaptığı ve nasıl kullanılacağı hakkında bilgi veren bir README.md dosyası da içerir.
GitHub Sayfaları
Blockly-örnekler, birçok eklentinin ve demonun oyun alanında bulunabileceği bir web sayfasına sahiptir. Bu sayfa GitHub sayfalarında barındırılmaktadır. Bu sitenin kodu ise blockly-samples gh-pages dizinindedir. Bu dizin, sitedeki sayfalar için şablonlar içerir. Gerçek site içeriği, bu şablonlara ve barındırılan her bir eklentinin veya örneğin meta verilerine göre oluşturulur.