Merge pull request #34 from HaoZeke/feat/2026-08-16-binding-logos

docs: framed ice-cage mark for pydseams

Author: HaoZeke

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## Unreleased
+
+The docs mark is the hexagonal ice cage inside a `Frame`, as SVG.
+
 ## 2.2.5
 
 `subprojects/seams-core.wrap` is `v2.2.5` (linkcell v0.2.4).

README.md

@@ -1,5 +1,9 @@
 # PydSEAMSlib
 
+<p align="center">
+  <img src="docs/source/_static/logo/pydseams-icon.png" alt="pydseams" width="96">
+</p>
+
 [![built with nix](https://builtwithnix.org/badge.svg)](https://builtwithnix.org)
 
 Python bindings for the [d-SEAMS](https://dseams.info) C++ engine

docs/orgmode/index.org

@@ -7,10 +7,22 @@
 pydseams
 ========
 
-.. image:: _static/logo/pydseamslib_logo_light.png
-   :alt: pydseams logo
-   :width: 280px
-   :align: center
+.. raw:: html
+
+   <p class="dseams-hero">
+     <img class="dseams-hero-logo dseams-hero-logo--light"
+          src="_static/logo/pydseams-logo-light.png"
+          alt="pydseams"
+          width="320"
+          height="320"
+          loading="eager" />
+     <img class="dseams-hero-logo dseams-hero-logo--dark"
+          src="_static/logo/pydseams-logo-dark.png"
+          alt="pydseams"
+          width="320"
+          height="320"
+          loading="eager" />
+   </p>
 
 .. grid:: 1 2 3 3
    :gutter: 2

docs/source/_static/custom.css

@@ -0,0 +1,46 @@
+/* Homepage hero: framed cage; swap light/dark via Shibuya color-mode. */
+
+.dseams-hero {
+  text-align: center;
+  margin: 0.5rem 0 1.25rem;
+}
+
+.dseams-hero-logo {
+  display: none;
+  margin: 0 auto;
+  max-width: min(320px, 70vw);
+  height: auto;
+}
+
+html.light .dseams-hero-logo--light,
+html:not(.dark) .dseams-hero-logo--light {
+  display: block;
+}
+
+html.dark .dseams-hero-logo--light {
+  display: none;
+}
+
+html.dark .dseams-hero-logo--dark {
+  display: block;
+}
+
+html.light .dseams-hero-logo--dark,
+html:not(.dark) .dseams-hero-logo--dark {
+  display: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  html:not(.light):not(.dark) .dseams-hero-logo--light {
+    display: none;
+  }
+  html:not(.light):not(.dark) .dseams-hero-logo--dark {
+    display: block;
+  }
+}
+
+.sy-head-brand img.light-logo,
+.sy-head-brand img.dark-logo {
+  height: 40px;
+  width: auto;
+}

docs/source/_static/logo/README.md

@@ -0,0 +1,14 @@
+# pydseams branding
+
+Mark for **pydseams** (Python Frame API on the d-SEAMS engine). The
+d-SEAMS hexagonal ice cage sits inside a gold picture frame: the
+public type is `Frame`.
+
+## Files
+
+| File | Use |
+| --- | --- |
+| `pydseams-logo-light.png` | Docs header and homepage (light) |
+| `pydseams-logo-dark.png` | Docs header and homepage (dark) |
+| `pydseams-icon.png` | README avatar |
+| `pydseams-icon.ico` | Favicon |