Repozytorium blockly-Sample zawiera kilka różnych kategorii projektów. Na tej stronie dowiesz się, gdzie znajdują się poszczególne kategorie i co mogą zawierać poszczególne projekty.
Ćwiczenia z programowania
Ćwiczenia z programowania to interaktywne samouczki napisane w składni Markdown i publikowane na stronie blocklycodelabs.dev. Dzięki połączeniu języka naturalnego, przykładów kodu i zrzutów ekranu możesz tworzyć bardziej atrakcyjne samouczki. Użytkownik docelowy podąża za nim i uruchamia kod w trakcie odczytu.
Katalog Codelabs zawiera szablon, a na każde ćwiczenie z programowania 1 folder. Każdy folder z ćwiczeniami z programowania zawiera plik w formacie Markdown oraz wszystkie zasoby (PNG, GIF itd.) używane w ćwiczeniach z programowania.
Przykłady
Przykładowe niezależne projekty przedstawiające techniki włączania i rozszerzania biblioteki Blockly. Zwykle składa się z wersji demonstracyjnej i kodu pomocniczego. Z kolei Codelabs przeprowadzi Cię przez proces tworzenia czegoś krok po kroku, a z przykładów pokaże Ci gotowy produkt i pozwoli Ci zapoznać się z nim we własnym tempie.
Przykładowy kod powinien być bardzo dobrze skomentowany, aby można go było łatwo skopiować. Użytkownik docelowy może odczytywać kod, uruchamiać go lokalnie lub kopiować fragmenty kodu.
W katalogu examples znajduje się 1 folder na przykład. Każdy przykład można uruchomić z użyciem elementu npm install && npm run
start i zawiera plik README.md z dodatkowym kontekstem lub instrukcjami.
Wtyczki
Wtyczki to niezależne fragmenty kodu, które dodają funkcje do Blockly. Wtyczki mogą dodawać pola, definiować motywy, tworzyć mechanizmy renderowania i wykonywać wiele innych czynności. Użytkownik docelowy to programista, który znajduje wtyczkę i korzysta z niej za pomocą npm. Wtyczki zdefiniowane w tym repozytorium są wtyczkami własnymi, co oznacza, że są one obsługiwane przez zespół Blockly.
W katalogu wtyczek jest 1 folder na wtyczkę. Każda wtyczka ma katalog src, który zawiera kod, i katalog test, w którym znajduje się strona demonstracyjna. Zawierają też plik README.md z informacjami dla programistów, jak działa wtyczka i jak z niej korzystać.
Strony GitHuba
Blockly-Samples ma stronę internetową, na której wiele wtyczek i wersji demonstracyjnych jest dostępnych w środowisku testowym. Ta strona znajduje się na stronach GitHub, a jej kod znajduje się w katalogu gh-pages z przykładami blockly. Zawiera on szablony do stron w witrynie. Rzeczywista zawartość witryny jest generowana na podstawie tych szablonów i metadanych z każdej hostowanej wtyczki lub przykładu.