Split up API reference (#277)

Addresses #275. Basically just needed to get the existing gen_ref_nav.py
to work again with sub-packages.

Author: david-pl

.github/pull_bloqade_submodules/action.yml

@@ -0,0 +1,34 @@
+name: 'Pull bloqade submodules'
+description: 'Composite action to pull in the git repositories of bloqade-* submodules at the latest version tags compatible with bloqade. They are put in a directory called submodules'
+runs:
+    using: "composite"
+    steps:
+      - name: extract bloqade-circuit version
+        id: bloqade_circuit_extract_version
+        shell: bash
+        run: |
+          VERSION=$(uv pip show bloqade-circuit | awk '/^Version: / {print "v"$2}')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: clone the latest bloqade-circuit release
+        id: clone_bloqade_circuit
+        uses: actions/checkout@v5
+        with:
+          repository: QuEraComputing/bloqade-circuit
+          path: 'submodules/bloqade-circuit'
+          ref: ${{ steps.bloqade_circuit_extract_version.outputs.version }}
+
+      - name: Extract bloqade-analog version
+        id: bloqade_analog_extract_version
+        shell: bash
+        run: |
+          VERSION=$(uv pip show bloqade-analog | awk '/^Version: / {print "v"$2}')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: clone the latest bloqade-analog release
+        id: clone_bloqade_analog
+        uses: actions/checkout@v5
+        with:
+          repository: QuEraComputing/bloqade-analog
+          path: 'submodules/bloqade-analog'
+          ref: ${{ steps.bloqade_analog_extract_version.outputs.version }}

.github/workflows/devdoc.yml

@@ -25,6 +25,10 @@ jobs:
           cache-dependency-glob: "uv.lock"
       - name: Install Documentation dependencies
         run: uv sync --group doc
+
+      - name: Pull bloqade submodules
+        uses: ./.github/pull_bloqade_submodules
+
       - name: Set up build cache
         uses: actions/cache@v4
         id: cache

.github/workflows/doc-nightly.yml

@@ -24,6 +24,9 @@ jobs:
       - name: Install Documentation dependencies
         run: uv sync --group doc
 
+      - name: Pull bloqade submodules
+        uses: ./.github/pull_bloqade_submodules
+
       - name: Set up build cache
         uses: actions/cache@v4
         id: cache

.github/workflows/doc.yml

@@ -16,15 +16,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
+
       - name: Install uv
         uses: astral-sh/setup-uv@v6
         with:
           # Install a specific version of uv.
           version: "0.5.1"
           enable-cache: true
           cache-dependency-glob: "uv.lock"
+
       - name: Install Documentation dependencies
         run: uv sync --group doc
+
+      - name: Pull bloqade submodules
+        uses: ./.github/pull_bloqade_submodules
+
       - name: Set up build cache
         uses: actions/cache@v4
         id: cache