feat(datasheet): add typst datasheet flow

This is a squash of 5 commits in order to add the new datasheet flow.

fix(datasheet): ensure datasheet can use images properly

fix(datasheet): white page when funding was not specified

This was caused by creating a page before first checking whether there was any content for that page beforehand, so it would result in a rogue white page with no content.

fix(datasheet): missing analog pin tables

fix(datasheet): tweak pandoc settings

Switching from `gfm` to `markdown` should enable more formatting options. The extensions have been configured to be similar to `gfm` but provide some additional things, like `line_blocks` and `lists_without_preceding_blankline`s.

project.py

@@ -17,6 +17,7 @@ from git.repo import Repo
 
 import git_utils
 from cells import Cell, load_cells
+from doc_utils import DocsHelper
 from markdown_utils import limit_markdown_headings
 from project_info import ProjectInfo, ProjectYamlError
 
@@ -590,8 +591,7 @@ class Project:
             logging.error("Missing 'How to test' section in docs/info.md")
             exit(1)
 
-    # use pandoc to create a single page PDF preview
-    def create_pdf(self):
+    def create_project_datasheet(self, template_version: str):
         template_args = copy.deepcopy(self.info.__dict__)
         template_args.update(
             {
@@ -616,32 +616,45 @@ class Project:
             }
         )
 
-        logging.info("Creating PDF")
-        with open(os.path.join(SCRIPT_DIR, "docs/project_header.md")) as fh:
-            doc_header = fh.read()
-        with open(os.path.join(SCRIPT_DIR, "docs/project_preview.md.mustache")) as fh:
-            doc_template = fh.read()
-        info_md = os.path.join(self.local_dir, "docs/info.md")
-        with open(info_md) as fh:
-            template_args["info"] = fh.read()
+        logging.info("creating project datasheet")
 
-        with open("datasheet.md", "w") as fh:
-            fh.write(doc_header)
+        with open(os.path.join(SCRIPT_DIR, "docs/user_project.typ.mustache")) as f:
+            project_template = f.read()
 
-            # now build the doc & print it
-            try:
-                doc = chevron.render(doc_template, template_args)
-                fh.write(doc)
-                fh.write("\n\\pagebreak\n")
-            except IndexError:
-                logging.warning("missing pins in info.yaml, skipping")
+        result = DocsHelper.get_docs_as_typst(
+            os.path.join(self.local_dir, "docs/info.md")
+        )
 
-        pdf_cmd = "pandoc --pdf-engine=xelatex --resource-path=docs -i datasheet.md -o datasheet.pdf"
-        logging.info(pdf_cmd)
-        p = subprocess.run(pdf_cmd, shell=True)
-        if p.returncode != 0:
-            logging.error("pdf generation failed")
-            raise RuntimeError(f"pdf generation failed with code {p.returncode}")
+        content = {
+            "template_version": template_version,
+            "project_title": template_args["title"].replace('"', '\\"'),
+            "project_author": f"({DocsHelper.format_authors(template_args['author'])})",
+            "project_repo_link": self.get_git_remote(),
+            "project_description": template_args["description"],
+            "project_address": "----",
+            "project_clock": DocsHelper.pretty_clock(self.info.clock_hz),
+            "project_type": DocsHelper.get_project_type(
+                template_args["language"], self.is_wokwi(), template_args["is_analog"]
+            ),
+            "project_doc_body": result,
+            "digital_pins": DocsHelper.format_digital_pins(template_args["pins"]),
+        }
+
+        if self.is_wokwi():
+            content["is_wokwi"] = True
+            content["project_wokwi_id"] = self.info.wokwi_id
+
+        if template_args["is_analog"]:
+            content["is_analog"] = True
+            content["analog_pins"] = DocsHelper.format_analog_pins(
+                template_args["analog_pins"]
+            )
+
+        with open(os.path.abspath(f"./docs/doc.typ"), "w") as f:
+            logging.info("writing datasheet to ./docs/doc.typ")
+            f.write(chevron.render(project_template, content))
+
+        DocsHelper.compile("./docs/doc.typ")
 
     # Read and return top-level GDS data from the final GDS file, using gdstk:
     def get_final_gds_top_cells(self):