docs: publish Sourcey C API reference

.github/workflows/deploy.yml

@@ -22,6 +22,13 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Checkout pinned libamtrack source
+        uses: actions/checkout@v7
+        with:
+          repository: libamtrack/library
+          ref: ef78da9ac3342dadbc1854df9534d45ccaeeb3c9
+          path: .sourcey/library
+
       - name: Set up Node.js
         uses: actions/setup-node@v7
         with:
@@ -31,6 +38,20 @@ jobs:
       - name: Install dependencies
         run: yarn install --frozen-lockfile
 
+      - name: Install Doxygen
+        run: sudo apt-get update && sudo apt-get install --yes doxygen
+
+      - name: Prepare the C API source
+        run: yarn prepare:api
+
+      - name: Generate Doxygen XML
+        working-directory: .sourcey/library
+        run: |
+          (cat Doxyfile; printf '\nOUTPUT_DIRECTORY = doxygen-sourcey\nCREATE_SUBDIRS = NO\nGENERATE_XML = YES\nGENERATE_HTML = NO\nWARN_AS_ERROR = NO\nINPUT = include sourcey-groups.dox\n') | doxygen -
+
+      - name: Build the Sourcey C API reference
+        run: yarn build:api
+
       - name: Build the site
         run: yarn build
 

.gitignore

@@ -240,4 +240,8 @@ dist
 
 # End of https://www.toptal.com/developers/gitignore/api/node,visualstudiocode,docusaurus
 
-venv
+venv
+
+# Sourcey build inputs and generated API reference
+.sourcey/
+/static/api/

docusaurus.config.ts

@@ -64,6 +64,11 @@ const config: Config = {
           position: 'left',
           label: 'C Library',
         },
+        {
+          href: 'https://libamtrack.github.io/api/',
+          label: 'C API Reference',
+          position: 'left',
+        },
         {
           type: 'docSidebar',
           sidebarId: 'pythonSidebar',