docs: use latest quartodoc to make description lists

posit-dev · Aug 30, 2024 · d406b43 · d406b43
1 parent 11660a6
commit d406b43
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/.github/workflows/ci-docs.yaml b/.github/workflows/ci-docs.yaml
@@ -2,7 +2,7 @@ on:
   push:
     branches:
       - main
-      - 'docs-preview-**'
+      - "docs-preview-**"
   pull_request:
     branches:
       - main
@@ -19,6 +19,7 @@ jobs:
           python-version: "3.10"
       - name: Install dependencies
         run: |
+          python -m pip install git+https://github.com/machow/quartodoc.git
           python -m pip install ".[all]"
       - uses: quarto-dev/quarto-actions/setup@v2
       - name: Build docs

diff --git a/docs/_quarto.yml b/docs/_quarto.yml
@@ -50,7 +50,9 @@ website:
 format:
   html:
     theme: cosmo
-    css: styles.css
+    css:
+      - styles.css
+      - reference/_styles-quartodoc.css
     toc: true
     page-layout: full
 
@@ -72,8 +74,12 @@ quartodoc:
   dir: reference
   title: API Reference
   style: pkgdown
+  css: reference/_styles-quartodoc.css
   dynamic: true
   render_interlinks: true
+  renderer:
+    style: markdown
+    table_style: description-list
   sections:
     - title: Table Creation
       desc: >