DEV Community

Cover image for What Graphium can do 02: Wrap one piece of work in a step, and the order of your procedure becomes a diagram
Masaya Kumagai
Masaya Kumagai

Posted on Edited on

What Graphium can do 02: Wrap one piece of work in a step, and the order of your procedure becomes a diagram

Issue 01 was about marks that turn into a diagram. This issue is about the container those marks live in: the step block.

Baking bread is a run of actions: knead, proof, bake. A step is the editor's only container. It holds the text, tables and images of one action, and each step becomes one action in the diagram. Link steps with the Prev step chip in the header and the Next step chip at the bottom, and that order becomes the arrows in the graph.

The order of a procedure tends to blur when it is only prose. So I made it enough to wrap each action in a container and chain them, which keeps the order as structure. Outside a step, I kept Graphium a plain, quiet editor.

A step block with a Prev step chip in the header and a Next step chip at the bottom

A step can also have stages. Write two or more rows in the parameter table, and each row becomes a stage. Baking with the temperature raised in three stages is one step with three stages, not three steps. My rule of thumb: split into steps when something is taken out or put in along the way, and add a stage when only the conditions change. The Add stage button adds the next row.

A step with three stages and the parameter table below it

Details are in the manual: Labels & provenance. Step blocks have been there since v0.23.0 (2026-07-28); stages since v0.60.0 (2026-09-08).
GitHub: https://github.com/kumagallium/Graphium

Top comments (0)