ドキュメント ​

「ドキュメント」は .gg ファイル内で、アイコン・コネクタ・リージョン・ ノート以外の部分 — つまり 図版全体の設定（cols / rows / テーマ / icons など）を、1 つまたは複数の doc { … } ステートメントで運ぶ 層です。

doc { … } ステートメント ​

doc {
  cols: 3, rows: 3,
  theme: { primary: '#1e3a5f', accent: '#e8792f' },
  icons: {
    logo: './assets/logo.svg',
  },
}

中身は厳密な JSON ではなく JSON5。以下が使えます：

• アンクオートキー — cols: 3 で OK（"cols" 不要）
• 末尾カンマ — リスト・オブジェクトの末尾に , を置ける
• // コメント — // JSON5 のコメント
• シングルクォート文字列 — '#1e3a5f' も "…" も可

厳密な JSON は JSON5 の真部分集合なので、既存の JSON はそのまま通ります。

1 ファイルに複数 doc ​

同じ .gg 内に doc ブロックをいくつ置いても構いません。ファイル上の 出現順に合体され、後勝ち になります。配列は concat、スカラーと オブジェクトはディープマージ：

doc { cols: 4 }

# … DSL …

doc {
  theme: { accent: '#d97706' },
}

最終的な DiagramDef には cols と theme.accent の両方が反映 されます。詳細な規則は マージ 参照。

5 つのコマンド ​

.gg の各行は次のキーワードから始まります（コネクタを除く — コネクタは <id> <arrow> <id> の形）：

コネクタはキーワードで始まりません。Gridgram は 2 番目のトークンが 矢印かどうかで判定します。

doc ボディに書けるキー ​

DiagramDef の最上位フィールドはすべて受け付けます：

コメント ​

.gg は # と // による 行コメント が使えます：

# section: public layer
icon :web @A1 tabler/world "Web"   // 外部に公開

次に読む ​

• グリッド — cols / rows / cellSize / 自動推論
• マージ — 複数 doc ブロック、ディープマージ、 DSL と JSON の使い分け