Update theme, fix remote content fetches, remove custom ToC (#201)

- Our ToC solution is no longer needed (provided by the theme)
- CHANGELOG is working again, fixes #197
- Other docs changes and touch-ups
- Bump to latest available (stable) Hugo and dart-sass versions

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: agriyakhetarpal

README.md

@@ -93,8 +93,6 @@ summary: "Summary of the news item"
 ---
 ```
 
-You may use the `toc: true` parameter to add a table of contents to the news item. This works on all pages, not just news items. The `shortcutDepth: X` parameter can be used to limit the depth of the headings referenced in the page.
-
 The `newsHeader` parameter will automatically be set to the `title:` of the latest news item and will show up on the homepage of the website.
 
 ## Deployment
@@ -116,9 +114,7 @@ Some shortcodes for adding general-purpose buttons and links are available in `l
 {{< external-content "https://api.github.com/repos/example-org/example-repo/contents/path/to/file.md" >}}
 ```
 
-2. To include an optional table of contents at the top of a page, set `toc: true` in the YAML front matter of a page. The table of contents will be generated from the headings referenced in the page.
-
-3. To change how things look, edit `assets/css/overrides.css` or add any additional CSS file to the `assets/css/` directory. These files are loaded after the theme-specific CSS files, so they can be used to override any styles set by the theme.
+2. To change how things look, edit `assets/css/overrides.css` or add any additional CSS file to the `assets/css/` directory. These files are loaded after the theme-specific CSS files, so they can be used to override any styles set by the theme.
 
 For more information, please refer to the [Hugo documentation](https://gohugo.io/documentation/) and the [Scientific Python Hugo theme guides](https://theme.scientific-python.org/shortcodes/).
 

config.yaml

@@ -72,28 +72,28 @@ params:
 
     - title: Community
       sublinks:
-      - title: Contact
-        url: /community/
-      - title: Get Involved
-        url: /contribute/
-      - title: Code of Conduct
-        url: /code-of-conduct/
-      - title: Roadmap
-        url: /roadmap/
-      - title: Open-Source Programs
-        url: /open-source-programs/
+        - title: Contact
+          url: /community/
+        - title: Get Involved
+          url: /contribute/
+        - title: Code of Conduct
+          url: /code-of-conduct/
+        - title: Roadmap
+          url: /roadmap/
+        - title: Open-Source Programs
+          url: /open-source-programs/
 
     - title: About Us
       sublinks:
-      - title: About PyBaMM
-        url: /about/
-      - title: Ionworks
-        url: https://ionworks.com/
-        is_external: true
-      - title: Governance
-        url: /governance/
-      - title: PyBaMM Teams
-        url: /teams/
+        - title: About PyBaMM
+          url: /about/
+        - title: Ionworks
+          url: https://ionworks.com/
+          is_external: true
+        - title: Governance
+          url: /governance/
+        - title: PyBaMM Teams
+          url: /teams/
 
     - title: News
       url: /news/

content/contribute.md

@@ -1,6 +1,5 @@
 ---
 title: Contribute to PyBaMM
-toc: true
 summary: "How to contribute to PyBaMM's development"
 ---
 

content/learn.md

@@ -1,6 +1,5 @@
 ---
 title: Get started with PyBaMM
-toc: true
 summary: How to get started with PyBaMM
 ---
 

content/news/2023/11/20/pybamm-23.9.md

@@ -2,7 +2,6 @@
 title: PyBaMM 23.9 has been released!
 date: 2023-11-20
 summary: PyBaMM 23.9 has been released with several new features and improvements.
-toc: true
 shortcutDepth: 1
 ---
 

content/news/2024/01/31/pybamm-24.1.md

@@ -2,7 +2,6 @@
 title: PyBaMM 24.1 has been released!
 summary: PyBaMM version 24.1 has now been released with several new features and improvements.
 date: 2024-01-31
-toc: true
 shortcutDepth: 1
 ---
 

content/news/2024/05/31/pybamm-24.5.md

@@ -2,7 +2,6 @@
 title: PyBaMM 24.5 has been released!
 summary: PyBaMM version 24.5 has now been released with several new features and improvements.
 date: 2024-07-26
-toc: true
 shortcutDepth: 1
 ---
 

content/news/2024/09/03/pybamm-24.9.md

@@ -2,7 +2,6 @@
 title: PyBaMM 24.9 has been released!
 summary: PyBaMM version 24.9 has now been released with several new features and improvements.
 date: 2024-09-03
-toc: true
 shortcutDepth: 1
 ---
 

layouts/_default/single.html

@@ -7,11 +7,23 @@
 <body>
     {{ if isset .Params 0 }}
         {{ $url := index .Params 0 }}
-        {{ with getJSON $url }}
-            {{ .content | base64Decode | replaceRE "(?m)^# (.+)$" "## $1" | markdownify }}
-    {{ else }}
-        {{ errorf "Failed to fetch content from the provided URL: %s" $url }}
-    {{ end }}
+        {{ with resources.GetRemote $url }}
+            {{ with .Err }}
+                {{ errorf "%s" . }}
+            {{ else }}
+                {{ with . | transform.Unmarshal }}
+                    {{ with .content }}
+                        {{ . | base64Decode | replaceRE "(?m)^# (.+)$" "## $1" | markdownify }}
+                    {{ else }}
+                        {{ errorf "No 'content' field found in the response" }}
+                    {{ end }}
+                {{ else }}
+                    {{ errorf "Failed to unmarshal the response" }}
+                {{ end }}
+            {{ end }}
+        {{ else }}
+            {{ errorf "Unable to get remote resource %q" $url }}
+        {{ end }}
     {{ else }}
         {{ errorf "You must provide a URL in the shortcode." }}
     {{ end }}