From 3d8faa93ea65b7c52448da4588ce4eebe83d4c9b Mon Sep 17 00:00:00 2001
From: njzjz-bot <njzjz.bot@gmail.com>
Date: Mon, 31 Aug 2026 00:58:26 +0800
Subject: [PATCH] docs: add dargs logo to README and docs

Coding-Agent: Codex
Codex-Version: codex-cli 0.151.0
Model: gpt-5.6-sol
Reasoning-Effort: xhigh
---
 README.md                   |  4 ++++
 docs/_static/dargs-logo.svg | 36 ++++++++++++++++++++++++++++++++++++
 docs/conf.py                |  5 +++++
 docs/index.rst              |  4 ++++
 4 files changed, 49 insertions(+)
 create mode 100644 docs/_static/dargs-logo.svg

diff --git a/README.md b/README.md
index 99be11b..f563df5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
 # Argument checking for python programs
 
+<p align="center">
+  <img src="docs/_static/dargs-logo.svg" alt="dargs — argument schemas for Python" width="560">
+</p>
+
 [![conda-forge](https://img.shields.io/conda/dn/conda-forge/dargs?color=red&label=conda-forge&logo=conda-forge)](https://anaconda.org/conda-forge/dargs)
 [![pip install](https://img.shields.io/pypi/dm/dargs?label=pip%20install&logo=pypi)](https://pypi.org/project/dargs)
 [![Documentation Status](https://readthedocs.org/projects/dargs/badge/)](https://dargs.readthedocs.io/)
diff --git a/docs/_static/dargs-logo.svg b/docs/_static/dargs-logo.svg
new file mode 100644
index 0000000..f111941
--- /dev/null
+++ b/docs/_static/dargs-logo.svg
@@ -0,0 +1,36 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 760 200" role="img" aria-labelledby="logo-title logo-description">
+  <title id="logo-title">dargs logo</title>
+  <desc id="logo-description">A stylized letter D containing an indented argument schema, followed by the dargs wordmark.</desc>
+
+  <defs>
+    <!-- The clipped rows turn the D into a compact representation of a nested config. -->
+    <clipPath id="d-counter">
+      <path d="M64 48h17c30 0 50 18 50 52s-20 52-50 52H64V48Z"/>
+    </clipPath>
+  </defs>
+
+  <!-- A flat, typographic mark: no network nodes or enclosing tile, so it remains
+       distinct from the sibling DeepModeling project marks. -->
+  <g fill="none" stroke="#173F5F" stroke-linejoin="round">
+    <path d="M51 34h30c40 0 66 25 66 66s-26 66-66 66H51V34Z" stroke-width="14"/>
+    <path d="M51 34v132" stroke-width="14" stroke-linecap="round"/>
+  </g>
+
+  <g clip-path="url(#d-counter)">
+    <!-- Indentation guide and rows evoke YAML/JSON argument nesting. -->
+    <path d="M64 62v86M64 86h17M64 111h30M64 136h17" fill="none" stroke="#173F5F" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
+    <rect x="80" y="57" width="47" height="11" rx="5.5" fill="#3CAEA3"/>
+    <rect x="93" y="82" width="36" height="11" rx="5.5" fill="#ED553B"/>
+    <rect x="105" y="107" width="25" height="11" rx="5.5" fill="#F6B73C"/>
+    <rect x="80" y="132" width="43" height="11" rx="5.5" fill="#20639B"/>
+  </g>
+
+  <!-- Lowercase wordmark keeps the tool name readable beside the compact mark. -->
+  <text x="221" y="130" fill="#173F5F" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot;, sans-serif" font-size="102" font-weight="700" letter-spacing="-5">dargs</text>
+  <g transform="translate(228 157)">
+    <rect width="42" height="7" rx="3.5" fill="#3CAEA3"/>
+    <rect x="50" width="27" height="7" rx="3.5" fill="#ED553B"/>
+    <rect x="85" width="56" height="7" rx="3.5" fill="#F6B73C"/>
+    <rect x="149" width="34" height="7" rx="3.5" fill="#20639B"/>
+  </g>
+</svg>
diff --git a/docs/conf.py b/docs/conf.py
index 4cac5c4..c7efa39 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -140,6 +140,11 @@ def _get_release() -> str:
 #
 # html_sidebars = {}
 
+# Use the project mark in generated HTML documentation.  The SVG lives in
+# ``docs/_static`` so it is also available as a relative asset from README.md.
+html_static_path = ["_static"]
+html_logo = "_static/dargs-logo.svg"
+
 
 # -- Options for HTMLHelp output ---------------------------------------------
 
diff --git a/docs/index.rst b/docs/index.rst
index 8158bdf..20f0541 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,6 +6,10 @@
 Welcome to dargs's documentation!
 ==================================
 
+.. image:: _static/dargs-logo.svg
+   :alt: dargs — argument schemas for Python
+   :width: 560px
+
 .. toctree::
    :maxdepth: 2
    :caption: Contents: