Cardano Blueprint 📘 📐

Welcome to the Cardano Blueprint, a project that aims to serve as a knowledge foundation about how the Cardano protocol works. Blueprints are implementation independent assets, diagrams, specifications, test data, etc. that will enable a wide developer audience to understand the protocol and build Cardano components.

👉 Introduction 👈

Building

The blueprints are written using markdown and can be viewed directly in Github or built into the HTML site using mdbook.

With cargo

You can install mdbook and the plugins we use with cargo:

cargo install mdbook mdbook-katex mdbook-mermaid mdbook-alerts

Then, build with:

mdbook build

Binary install

There's also an option to install directly from binaries with cargo binstall:

cargo install cargo-binstall         # If you don't already have it
cargo binstall mdbook mdbook-katex mdbook-mermaid mdbook-alerts

With nix

You can also use nix:

nix build -o out

Editing

With mdbook installed or inside a nix develop shell, you can live preview the result with:

mdbook serve --open

See the mdbook manual or github flavored markdown for more information on what is available for editing.