Merge branch 'main' into docs/add-underscore-to-unfinished-why-docs

.github/CODEOWNERS

@@ -8,4 +8,6 @@
 justfile
 .editorconfig
 .gitignore
-ruff.toml
+ruff.toml
+pyproject.toml
+poetry.lock

.gitignore

@@ -77,6 +77,7 @@ junit/
 
 # Quarto
 /.quarto/
+docs/.quarto/
 
 # Website generation
 _site
@@ -86,9 +87,14 @@ site
 
 # Local data files
 **/datafile/*
+# Persistent storage should not be stored in git except for the markdown files
+persistent_storage
+!persistent_storage/**/*.md
 
 # Python Django
 *.log
 local_settings.py
 db.sqlite3
 db.sqlite3-journal
+# We'll disable migrations for now, until we have actual users
+migrations

.vscode/extensions.json

@@ -1,7 +1,6 @@
 {
 	// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
 	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
-
 	// List of extensions which should be recommended for users of this workspace.
 	"recommendations": [
 		"jebbs.plantuml",
@@ -19,10 +18,10 @@
 		"vivaxy.vscode-conventional-commits",
 		"charliermarsh.ruff",
 		"pshaddel.conventional-branch",
-		"yy0931.vscode-sqlite3-editor"
+		"yy0931.vscode-sqlite3-editor",
+		"junstyle.vscode-django-support",
+		"monosans.djlint"
 	],
 	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
-	"unwantedRecommendations": [
-
-	]
-}
+	"unwantedRecommendations": []
+}

.vscode/json.code-snippets

@@ -36,14 +36,15 @@
 
 	"Insert YAML header for blogs": {
 		"scope": "quarto,markdown",
-		"prefix": "yaml_blog",
+		"prefix": "post_yaml",
 		"body": [
 			"---"
 			"title: \"\""
 			"description: \"Our reasons for ...\""
 			"author: \"\""
 			"date: last-modified"
 			"categories:"
+			"  ${0:Type 'category_keywords' to insert categories}"
 			"---"
 		],
 		"description": "Insert YAML header for Quarto blog posts."
@@ -112,55 +113,48 @@
 // The idea is that we can insert this section and then delete the words we aren't interested in
 // If words are missing then they can be added to the document, and then also added to the code snippet
 // Much the same way that words can be added to the spell-check extension.
-	"Insert title section with list of category words": {
-		"scope": "quarto,markdown",
-		"prefix": "ttl_sec_cat",
+	"Insert list of category words": {
+		"scope": "quarto,markdown,yaml",
+		"prefix": "category_keywords",
 		"body": [
-			"---"
-			"title: \"\""
-			"description: \"Our reasons for ...\""
-			"author: \"\""
-			"date: last-modified"
-			"categories:"
-			"  - api"
-			"  - backend"
-			"  - blogs"
-			"  - code snippets"
-			"  - communication"
-			"  - container"
-			"  - contributing"
-			"  - copyright"
-			"  - culture"
-			"  - database"
-			"  - development"
-			"  - documentation"
-			"  - frontend"
-			"  - github"
-			"  - implementation"
-			"  - installation"
-			"  - licensing"
-			"  - management"
-			"  - markdown"
-			"  - organization"
-			"  - programming"
-			"  - repositories"
-			"  - reviewing"
-			"  - software"
-			"  - software architecture"
-			"  - standardisation"
-			"  - structure"
-			"  - team work"
-			"  - teamworking"
-			"  - technology"
-			"  - templates"
-			"  - tools"
-			"  - vs code"
-			"  - web"
-			"  - website"
-			"  - workflow"
-			"  - writing"
-			"---"
+			"- api"
+			"- backend"
+			"- blogs"
+			"- code snippets"
+			"- communication"
+			"- container"
+			"- contributing"
+			"- copyright"
+			"- culture"
+			"- database"
+			"- development"
+			"- documentation"
+			"- frontend"
+			"- github"
+			"- implementation"
+			"- installation"
+			"- licensing"
+			"- management"
+			"- markdown"
+			"- organization"
+			"- programming"
+			"- repositories"
+			"- reviewing"
+			"- software"
+			"- software architecture"
+			"- standardisation"
+			"- structure"
+			"- team work"
+			"- teamworking"
+			"- technology"
+			"- templates"
+			"- tools"
+			"- vs code"
+			"- web"
+			"- website"
+			"- workflow"
+			"- writing"
 		],
-		"description": "Insert title with category words"
+		"description": "Insert list of category words"
 	}
-}
+}

.vscode/settings.json

@@ -3,6 +3,9 @@
   "editor.tabSize": 2,
   "editor.wordWrap": "off",
   "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "always"
+  },
   "git.autofetch": false,
   "quarto.visualEditor.markdownWrap": "column",
   "quarto.visualEditor.markdownWrapColumn": 72,
@@ -23,5 +26,15 @@
   "conventional-branch.format": "{Type}/{Branch}",
   "[python]": {
     "editor.defaultFormatter": "charliermarsh.ruff"
-  }
-}
+  },
+  "[html][django-html]": {
+    "editor.defaultFormatter": "monosans.djlint"
+  },
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv",
+  "python.languageServer": "Pylance",
+  "files.insertFinalNewline": true,
+  "cSpell.enableFiletypes": [
+    "quarto"
+  ],
+  "cSpell.language": "en,en-GB",
+}

_extensions/seedcase-project/seedcase-theme/_extension.yml

@@ -7,7 +7,7 @@ contributes:
     html:
       from: markdown+emoji
       theme:
-        - zephyr
+        - cosmo
         - theme.scss
       toc: true
       toc-location: right
@@ -19,12 +19,17 @@ contributes:
       execute-dir: project
 
     website:
+      page-navigation: true
+      favicon: favicon/favicon.ico
       repo-branch: main
       repo-actions: [edit, issue, source]
       search:
         location: navbar
         type: overlay
+      navbar:
+        background: light
+        logo: logos/navbar-logo-seedcase-project.svg
 
     csl: vancouver.csl
 
-    format: seedcase-theme-html
+    format: seedcase-theme-html

_extensions/seedcase-project/seedcase-theme/favicon/site.webmanifest

@@ -0,0 +1 @@
+{"name":"","short_name":"","icons":[{"src":"/android-chrome-192x192.png","sizes":"192x192","type":"image/png"},{"src":"/android-chrome-512x512.png","sizes":"512x512","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}