@rse/gradia 1.1.3 → 1.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +42 -34
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -256,24 +256,32 @@ type is silently ignored. Without both, the type defaults to `graph`.
|
|
|
256
256
|
A `#config` directive sets one of the rendering options, which otherwise
|
|
257
257
|
are settable through the corresponding `--config <option>=<value>`
|
|
258
258
|
command-line options (`font-embed` being command-line only, see below).
|
|
259
|
-
The recognized options are:
|
|
259
|
+
The recognized options, and their default values, are:
|
|
260
260
|
|
|
261
261
|
```
|
|
262
|
-
font-family
|
|
263
|
-
font-embed
|
|
264
|
-
color-node-regular-name
|
|
265
|
-
color-node-regular-box
|
|
266
|
-
color-node-regular-border
|
|
267
|
-
color-node-primary-name
|
|
268
|
-
color-node-primary-box
|
|
269
|
-
color-node-primary-border
|
|
270
|
-
color-node-ghost-name
|
|
271
|
-
color-node-ghost-box
|
|
272
|
-
color-node-ghost-border
|
|
273
|
-
color-group-name
|
|
274
|
-
color-group-box
|
|
275
|
-
color-group-border
|
|
276
|
-
color-edge-line
|
|
262
|
+
font-family Helvetica size-edge-hop-radius 8
|
|
263
|
+
font-embed false size-edge-track-gap 12
|
|
264
|
+
color-node-regular-name #336699 size-edge-port-gap 24
|
|
265
|
+
color-node-regular-box #e0f0ff group-box-padding 30
|
|
266
|
+
color-node-regular-border #c0d0e0 group-box-gap 40
|
|
267
|
+
color-node-primary-name #ffffff graph-columns-max 4
|
|
268
|
+
color-node-primary-box #336699 graph-channel-width-max 140
|
|
269
|
+
color-node-primary-border #003366 graph-channel-width-min 24
|
|
270
|
+
color-node-ghost-name #666666 graph-gutter-height-max 90
|
|
271
|
+
color-node-ghost-box #f0f0f0 graph-gutter-height-min 20
|
|
272
|
+
color-node-ghost-border #a0a0a0 graph-node-separation 30
|
|
273
|
+
color-group-name #6699cc graph-rank-separation 60
|
|
274
|
+
color-group-box #f4f8fc graph-node-degree-max 3
|
|
275
|
+
color-group-border #c0d0e0 hub-channel-width-max 340
|
|
276
|
+
color-edge-line #999999 hub-channel-width-min 240
|
|
277
|
+
color-edge-name #333333 hub-node-gap 20
|
|
278
|
+
color-edge-arity #333333 hub-node-degree-max 3
|
|
279
|
+
color-edge-halo #ffffff grid-columns-max 4
|
|
280
|
+
size-canvas-margin 40 grid-columns-min 3
|
|
281
|
+
size-node-width-min 220 grid-gap-horizontal 40
|
|
282
|
+
size-node-width-max 0 grid-gap-vertical 20
|
|
283
|
+
size-node-height-scale 2.25 grid-node-width-equal true
|
|
284
|
+
size-edge-corner-radius 20
|
|
277
285
|
```
|
|
278
286
|
|
|
279
287
|
The `size-*`, `group-*`, `graph-*`, `hub-*`, and `grid-*` options
|
|
@@ -285,17 +293,17 @@ The `size-node-width-max` option additionally enables the word-wrapping
|
|
|
285
293
|
of the node box texts: given a positive value, the node name, its type,
|
|
286
294
|
and its attribute lines are greedily broken at whitespace so that the
|
|
287
295
|
node box stays within the given width and grows in height instead. The
|
|
288
|
-
|
|
296
|
+
value `0` disables the wrapping entirely and hence lets a node box
|
|
289
297
|
become as wide as its longest text. A single word wider than the
|
|
290
298
|
maximum is never broken and still widens the box beyond the maximum.
|
|
291
299
|
|
|
292
|
-
The `size-edge-port-gap` option
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
300
|
+
The `size-edge-port-gap` option controls the distance of the edge
|
|
301
|
+
attachment ports along a node side, and hence the vertical distance of
|
|
302
|
+
the parallel edges and their labels. It is a *maximum*: a node box too
|
|
303
|
+
small to hold all its ports at that distance packs them closer together
|
|
304
|
+
instead. A node side carrying more edges than `graph-node-degree-max`
|
|
305
|
+
respectively `hub-node-degree-max` grows its box height by this very
|
|
306
|
+
distance per additional edge.
|
|
299
307
|
|
|
300
308
|
The `graph-channel-width-*` and `graph-gutter-height-*` options control
|
|
301
309
|
the spacing of a `graph` diagram: its inter-column channels and
|
|
@@ -303,21 +311,21 @@ inter-row gutters are sized by the edges routed through them and by the
|
|
|
303
311
|
edge labels landing inside them -- a channel by the widest label demand
|
|
304
312
|
it has to hold (an edge name placed along it, or an edge arity set back
|
|
305
313
|
from its arrow head), a gutter by one text line per edge name placed
|
|
306
|
-
along its run. The `-min` options
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
314
|
+
along its run. The `-min` options raise the result, so that even an
|
|
315
|
+
unlabeled diagram can be spaced out, while the `-max` options cap it, so
|
|
316
|
+
that neither many parallel edges nor a long label can push the nodes
|
|
317
|
+
apart without bound.
|
|
310
318
|
|
|
311
319
|
The `grid-columns-min` and `grid-columns-max` options control the column
|
|
312
320
|
count of a `grid` diagram, which by default is derived from the node
|
|
313
|
-
count as a roughly square grid: `grid-columns-min`
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
321
|
+
count as a roughly square grid: `grid-columns-min` raises the derived
|
|
322
|
+
count, so that a few nodes still share a single row instead of being
|
|
323
|
+
stacked, while `grid-columns-max` caps it, so that larger diagrams grow
|
|
324
|
+
in height only. The column count never exceeds the node count and the
|
|
325
|
+
maximum always wins over the minimum.
|
|
318
326
|
|
|
319
327
|
The `grid-node-width-equal` option controls the tile widths of a `grid`
|
|
320
|
-
diagram:
|
|
328
|
+
diagram: the value `true` forces all node boxes to the width of the
|
|
321
329
|
widest one and hence yields a strictly regular grid, while `false` lets
|
|
322
330
|
each column become only as wide as its own widest node box.
|
|
323
331
|
|
package/package.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"description": "Object Graph Diagram Rendering",
|
|
4
4
|
"keywords": [ "object", "graph", "diagram", "rendering", "svg", "layout", "api", "cli" ],
|
|
5
5
|
"publishConfig": { "access": "public" },
|
|
6
|
-
"version": "1.1.
|
|
6
|
+
"version": "1.1.4",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"author": {
|
|
9
9
|
"name": "Dr. Ralf S. Engelschall",
|