doc: move unclickable GH links to example subpages (#570)

dionhaefner · web-flow · commit 73592e1d6a94 · 2026-04-22T18:24:56.000Z
#### Relevant issue or PR

n/a

#### Description of changes

"View on GitHub" links on example galleries weren't clickable because
the cards take precedence. Moved to subpages instead.

#### Testing done

:eyes:
diff --git a/docs/content/examples/ansys_gallery.md b/docs/content/examples/ansys_gallery.md
@@ -25,15 +25,11 @@ You can find the code for all Ansys Tesseracts in the `demo/_showcase` directory
 :link: ansys_integration/spaceclaim_tess.html
 
 A Tesseract that wraps SpaceClaim for CAD geometry creation.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/demo/_showcase/ansys-shapeopt/spaceclaim)
 :::
 :::{grid-item-card} MAPDL
 :link: ansys_integration/pymapdl_tess.html
 
 A differentiable Tesseract that wraps the MAPDL solver via PyMAPDL with an analytic adjoint, for use in SIMP topology optimization.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/demo/_showcase/ansys-shapeopt/pymapdl)
 :::
 
 ::::
diff --git a/docs/content/examples/ansys_integration/pymapdl_tess.md b/docs/content/examples/ansys_integration/pymapdl_tess.md
@@ -1,5 +1,7 @@
 # Wrapping MAPDL as a Tesseract
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/demo/_showcase/ansys-shapeopt/pymapdl)
+
 This example wraps Ansys MAPDL as a differentiable Tesseract that can e.g. be used for SIMP (Solid Isotropic Material with Penalization) topology optimization.
 
 The Tesseract computes structural compliance using finite element analysis and provides analytical sensitivities for gradient-based optimization.
diff --git a/docs/content/examples/ansys_integration/spaceclaim_tess.md b/docs/content/examples/ansys_integration/spaceclaim_tess.md
@@ -1,5 +1,7 @@
 # Wrapping SpaceClaim as a Tesseract
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/demo/_showcase/ansys-shapeopt/spaceclaim)
+
 This guide outlines how to wrap Ansys SpaceClaim as a Tesseract. For this, we will use [non-containerized execution](project:#running-without-containers) to start an HTTP server that dispatches requests to SpaceClaim through SpaceClaim scripts (`.scscript`).
 
 ```{seealso}
diff --git a/docs/content/examples/building-blocks/arm64.md b/docs/content/examples/building-blocks/arm64.md
@@ -1,5 +1,7 @@
 # Custom build steps: PyVista on ARM64
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/pyvista-arm64)
+
 ## Context
 
 Tesseracts use by default an official Python docker image as the base image. Although this covers many useful cases, some system dependencies sometimes require a custom image and extra build steps.
diff --git a/docs/content/examples/building-blocks/dataloader.md b/docs/content/examples/building-blocks/dataloader.md
@@ -1,5 +1,7 @@
 # Out-of-core data loading
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/dataloader)
+
 ## Context
 
 This is an example of a Tesseract that loads in data from a folder by mounting the folder in the cli.
diff --git a/docs/content/examples/building-blocks/file_io.md b/docs/content/examples/building-blocks/file_io.md
@@ -1,5 +1,7 @@
 # File IO with `InputPath` / `OutputPath`
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/file_io)
+
 ## Context
 
 Instead passing file constents to the input payload, a Tesseract can
diff --git a/docs/content/examples/building-blocks/finitediff.md b/docs/content/examples/building-blocks/finitediff.md
@@ -1,5 +1,7 @@
 # Finite Difference Gradients
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/meshstats_finitediff)
+
 This example demonstrates how to make any Tesseract differentiable using **finite differences**,
 without implementing analytical gradient code.
 
diff --git a/docs/content/examples/building-blocks/fortran.md b/docs/content/examples/building-blocks/fortran.md
@@ -1,5 +1,7 @@
 # Wrapping Compiled Code (Fortran Example)
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/fortran_heat)
+
 ## Context
 
 Many industries---aerospace, energy, automotive---rely on simulation codes written in compiled languages like Fortran that have been developed and validated over decades. These legacy assets represent significant investment and domain expertise. Tesseract provides a straightforward path to wrap such codes, making them accessible through a modern API while preserving their proven numerical implementations.
diff --git a/docs/content/examples/building-blocks/gradient-fallbacks.md b/docs/content/examples/building-blocks/gradient-fallbacks.md
@@ -1,5 +1,7 @@
 # Deriving Gradient Endpoints from Each Other
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/univariate_gradient_fallbacks)
+
 This guide shows how to derive missing gradient endpoints from ones you have already
 implemented, using the experimental fallback helpers.
 
diff --git a/docs/content/examples/building-blocks/helloworld.md b/docs/content/examples/building-blocks/helloworld.md
@@ -1,5 +1,7 @@
 # HelloWorld
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/helloworld)
+
 ## Context
 
 This is a basic Hello World Tesseract. See [getting-started]
diff --git a/docs/content/examples/building-blocks/localpackage.md b/docs/content/examples/building-blocks/localpackage.md
@@ -1,5 +1,7 @@
 # Installing local Python modules into a Tesseract
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/localpackage)
+
 ## Context
 
 Sometimes it might be necessary to bundle local Python modules into a Tesseract.
diff --git a/docs/content/examples/building-blocks/matlab.md b/docs/content/examples/building-blocks/matlab.md
@@ -1,5 +1,7 @@
 # Wrapping MATLAB Code
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/_matlab_springmass)
+
 ## Context
 
 MATLAB is one of the most widely used tools in engineering for simulation, control system design, and signal processing. Many organizations have decades of validated MATLAB code that they want to make accessible through modern APIs without rewriting. Tesseract provides a way to wrap MATLAB code by using the official [MathWorks MATLAB Docker image](https://hub.docker.com/r/mathworks/matlab) as the base image and calling MATLAB via `matlab -batch`.
diff --git a/docs/content/examples/building-blocks/packagedata.md b/docs/content/examples/building-blocks/packagedata.md
@@ -1,5 +1,7 @@
 # Packaging local files into a Tesseract
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/package_data)
+
 ## Context
 
 You may need to include local files into your Tesseract, e.g. if we want to load in pretrained model weights, or artifacts that we may need access to. This guide will demonstrate how.
diff --git a/docs/content/examples/building-blocks/univariate.md b/docs/content/examples/building-blocks/univariate.md
@@ -1,5 +1,7 @@
 # Univariate Rosenbrock function
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/univariate)
+
 ## Context
 
 Example that wraps the univariate [Rosenbrock function](https://en.wikipedia.org/wiki/Rosenbrock_function), which is a common test problem for optimization algorithms. Defines a Tesseract that has all optional endpoints implemented, including `apply`, `abstract_eval`, `jacobian`, `jacobian_vector_product`, and `vector_jacobian_product`.
diff --git a/docs/content/examples/building-blocks/vectoradd.md b/docs/content/examples/building-blocks/vectoradd.md
@@ -1,5 +1,7 @@
 # VectorAdd
 
+[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/vectoradd)
+
 ## Context
 
 Example using vector add with differentiable inputs and jacobians.
diff --git a/docs/content/examples/example_gallery.md b/docs/content/examples/example_gallery.md
@@ -35,64 +35,46 @@ You can also find these Tesseracts in the `examples` directory of the [code repo
 :link: building-blocks/helloworld.html
 
 A simple "hello world" Tesseract.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/helloworld)
 :::
 :::{grid-item-card} VectorAdd
 :link: building-blocks/vectoradd.html
 
 Tesseract performing vector addition. Highlighting simple array operations and how to use the Tesseract Python SDK.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/vectoradd)
 :::
 :::{grid-item-card} Univariate
 :link: building-blocks/univariate.html
 
 A Tesseract that wraps the univariate Rosenbrock function, which is a common test problem for optimization algorithms.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/univariate)
 :::
 :::{grid-item-card} Fortran Integration
 :link: building-blocks/fortran.html
 
 Wrapping a Fortran heat equation solver. Demonstrates subprocess-based integration for legacy compiled code.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/fortran_heat)
 :::
 :::{grid-item-card} MATLAB Integration
 :link: building-blocks/matlab.html
 
 Wrapping a MATLAB spring-mass-damper ODE solver. Demonstrates using the official MathWorks Docker image to run MATLAB code via `matlab -batch`.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/_matlab_springmass)
 :::
 :::{grid-item-card} Package Data
 :link: building-blocks/packagedata.html
 
 A guide on including local files into a built Tesseract.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/package_data)
 :::
 :::{grid-item-card} Pyvista on ARM64
 :link: building-blocks/arm64.html
 
 A guide showcasing how to use custom build steps to install pyvista within an ARM64 Tesseract.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/pyvista-arm64)
 :::
 :::{grid-item-card} Local Dependencies
 :link: building-blocks/localpackage.html
 
 A guide on installing local Python packages into a Tesseract.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/localpackage)
 :::
 :::{grid-item-card} Data Loader
 :link: building-blocks/dataloader.html
 
 Tesseract that loads in data samples from a folder without loading them into memory.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/dataloader)
 :::
 
 :::{grid-item-card} Input/Output Path References
@@ -102,27 +84,20 @@ Tesseract that passes files and directories through the input/output mounts
 instead of serializing their contents into the request payload.
 Useful when inputs or outputs are large on disk, or consist of
 many (or a variable number of) files.
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/file_io)
 :::
 
 :::{grid-item-card} Finite Difference Gradients
 :link: building-blocks/finitediff.html
 
 Make any Tesseract differentiable without implementing analytical gradients.
 Useful for prototyping and complex nested schemas. _(Experimental)_
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/meshstats_finitediff)
-
 :::
 
 :::{grid-item-card} Gradient Endpoint Derivation Fallbacks
 :link: building-blocks/gradient-fallbacks.html
 
 Derive missing gradient endpoints (JVP, VJP, Jacobian) from ones you have
 already implemented. _(Experimental)_
-
-[View on GitHub](https://github.com/pasteurlabs/tesseract-core/tree/main/examples/univariate_gradient_fallbacks)
 :::
 
 ::::
