convert website to quarto

Author: ernestguevarra

.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+on:
+  workflow_dispatch:
+  push:
+    branches: main
+
+name: Quarto Publish
+
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+
+      - name: Install R
+        uses: r-lib/actions/setup-r@v2
+        with:
+          r-version: '4.4.2'
+
+      - name: Install R Dependencies
+        uses: r-lib/actions/setup-renv@v2
+        with:
+          cache-version: 1
+
+      - name: Render and Publish
+        uses: quarto-dev/quarto-actions/publish@v2
+        with:
+          target: gh-pages
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test-render.yml

@@ -0,0 +1,55 @@
+name: Test website render
+
+on:
+  pull_request:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  test-render:
+    runs-on: ubuntu-latest
+    container: rocker/tidyverse:4.4.2
+    env:
+      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install system dependencies
+        run: |
+          apt-get update && apt-get install -y --no-install-recommends \
+          libxt6 libglpk-dev gh curl jq
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        with:
+          tinytex: true
+
+      - name: Install packages from renv.lock (with cache)
+        if: ${{ !env.ACT }}  
+        uses: r-lib/actions/setup-renv@v2
+        with:
+          cache-version: 2
+
+      - name: Install packages from renv.lock (local, no cache)
+        if: ${{ env.ACT }}  
+        run: |
+          renv::restore()
+        shell: Rscript {0}
+        
+      - name: Render document
+        run: quarto render
+
+      - name: Deploy to Netlify
+        uses: nwtgck/[email protected]
+        with:
+          publish-dir: './_site'
+          production-branch: main
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-message:
+            'Deploy from GHA: ${{ github.event.pull_request.title || github.event.head_commit.message }} (${{ github.sha }})'
+          # these default to 'true'
+          enable-commit-comment: false
+          enable-github-deployment: false
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

.gitignore

@@ -0,0 +1,3 @@
+/.quarto/
+
+/_site/

.gitkeep

@@ -0,0 +1,6 @@
+# RapidSurveys: Open source tools for designing, planning, implementing, and analysing rapid, reliable, and robust health and nutrition surveys. <img src="images/rapidsurveys.png" width="200px" align="right" />
+
+<!-- badges: start -->
+<!-- badges: end -->
+
+Open source project that aims to develop software tools and systems for health and nutrition surveys.

LICENSE.md

@@ -0,0 +1,8 @@
+title: Forms
+author: Jonathan Graves
+version: 1.0.0
+quarto-required: ">=1.2.0"
+contributes:
+  shortcodes:
+    - forms.lua
+

README.md

@@ -0,0 +1 @@
+/* This is for custom form CSS /*

_extensions/jlgraves-ubc/forms/_extension.yml

@@ -0,0 +1,205 @@
+-- Forms.lua
+-- Author: Jonathan Graves
+
+-- Helper Functions
+
+local function addHTMLDeps()
+  -- add the HTML requirements for the library used
+    quarto.doc.add_html_dependency({
+    name = 'forms',
+    stylesheets = {'forms.css'}
+  })
+end
+
+local function isEmpty(s)
+  return s == '' or s == nil
+end
+
+-- Main Form Function Shortcode
+
+return {
+
+["form"] = function(args, kwargs, meta)
+
+
+  if quarto.doc.is_format("html:js") then
+    -- this will only run for HTML documents
+    addHTMLDeps()
+
+    local submit_text = pandoc.utils.stringify(meta["form.submit"])
+    local action = pandoc.utils.stringify(meta["form.action"])
+    local formid = "form"
+    if not isEmpty(meta["form.id"]) then
+      form_id = pandoc.utils.stringify(meta["form.id"])
+    end
+    
+    -- If the user passes a method, use it, otherwise use GET   
+    if not isEmpty(meta["form.method"]) then
+      method = pandoc.utils.stringify(meta["form.method"])
+    else
+      method = "GET"
+    end
+
+    -- These are the form items
+    -- action (form.action) describes the handler function for the form submit
+    local form_start = "<div id = \"" .. formid .. "-div\" class = \"form-wrapper\">\n <form id = \"" .. formid .. "\" action = \"" .. action .. "\" method = \"" .. method .. "\">\n"
+    local form_end = "</form></div>\n"
+
+    -- Fields for the Form --
+    local fields = meta["form.fields"]
+
+    for f = 1, #fields do
+      
+      local field = fields[f]
+
+      local required = ""
+      if not isEmpty(field.required) and pandoc.utils.stringify(field.required) == "true" then
+        required = " required"
+      end
+
+
+      if isEmpty(field.type) and not isEmpty(field.text) then
+      -- Handle non-fields (i.e. text)
+        
+        text = pandoc.utils.stringify(field.text)
+
+        if text == "—" then
+          form_start = form_start .. "<hr>" .. "\n"
+        else
+          form_start = form_start .. "<br><p>" .. text .. "</p>\n"
+        end
+      else 
+      -- Handle regular form fields
+
+        local name = pandoc.utils.stringify(field.name)
+        local type = pandoc.utils.stringify(field.type)
+        local id = pandoc.utils.stringify(field.id)
+        local label = pandoc.utils.stringify(field.label)
+
+        if type == "text" then
+        -- Handle text fields
+
+          form_start = form_start .. "<div class=\"form-group\">\n"
+          form_start = form_start .. "<label for=\"" .. id .. "\" class = \"form-label mt-4\">" .. label .. "</label>\n"
+          form_start = form_start .. "  <input type = \"text\" id = \"" .. id .. "\" name = \"" .. name .. "\" class = \"form-control\" " .. required .. " >\n"
+          form_start = form_start .. "</div>\n"
+
+        elseif type == "textarea" then
+        -- Handle textarea fields
+          local cols = "30"
+          local rows = "10"
+
+          if not isEmpty(field.width) then
+              cols = pandoc.utils.stringify(field.width)
+          end
+
+          if not isEmpty(field.height) then
+            rows = pandoc.utils.stringify(field.height)
+          end
+          
+          form_start = form_start .. "<div class=\"form-group\">\n"
+          form_start = form_start .. "<label for =\"" .. id .. "\">" .. label .. "</label class = \"form-label mt-4\">\n"
+          form_start = form_start .. "<textarea name =\"" .. name .. "\" id = \"" .. id .. "\" rows = \"" .. rows .. "\" cols =\"" .. cols .."\" class = \"form-control\"></textarea>\n"
+          form_start = form_start .. "</div>\n"
+        
+        elseif type == "email" then
+        -- Handle email address inputs
+          form_start = form_start .. "<div class=\"form-group\">\n"
+          form_start = form_start .. "<label for=\"" .. id .. "\" class=\"form-label mt-4\">" .. label .. "</label>\n"
+          form_start = form_start .. "<input type=\"email\" id=\"" .. id .. "\" name=\"" .. "\" class=\"form-control\" " .. required .. ">\n"
+          form_start = form_start .. "</div>\n"
+
+        elseif type == "file" then
+        -- Handle file form inputs
+
+        form_start = form_start .. "<div class=\"form-group\">\n"
+        form_start = form_start .. "<label for=\"" .. id .. "\" class=\"form-label mt-4\">" .. label .. "</label>\n"
+        form_start = form_start .. "<input type=\"file\" id = \"" .. id .. "\" name=\"" .. name .. "\" class=\"form-control\" " .. required .. " >\n"
+        form_start = form_start .. "</div>\n"
+        
+        elseif type == "select" then
+        -- Handle selector (drop-downs)
+          
+          local size = "3" 
+          if not isEmpty(field.size) then
+            size =  pandoc.utils.stringify(field.size)
+          end
+
+
+          local multiple = "" 
+          if not isEmpty(field.multiple) then
+            if pandoc.utils.stringify(field.multiple) == "true" then
+              multiple = "multiple=\"\""
+            end
+          end
+
+          form_start = form_start .. "<div class=\"form-group\">\n"
+          form_start = form_start .. "<label for = \"" .. id .. "\" class=\"form-label mt-4\">" .. label .. "</label>\n"
+          form_start = form_start .. "<select id= \"" .. id .. "\" size = \"" .. size .. "\" " .. multiple .. " " .. required .. " class=\"form-select\">\n"
+          
+          for v = 1,#field.values do
+            local value = field.values[v]
+            local label_t = pandoc.utils.stringify(value.text)
+            local val = pandoc.utils.stringify(value.value)
+
+            form_start = form_start .. "  <option value = \"" .. val .. "\">" .. label_t .. "</option>\n"
+            
+          end
+
+          form_start = form_start .. "</select>\n</div>\n"
+            
+        else
+        -- Handle radio and checkboxes
+
+          local class = ""
+          local labelclass = ""
+          local checked = ""
+
+          if type == "radio" then
+            class = "form-check-input"
+            labelclass = "form-check-label"
+            checked = "checked=\"\""
+          elseif type == "checkbox" then
+            class = "form-check-input"
+            labelclass = "form-check-label"
+          end
+
+          form_start = form_start .. "<div class=\"form-group\">\n"
+          form_start = form_start .. "<fieldset class=\"form-group\">\n"
+          form_start = form_start .. "<p class = \"form-label\">" .. label .. "</p>\n"
+          for v = 1, #field.values do
+
+            local value = field.values[v]
+            -- multi-option fields need to have a label for each value
+            local label_t = "&nbsp;" .. pandoc.utils.stringify(value.text)
+            local val = pandoc.utils.stringify(value.value)
+
+            form_start = form_start .. "<div class=\"form-check\">\n"
+            form_start = form_start .. "  <input type = \"" .. type .. "\" id = \"" .. id .. v .. "\" name = \"" .. name .. "\" value =\"" .. val .. "\"" .. " class =\"" .. class .. "\" autocomplete=\"off\" " .. checked .. " " .. required .. " >\n"
+            form_start = form_start .. "  <label for=\"" .. id .. v .. "\" class=\"" .. labelclass .. "\">" .. label_t .. "</label>\n"
+            form_start = form_start .. "</div>\n"
+          end
+
+          form_start = form_start .. "</fieldset>\n</div>\n"
+
+
+        end
+
+      end
+    end
+    -- Close the form and submit
+    form_start = form_start .. "<br>\n<div class=\"form-group\">\n"
+    form_start = form_start .. "  <input type=\"submit\" value = \"" .. submit_text .. "\" class=\"btn btn-primary\">\n</div>\n"
+    form_start = form_start .. form_end
+    -- quarto.log.output(form_start)
+    return pandoc.RawInline("html", form_start)
+
+
+  else
+    return pandoc.Null()
+  end
+
+end
+
+}
+

_extensions/jlgraves-ubc/forms/forms.css

@@ -0,0 +1,58 @@
+project:
+  type: website
+
+website:
+  title: RapidSurveys
+  site-url: https://rapidsurveys.io
+  navbar:
+    title: RapidSurveys
+    logo: images/rapidsurveys_neg.png
+    logo-alt: RapidSurveys
+    tools:
+      - icon: mastodon
+        aria-label: Mastodon
+        href: https://fosstodon.org/@katilingban
+        rel: me
+      - icon: linkedin
+        aria-label: LinkedIn
+        href: https://linkedin.com/company/katilingban
+      - icon: github
+        aria-label: GitHub
+        href: https://github.com/rapidsurveys
+    left:
+      - href: index.qmd
+        text: Home
+      - text: Packages
+        href: packages/index.qmd
+      - text: About
+        menu:
+          - href: about/team.qmd
+          - href: about/contact.qmd
+  open-graph:
+    site-name: RapidSurveys
+  page-footer:
+    center: "Copyright 2024, Katilingban"
+    background: light
+    border: false
+  reader-mode: true
+  repo-url: https://github.com/rapidsurveys/rapidsurveys.github.io
+  repo-actions: [edit, issue]
+  issue-url: https://github.com/rapidsurveys/rapidsurveys.github.io/issues
+  cookie-consent:
+    type: express
+    style: simple
+    palette: light
+  google-analytics:
+    tracking-id: "G-0T1H0GBVXG"
+    anonymize-ip: true
+
+format:
+  html:
+    theme: [sandstone, custom.scss]
+    css: styles.css
+    grid:
+      sidebar-width: 250px
+      body-width: 900px
+      margin-width: 250px
+      gutter-width: 1.5rem
+    toc: false