Examples
========

A gallery of SheepText diagrams, each rendered at build time from a checked-in
source file. Every card is the editor itself: edit the source under the
picture and it re-renders in place, **Reset** restores the checked-in source
and its build-time render, and **Open in editor** carries the checked-in
source into the full editor.

The editor link carries the diagram's full source in the URL fragment (after
the ``#``); nothing is sent to a server, and opening the link never overwrites
whatever draft you already have saved in the editor.

Basics
------

One idea per card, in the order the :doc:`tutorial </tutorial/index>` teaches
them.

.. sheeptext-example:: sources/minimal-chain.sheeptext
   :label: Minimal chain
   :caption: A box, an arrow, a box — the smallest complete diagram.

.. sheeptext-example:: sources/labeled-arrow.sheeptext
   :label: Labeled connector
   :caption: Name boxes, then connect them with a labeled arrow.

.. sheeptext-example:: sources/variables.sheeptext
   :label: Variables and expressions
   :caption: Define a value once and compute sizes from it.

.. sheeptext-example:: sources/styled-diagram.sheeptext
   :label: Styling
   :caption: Colors and dashes on nodes, plus alignment and text weight on standalone and edge labels.

.. sheeptext-example:: sources/nested-groups.sheeptext
   :label: Nested groups
   :caption: Group related nodes, label the regions, and link across them.

.. sheeptext-example:: sources/nested-layout.sheeptext
   :label: Nested layout
   :caption: A column stacks the nodes inside one group. The row over the three group handles is a preference the solver cannot currently keep, so it is dropped and the groups sit side by side, top-aligned.

.. sheeptext-example:: sources/routed-path.sheeptext
   :label: Routed path
   :caption: Route a connector along explicit orthogonal segments.

Showcases
---------

Larger diagrams of the kind SheepText is for: a request path across cloud
services, an incident-response flow, a fan-out with reply routes, pipelines
whose failure edges run backwards. Each is rendered here at build time from
its checked-in source by the same engine the editor runs, with no coordinates
and no per-diagram tuning in the source. The list below is the published
catalog itself, not a copy of it — the showcases the catalog also offers in
the editor's picker. A showcase the engine cannot currently lay out is named
in the repository's accepted-failure inventory with an owner task and is left
off this page until that task closes.

.. sheeptext-catalog-gallery:: showcase editor