examples,tutorial: provide default metadata

examples/metadata.yml

@@ -0,0 +1,24 @@
+metadata:
+
+  title: test
+  pn: test-01
+  company: some company
+  address: 8888 fancy street west
+
+  authors:
+    created:
+      name: bob ross
+      date: 2023-03-29
+    reviewed:
+      name: n/a
+      date: n/a
+
+  revisions:
+    a:
+      name: bob ross
+      date: 2023-03-29
+      changelog: initial release
+
+  template:
+    name: din-6771
+    sheetsize: A3

src/wireviz/tools/build_examples.py

@@ -63,9 +63,16 @@ def build_generated(groupkeys):
             with (path / readme).open("w") as out:
                 out.write(f'# {groups[key]["title"]}\n\n')
         # collect and iterate input YAML files
+
         for yaml_file in collect_filenames("Building", key, input_extensions):
             try:
-                res = cli(["--formats", "ghpst", str(yaml_file)])
+                res = cli([
+                    "--formats",
+                    "ghpst",
+                    str(yaml_file),
+                    "--prepend",
+                    yaml_file.parent / "metadata.yml"
+                ])
             except BaseException as e:
                 if str(e) != "0" and not isinstance(
                     e, (click.ClickException, SystemExit)

tutorial/metadata.yml

@@ -0,0 +1,24 @@
+metadata:
+
+  title: test
+  pn: test-01
+  company: some company
+  address: 8888 fancy street west
+
+  authors:
+    created:
+      name: bob ross
+      date: 2023-03-29
+    reviewed:
+      name: n/a
+      date: n/a
+
+  revisions:
+    a:
+      name: bob ross
+      date: 2023-03-29
+      changelog: initial release
+
+  template:
+    name: din-6771
+    sheetsize: A4