"
+ markup = markup .. "
"
+
+ if (title ~= nil and title ~= "") then
+ markup = markup .. "
"
+ markup = markup .. title
+ markup = markup .. "
"
+ end
+
+ markup = markup .. "
"
+
+ return pandoc.RawInline("html", markup)
+ else
+ return pandoc.Null()
+ end
+ end,
+
+ ["callout_end"] = function(args, kwargs, meta)
+ if quarto.doc.is_format("html:js") then
+ local markup = "
"
+
+ local icon_variant_map = {
+ ['success'] = 'check-circle',
+ ['info'] = 'info-circle',
+ ['warning'] = 'exclamation-triangle',
+ ['danger'] = 'exclamation-octagon'
+ }
+
+ local selected_icon = nil
+
+
+ if (logo ~= nil and logo ~= "") then
+ markup = markup .. '
'
+ end
+
+ if (title ~= nil and title ~= "") then
+ markup = markup .. "
"
+ markup = markup .. title
+ markup = markup .. "
"
+ end
+
+ if (useIcons == "true") then
+ if (variant ~= nil and variant ~= "") then
+ selected_icon = icon_variant_map[variant]
+ if selected_icon ~= nil then
+ markup = markup .. '
'
+ end
+ end
+ end
+
+ markup = markup .. "
"
+
+
+ return pandoc.RawInline("html", markup)
+ else
+ return pandoc.Null()
+ end
+ end,
+
+ ["card_end"] = function(args, kwargs, meta)
+ if quarto.doc.is_format("html:js") then
+ local markup = "
"
+ if (variant ~= nil) then
+ selected_icon = icon_variant_map[variant]
+ if selected_icon ~= nil then
+ markup = markup .. '
'
+ end
+ end
+
+ markup = markup .. "
"
+
+ if (title ~= nil) then
+ markup = markup .. ""
+ markup = markup .. title
+ markup = markup .. ""
+ end
+
+ return pandoc.RawInline("html", markup)
+ else
+ return pandoc.Null()
+ end
+ end,
+
+ ["inline_alert_end"] = function(args, kwargs, meta)
+ if quarto.doc.is_format("html:js") then
+ local markup = "
+
+### Pull Request Details
+
+- The pull request should be created against the `main` branch. This can be accomplished by either checking out the
+ repository locally and making changes with the `git` command line or desktop tools, or via Github's web interface
+ using the [upload tool](https://github.com/bcgov/nr-epd-aq-statements/upload/main).
+- Regardless of the method for creating the pull request, it should include three files:
+ - `map.html`
+ - dated markdown file (eg `2025-02-06_Smoky-Skies_Issue.md`)
+ - corresponding PDF file (eg `2025-02-06_Smoky-Skies_Issue.pdf`)
+- The files should be contributed to the project in the directory `frontend/statements/YYYY-MM/DD`. Separating the files
+ in this way ensures that `map.html` is not overwritten (since each statement has a corresponding map file and its name
+ is not easily changed).
+- If more than one statement is created on a given day, consider creating them in further subfolders with a meaninful
+ name, such as the region or the hour of issue.
+
+## Updating or Removing an Advisory
+
+### Updating an existing Advisory
+
+To update an existing advisory, follow the same steps as above to regenerate the advisory and create a pull request that
+**overwrites** the files you wish to edit. After the pull request is merged and the site rebuilt, the content will be
+updated.
+
+You may also create a pull request manually with the Github website if you wish to manually update specific wording
+within a statement, advisory, or bulletin. Be aware that you can only edit the generated `html` content this way, and
+that corresponding `pdf`s are passed through unmodified (so if you need to change a PDF too, you must make the change by
+editing the template in the Shiny app before exporting it),
+
+### Removing an Advisory
+
+To remove an advisory, create a pull request against the main branch that deletes the three files (markdown, pdf,
+and `map.html`). When the site is rebuilt, the content will be removed and will not be accessible via any listings or
+even directly by the URL.
diff --git a/doc/UPDATING_STATIC_CONTENT.md b/doc/UPDATING_STATIC_CONTENT.md
new file mode 100644
index 0000000..23c865f
--- /dev/null
+++ b/doc/UPDATING_STATIC_CONTENT.md
@@ -0,0 +1,23 @@
+# Updating Static Content
+
+## Content
+
+There are four pages that provide base content for the static site. They are:
+
+- `index.qmd` - the home page
+- `measuring.qmd` - 'Measuring air quality' document
+- `shortcode_demos.qmd` (provided as an example)
+- `statements.qmd` - A dynamic list of historic statements. Contents are generated automatically based on the contents
+ of the preamble ([Quarto Custom Listings](https://quarto.org/docs/websites/website-listings-custom.html))
+
+These four documents are written in QMD format and can be edited via Github Pull Request against the `main` branch.
+
+You can add or remove content as required to edit the static content of the site. Create, edit, or delete files with
+a `.qmd` extension in the `frontend` directory. Any file whose name starts with an underscore `_` will be ignored by
+Quarto during the rendering step.
+
+## Navigation
+
+You may wish to add, remove, or reorder the contents of the site navigation top bar or sidebar. They will not be updated
+automatically if you add or delete static content files. These elements are defined in the
+file `_extensions/bcds/_extension.yaml` under the key `contributes.project.website`.
diff --git a/frontend/.gitignore b/frontend/.gitignore
new file mode 100644
index 0000000..ddfa4f0
--- /dev/null
+++ b/frontend/.gitignore
@@ -0,0 +1,9 @@
+/.quarto/
+
+/env/
+
+_recent_statements.yaml
+_ssb.yaml
+
+# for local testing
+Caddyfile
diff --git a/frontend/Caddyfile b/frontend/Caddyfile
new file mode 100644
index 0000000..8af0e41
--- /dev/null
+++ b/frontend/Caddyfile
@@ -0,0 +1,23 @@
+{
+ auto_https off
+}
+:3000
+
+root * _site
+file_server
+
+log {
+ level WARN
+}
+encode gzip
+
+route {
+ header /* Cache-Control max-age=3
+}
+
+route {
+ try_files {path} /index.html
+ header /index.html {
+ Cache-Control max-age=0,no-cache,no-store,must-revalidate
+ }
+}
diff --git a/frontend/_aqs_listing.ejs b/frontend/_aqs_listing.ejs
new file mode 100644
index 0000000..759e1d0
--- /dev/null
+++ b/frontend/_aqs_listing.ejs
@@ -0,0 +1,26 @@
+```{=html}
+<% if (items.length > 0) { %>
+