Add quarto-website (#115)

Author: cgraham-rs

.github/workflows/extensions.yml

@@ -32,6 +32,7 @@ jobs:
             reaper: extensions/reaper/**
             integration-session-manager: extensions/integration-session-manager/**
             quarto-stock-report-python: extensions/quarto-stock-report-python/**
+            quarto-website: extensions/quarto-website/**
             portfolio-dashboard: extensions/portfolio-dashboard/**
             quarto-document: extensions/quarto-document/**
             stock-api-plumber: extensions/stock-api-plumber/**

extensions/quarto-website/.gitignore

@@ -0,0 +1,7 @@
+/.quarto/
+*.html
+*_files
+/env/
+_site
+featured.yaml
+all.yaml

extensions/quarto-website/README.md

@@ -0,0 +1,18 @@
+# Quarto Website
+
+## About this example
+
+This Quarto website uses the Posit Connect Server API together with Python to construct a dashboard that presents published content. Views showing featured and all content are included.
+
+Set the `FEATURED_TAGS` environment variable and feature content having a
+particular tag name.
+
+
+## Learn more
+
+* [Quarto](https://quarto.org)
+* [Posit Connect API Reference](https://docs.posit.co/connect/api/)
+
+## Requirements
+
+* Python version 3.8 or higher

extensions/quarto-website/_quarto.yml

@@ -0,0 +1,21 @@
+project:
+  type: website
+  pre-render: prepare.py
+
+website:
+  title: Content Dashboard
+  navbar:
+    left:
+      - text: "Featured"
+        href: "index.qmd"
+      - text: "All"
+        href: "all.qmd"
+      - text: "About"
+        href: "about.qmd"
+
+format:
+  html: default
+
+theme:
+  light: flatly
+  dark: darkly

extensions/quarto-website/about.qmd

@@ -0,0 +1,21 @@
+---
+title: About
+---
+
+This [Quarto Website](https://quarto.org/docs/websites/) shows how the [Posit
+Connect Server API](https://docs.posit.co/connect/api/) can combine with
+[Quarto Listings](https://quarto.org/docs/websites/website-listings.html) to
+create dashboards that highlight your content.
+
+```{python}
+#| echo: false
+#| output: asis
+
+import yaml
+with open("featured.yaml", "r") as f:
+    featured = len(yaml.safe_load(f))
+with open("all.yaml", "r") as f:
+    listing = len(yaml.safe_load(f))
+
+print(f"This dashboard presents {featured} featured content items with {listing} total items.")
+```

extensions/quarto-website/all.qmd

@@ -0,0 +1,11 @@
+---
+title: All Content
+listing:
+  contents: all.yaml
+  type: table
+  fields:
+    - date
+    - title
+    - author
+  max-items: 200
+---