Kho lưu trữ mẫu khối chứa một số danh mục dự án. Trang này giúp bạn hiểu vị trí của các danh mục khác nhau và nội dung có trong mỗi dự án trong một danh mục.
Lớp học lập trình
Lớp học lập trình là các hướng dẫn tương tác được viết theo cú pháp markdown và được phát hành tại blocklycodelabs.dev. Các lớp học lập trình sử dụng kết hợp ngôn ngữ tự nhiên, mã mẫu và ảnh chụp màn hình để mang đến trải nghiệm hướng dẫn thú vị hơn. Người dùng mục tiêu đang theo dõi và chạy mã khi họ đọc.
Thư mụccodelabs có một mẫu và một thư mục cho mỗi lớp học lập trình. Mỗi thư mục lớp học lập trình chứa một tệp đánh dấu và tất cả thành phần (png, gif, v.v.) cho lớp học lập trình.
Ví dụ
Ví dụ: các dự án mẫu độc lập minh hoạ kỹ thuật để đưa vào và mở rộng thư viện Blockly. Các mô-đun này thường bao gồm một trang web minh hoạ và một số mã hỗ trợ. Lớp học lập trình sẽ hướng dẫn bạn từng bước xây dựng nội dung, còn Ví dụ sẽ cho bạn thấy sản phẩm hoàn thiện và cho phép bạn khám phá sản phẩm theo tốc độ của riêng mình.
Mã mẫu phải được chú thích cực kỳ tốt để dễ dàng sao chép. Người dùng mục tiêu có thể đọc, chạy mã cục bộ hoặc sao chép đoạn mã.
Thư mục example có một thư mục cho mỗi ví dụ. Mỗi ví dụ có thể chạy bằng npm install && npm run
start và có một tệp README.md với ngữ cảnh hoặc hướng dẫn bổ sung.
Trình bổ trợ
Trình bổ trợ là các đoạn mã độc lập, giúp bổ sung chức năng cho Blockly. Trình bổ trợ có thể thêm trường, xác định giao diện, tạo trình kết xuất và làm nhiều việc khác. Người dùng mục tiêu là một nhà phát triển tìm và sử dụng trình bổ trợ thông qua npm. Các trình bổ trợ được xác định trong kho lưu trữ này là các trình bổ trợ của bên thứ nhất, có nghĩa là các trình bổ trợ này được nhóm Blockly hỗ trợ.
Thư mục trình bổ trợ có một thư mục cho mỗi trình bổ trợ. Mỗi trình bổ trợ có một thư mục src, trong đó có mã và một thư mục test chứa trang minh hoạ. Các trình bổ trợ này cũng chứa
tệp README.md, cung cấp cho nhà phát triển thông tin về chức năng và cách sử dụng trình bổ trợ.
Trang GitHub
Khối mẫu có một trang web, trong đó nhiều trình bổ trợ và bản minh hoạ có sẵn trong môi trường sân chơi. Trang này được lưu trữ trên các trang GitHub, và mã cho trang web này nằm trong thư mục gh-pages của blockly-samples. Thư mục này chứa các mẫu cho các trang trên trang web. Nội dung trang web thực tế được tạo dựa trên các mẫu và siêu dữ liệu này trên mỗi trình bổ trợ hoặc ví dụ mà bạn lưu trữ.