move from sphinx to quartodoc

Author: isabelizimm

.github/workflows/docs.yml

@@ -21,28 +21,30 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           python -m pip install -e .[dev]
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
       - name: build docs
         run: |
           make docs
       - name: save docs
         uses: actions/upload-artifact@v3
         with:
           name: docs-html
-          path: docs/_build/html/
+          path: docs/_site/
       - name: publish dev docs
         if: github.ref_name == 'main' && github.ref_type == 'branch'
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/_build/*
+          publish_dir: docs/_site/*
           publish_branch: gh-pages
           destination_dir: main
       - name: publish stable docs
         if: github.ref_type == 'tag' && startswith(github.ref, 'refs/tags/v')
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/_build/*
+          publish_dir: docs/_site/*
           publish_branch: gh-pages
           destination_dir: ${{ github.ref_name }}
       - name: create symlink stable to new version

.gitignore

@@ -142,3 +142,5 @@ NOTES.md
 ## RStudio
 *.Rproj
 .Rproj.user
+
+/.quarto/

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 
 
-exclude: "(.*\\.csv)|(^examples/)|(^vetiver/tests/snapshots/)"
+exclude: "(.*\\.csv)|(^examples/)|(^vetiver/tests/snapshots/)|(^docs/_extensions/*)"
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v2.4.0

Makefile

@@ -71,8 +71,9 @@ docs-clean:
 	$(MAKE) -C docs clean
 
 docs doc documentation:
-	$(MAKE) -C docs html
-	$(BROWSER) docs/_build/html/index.html
+	python -m quartodoc build
+	python -m quartodoc interlinks
+	quarto render
 
 release: dist
 	twine upload dist/*

docs/.gitignore

@@ -0,0 +1,5 @@
+/.quarto/
+/_site/
+objects.json
+/_sidebar.yml
+/reference

docs/_extensions/machow/interlinks/.gitignore

@@ -0,0 +1,3 @@
+*.html
+*.pdf
+*_files/

docs/_extensions/machow/interlinks/README.md

@@ -0,0 +1,30 @@
+# Interlinks Extension For Quarto
+
+_TODO_: Add a short description of your extension.
+
+## Installing
+
+_TODO_: Replace the `<github-organization>` with your GitHub organization.
+
+```bash
+quarto add <github-organization>/interlinks
+```
+
+This will install the extension under the `_extensions` subdirectory.
+If you're using version control, you will want to check in this directory.
+
+## Using
+
+_TODO_: Describe how to use your extension.
+
+## Example
+
+Here is the source code for a minimal example: [example.qmd](example.qmd).
+
+## Developing
+
+To see the AST the filter operates on, use this command:
+
+```
+quarto render example.qmd --to native --output -
+```

docs/_extensions/machow/interlinks/_extension.yml

@@ -0,0 +1,7 @@
+title: Interlinks
+author: Michael Chow
+version: 1.0.0
+quarto-required: ">=1.2.0"
+contributes:
+  filters:
+    - interlinks.py

docs/_extensions/machow/interlinks/example.qmd

@@ -0,0 +1,29 @@
+---
+title: "Interlinks Example"
+filters:
+  - interlinks.py
+interlinks:
+  sources:
+    siuba:
+      url: https://siuba.org/
+      inv: null
+      fallback: objects_siuba.json
+    vetiver:
+      url: https://vetiver.rstudio.com/
+      inv: null
+      fallback: objects_vetiver.json
+---
+
+## Heading {#sec-hello}
+
+## Testing
+
+
+| style | syntax | output |
+| ----- | ------ | ------ |
+| md custom text  | `[some explanation](`vetiver.SKLearnHandler`)` | [some explanation](`vetiver.SKLearnHandler`) |
+| md blank text   | `[](`vetiver.SKLearnHandler`)` | [](`vetiver.SKLearnHandler`) |
+| md blank text (~shortened)| `[](`~vetiver.SKLearnHandler`)` | [](`~vetiver.SKLearnHandler`) |
+| rst custom text | `` :ref:`some explanation <vetiver.SKLearnHandler>` `` | :ref:`some explanation <vetiver.SKLearnHandler>` |
+| rst blank text  | `` :ref:`vetiver.SKLearnHandler` `` | :ref:`vetiver.SKLearnHandler` |
+| rst blank text (~shortened) | `` :ref:`~vetiver.SKLearnHandler` `` | :ref:`~vetiver.SKLearnHandler` |