Icons
=====

Import an icon pack with ``use icons``, then place an icon with
``pack:name``. The ``aws`` pack ships with SheepText, so it works offline:

.. sheeptext::
   :alt: A single AWS server icon

   use icons aws
   icon aws:server

An icon is a shape like any other: give it a caption, a ``size`` (in units),
and a position:

.. sheeptext::
   :alt: A database icon captioned Primary DB positioned on the canvas

   use icons aws
   icon aws:database "Primary DB" size 64 at (120, 80)

The bundled ``aws`` pack includes ``server``, ``database``, ``users``,
``client``, ``lambda``, ``amazon-api-gateway``, and ``amazon-rekognition``.

Use ``labelside`` to place an icon's caption on a chosen side — ``top`` keeps a
row of icons tidy by lifting every label clear of the connecting arrows:

.. sheeptext::
   :alt: A users icon with its caption placed above it

   use icons aws
   icon aws:users labelside top "Users"

Because icons are shapes, name them and connect them with arrows — combine that
with automatic layout and a diagram assembles itself:

.. sheeptext::
   :alt: Users icon connected to an API Gateway icon connected to a Lambda handler icon left to right with captions above each

   use icons aws
   layout direction right
   U: icon aws:users labelside top "Users"
   G: icon aws:amazon-api-gateway labelside top "API Gateway"
   F: icon aws:lambda labelside top "Handler"
   arrow from U to G
   arrow from G to F

Next: reuse values with :doc:`variables`.