Merge branch 'main' into add_linkedin_icon

Author: agriyakhetarpal

.github/workflows/label-check.yaml

@@ -12,6 +12,8 @@ on:
 env:
   LABELS: ${{ join( github.event.pull_request.labels.*.name, ' ' ) }}
 
+permissions: {}
+
 jobs:
   check-type-label:
     name: ensure type label

.github/workflows/milestone-merged-prs.yaml

@@ -10,6 +10,11 @@ on:
 jobs:
   milestone_pr:
     name: attach to PR
+    if: github.event.pull_request.merged == true
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: read
     runs-on: ubuntu-latest
     steps:
       - uses: scientific-python/attach-next-milestone-action@bc07be829f693829263e57d5e8489f4e57d3d420

.pre-commit-config.yaml

@@ -3,7 +3,7 @@
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: cef0300fd0fc4d2a87a85fa2093c6b283ea36f4b # frozen: v5.0.0
+    rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c # frozen: v6.0.0
     hooks:
       - id: check-added-large-files
       - id: check-ast
@@ -19,14 +19,14 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/rbubley/mirrors-prettier
-    rev: bc7af46104f0f5368b95878decf720f9f00c2559 # frozen: v3.4.2
+    rev: 5ba47274f9b181bce26a5150a725577f3c336011 # frozen: v3.6.2
     hooks:
       - id: prettier
         types_or: [yaml, toml, markdown, css, scss, javascript, json]
         args: [--prose-wrap=preserve]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 73413df07b4ab0bf103ca1ae73c7cec5c0ace593 # frozen: v0.9.2
+    rev: 9c89adb347f6b973f4905a4be0051eb2ecf85dea # frozen: v0.13.3
     hooks:
       - id: ruff
         args:
@@ -39,7 +39,7 @@ repos:
       - id: ruff-format
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: 4dcc98ccce605605fd6d5202bf803a8c8bc34e8d # v1.1.1
+    rev: v1.14.2 # v1.1.1
     hooks:
       - id: zizmor
 

assets/theme-css/footer.css

@@ -39,6 +39,18 @@
   color: var(--spht-color-link-hover);
 }
 
+.footer-item a.nav-external {
+  white-space: nowrap;
+}
+
+.footer-item a.nav-external::after {
+  font: var(--fa-font-solid);
+  content: "\f35d";
+  font-size: 0.75em;
+  margin-left: 0.3em;
+  display: inline-block;
+}
+
 .footer-actions {
   max-width: 25vw;
   margin: 1.25rem 1.563rem;

assets/theme-css/navbar.css

@@ -1,4 +1,3 @@
-nav,
 .navbar {
   background: var(--pst-color-background);
   position: sticky;
@@ -42,6 +41,15 @@ a.navbar-item:hover,
   text-decoration-thickness: max(3px, 0.1875rem, 0.12em);
 }
 
+a.navbar-item.nav-external::after,
+.navbar-dropdown a.navbar-item.nav-external::after {
+  font: var(--fa-font-solid);
+  content: "\f35d";
+  font-size: 0.75em;
+  margin-left: 0.3em;
+  display: inline-block;
+}
+
 .navbar-burger {
   font-family: inherit;
   font-size: 1em;

assets/theme-css/pst/components/_breadcrumbs.scss

@@ -1,6 +1,10 @@
 /**
  * Breadcrumbs for parent pages meant for the article header
  */
+nav[aria-label="Breadcrumb"] {
+  width: fit-content;
+}
+
 ul.bd-breadcrumbs {
   list-style: none;
   padding-left: 0;

assets/theme-css/pst/variables/_fonts.scss

@@ -33,11 +33,12 @@ html {
 
   // Font family
   // These are adapted from https://systemfontstack.com/ */
-  --pst-font-family-base-system: -apple-system, "BlinkMacSystemFont",
-    "Segoe UI", "Helvetica Neue", "Arial", sans-serif, "Apple Color Emoji",
-    "Segoe UI Emoji", "Segoe UI Symbol";
-  --pst-font-family-monospace-system: "SFMono-Regular", "Menlo", "Consolas",
-    "Monaco", "Liberation Mono", "Lucida Console", monospace;
+  --pst-font-family-base-system:
+    -apple-system, "BlinkMacSystemFont", "Segoe UI", "Helvetica Neue", "Arial",
+    sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
+  --pst-font-family-monospace-system:
+    "SFMono-Regular", "Menlo", "Consolas", "Monaco", "Liberation Mono",
+    "Lucida Console", monospace;
   --pst-font-family-base: var(--pst-font-family-base-system);
   --pst-font-family-heading: var(--pst-font-family-base-system);
   --pst-font-family-monospace: var(--pst-font-family-monospace-system);

doc/config.yaml

@@ -41,6 +41,9 @@ params:
       url: /shortcodes/
     - title: Examples
       url: /examples/
+    - title: Repository
+      url: https://github.com/scientific-python/scientific-python-hugo-theme
+      is_external: true
     - title: More
       sublinks:
         - title: Dropdown item
@@ -70,9 +73,11 @@ params:
             link: /about/
           - text: Theme GitHub
             link: https://github.com/scientific-python/scientific-python-hugo-theme
+            is_external: true
       column2:
         links:
           - text: Scientific Python Forum
             link: https://discuss.scientific-python.org
+            is_external: true
       column3:
         links:

doc/content/examples/kitchen-sink/tables.md

@@ -38,7 +38,6 @@ format:
 rows:
 
 - columns:
-
   - "NumPy"
   - |
     Official _source code_ (all platforms) and _binaries_ for<br/>

doc/content/user_guide/features.md

@@ -93,6 +93,48 @@ To use them elsewhere, e.g. in Hugo templates, we provide an `svg-icon` partial.
 {{ partial "svg-icon" "my-icon" }}
 ```
 
+## External links
+
+Links in the navbar and footer can be marked as external by adding `is_external: true`. This displays an external link indicator icon
+(<span style="font-family: 'Font Awesome 6 Free', FontAwesome;"></span>) next to the link text and opens the link in a new tab.
+
+### Navbar external links
+
+```yaml
+params:
+  navbar:
+    - title: Documentation
+      url: /docs/
+    - title: GitHub
+      url: https://github.com/your-org/your-repo
+      is_external: true
+    - title: More
+      sublinks:
+        - title: Internal Page
+          url: /internal/
+        - title: External Resource
+          url: https://example.com
+          is_external: true
+```
+
+### Footer external links
+
+```yaml
+params:
+  footer:
+    quicklinks:
+      column1:
+        title: "Links"
+        links:
+          - text: About
+            link: /about/
+          - text: GitHub Repository
+            link: https://github.com/your-org/your-repo
+            is_external: true
+```
+
+The external link indicator automatically adapts to both light and dark colour modes.
+
 ## Mermaid diagrams
 
 [Mermaid](https://mermaid.js.org/) diagrams are rendered from code blocks: