Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Styles

A style decides how a drawing is inked: line weights, corners and lettering. This page shows the three styles and how to choose one. You can skip it until you want a different look.

StyleLook
pens (default)Three pen weights in one warm black, text in bold, regular and a softer grey
plainOne ink, one line width, one text weight; only font sizes differ
letteringThe pens of pens, with all text lettered in single pen strokes

Choose a style with a style <name> statement in the file, or with --style <name> on the command line, which wins over the statement:

drumlin render station.uml -o station.svg --style plain

Styles apply to all five diagram kinds. Like direction and layout, the statement may stand on any line, and the last one wins. An unknown name is an error that lists the styles. An element may still be called style: only style followed by a name is the statement.

pens

pens is the default; every diagram in this book that names no style uses it. It inks with three pen weights in one warm black (#22201c): a heavy pen for boxes that hold other boxes, a medium pen for ordinary boxes, symbols and solid lines, and a fine pen for dashed lines, notes and small details. Bends are sharp. Names are bold; keywords such as «service» are a step smaller in a warm grey, as are notes, so the names stand out. Draw with three pens says which pen draws what.

diagram component "style pens"
style pens

component "Weather Station" as station {
  component Sensors
  component Logger
  Sensors --> Logger : samples
}
component Forecast <<service>> { provides IForecast }
component Display { requires IForecast }
component Archive <<database>>
Logger --> Forecast : readings
Logger ..> Archive : nightly
note Logger: Keeps 30 days of readings.
style pens Weather Station Sensors Logger Keeps 30 days of readings. «service» Forecast Display «database» Archive IForecast samples readings nightly

plain

plain is as plain as a drawing gets: one black ink, one line width for every outline and line, and regular text throughout, with only the font size changing between names and small text. Bends are sharp. Compare the same diagram above in pens.

diagram component "style plain"
style plain

component "Weather Station" as station {
  component Sensors
  component Logger
  Sensors --> Logger : samples
}
component Forecast <<service>> { provides IForecast }
component Display { requires IForecast }
component Archive <<database>>
Logger --> Forecast : readings
Logger ..> Archive : nightly
note Logger: Keeps 30 days of readings.
style plain Weather Station Sensors Logger Keeps 30 days of readings. «service» Forecast Display «database» Archive IForecast samples readings nightly

lettering

lettering keeps the pens of pens and letters every piece of text in single pen strokes, as a draftsman letters a drawing with a lettering guide: names and the title in spaced capitals, labels and notes in upright mixed case, and a pen for each size: heaviest for the title, finest for keywords. See Letter with a pen per size.

diagram component "style lettering"
style lettering

component "Weather Station" as station {
  component Sensors
  component Logger
  Sensors --> Logger : every 10 s
}
component Forecast <<service>> { provides IForecast }
component Display { requires IForecast }
component Archive <<database>>
Logger --> Forecast : readings
Logger ..> Archive : nightly
note Logger: Keeps 30 days of readings, 1 per 10 s.
style lettering Weather Station Sensors Logger Keeps 30 days of readings, 1 per 10 s. «service» Forecast Display «database» Archive IForecast every 10 s readings nightly

Things to know about lettering:

  • The letters are drawn as paths, not set as text, so a browser cannot select them or find them with search. Each run of text keeps its words as an accessible name (aria-label) for screen readers.
  • The lettering covers ASCII, Latin-1, much of Latin Extended-A, common punctuation, arrows and super- and subscript digits. Any other character is drawn as an open box.
  • Files are about three to four times the size of the same drawing in pens.
  • The glyphs are drumlin’s lettering, derived from Routed Gothic by Darren Embry and licensed under the SIL Open Font License 1.1.

What a style changes

pens and plain change only the strokes and the colour of the marks: every box, line and label stays where the layout put it. lettering sizes boxes, labels and notes for its own letters, so its drawing may be laid out a little differently.