Skip to content

Commit 0ca848c

Browse files
committed
fix: integrate changelog as adoc and repair theme overrides
1 parent 4e07529 commit 0ca848c

11 files changed

Lines changed: 103 additions & 90 deletions

File tree

CHANGELOG.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

README.adoc

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# architexture-theme-antora
2+
3+
A bespoke, minimalist architectural theme for Antora documentation, inspired by the "Stone and Graphite" design system.
4+
5+
== Design Philosophy
6+
7+
* **Neutral Palette**: Stone and Graphite high-contrast scheme.
8+
* **Structural Integrity**: 1px borders, structural grids, and monospace technical metadata.
9+
* **Minimalism**: Focus on content hierarchy and architectural honesty.
10+
11+
== Hosting Strategy
12+
13+
This project uses a **Path-Based Routing** strategy for GitHub Pages to host both the **Docs** and **Demo** within a single instance:
14+
15+
* **Docs**: https://antora-supplemental.github.io/architexture-theme-antora/docs/
16+
* **Demo**: https://antora-supplemental.github.io/architexture-theme-antora/demo/
17+
18+
== Changelog
19+
20+
This project adheres to the architectural timeline documented in xref:docs/modules/ROOT/pages/changelog.adoc[CHANGELOG.adoc].
21+
22+
== Deployment
23+
24+
Configure your CI/CD (GitHub Actions) to output the builds into these specific subdirectories on the gh-pages branch.

README.md

Lines changed: 0 additions & 20 deletions
This file was deleted.

docs/modules/ROOT/nav.adoc

8 Bytes

changelog-details/2026-04-11 - stone-and-graphite-reveal.md renamed to docs/modules/ROOT/pages/changelog-details/2026-04-11-stone-and-graphite-reveal.adoc

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
1-
# 2026-04-11 - Stone and Graphite Structural Reveal
1+
= 2026-04-11 - Stone and Graphite Structural Reveal
22

3-
## Architectural Context
3+
== Architectural Context
44

55
The theme has been upgraded from a static CSS override to a dynamic, Tailwind v4-powered architectural system. This allows the Antora documentation to maintain design parity with the core portfolio site.
66

7-
## Key Changes
7+
== Key Changes
88

9-
- **Tailwind v4 Setup**: Implementation of the `@custom-variant dark` configuration to allow manual theme toggling via class selector.
10-
- **View Transitions**: Integration of the `document.startViewTransition` API to provide a seamless, hardware-accelerated transition between themes.
11-
- **Structural Hexagon Mask**: An animated SVG-based masking system that reveals the theme change through a series of tessellated hexagons popping into existence.
12-
- **Transient Transitions**: Performance-optimized CSS that only enables transitions during the theme flip, preventing scrolling jank on large documentation pages.
9+
* **Tailwind v4 Setup**: Implementation of the `@custom-variant dark` configuration to allow manual theme toggling via class selector.
10+
* **View Transitions**: Integration of the `document.startViewTransition` API to provide a seamless, hardware-accelerated transition between themes.
11+
* **Structural Hexagon Mask**: An animated SVG-based masking system that reveals the theme change through a series of tessellated hexagons popping into existence.
12+
* **Transient Transitions**: Performance-optimized CSS that only enables transitions during the theme flip, preventing scrolling jank on large documentation pages.
1313

14-
## Verification
14+
== Verification
1515

16-
- Validated CSS build via `pnpm build:css`.
17-
- Verified UI injection via `npx antora antora-playbook.yml`.
16+
* Validated CSS build via `pnpm build:css`.
17+
* Verified UI injection via `npx antora antora-playbook.yml`.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
= Changelog
2+
3+
All notable changes to this project will be documented in this file.
4+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
5+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6+
7+
== [0.1.0] - 2026-04-11
8+
9+
=== Added
10+
11+
* **Aesthetic Engine**: Initial implementation of the "Stone and Graphite" theme logic.
12+
* **Tailwind v4 Integration**: Migration to Tailwind v4 CSS pipeline.
13+
* **Structural Reveal**: Hardware-accelerated hexagonal View Transition for theme switching.
14+
* **Antora Supplemental UI**: Partial overrides for header, head, and footer scripts to support the architectural theme.
15+
16+
== Timeline & Documentation
17+
18+
Detailed records of major architectural changes:
19+
20+
* xref:changelog-details/2026-04-11-stone-and-graphite-reveal.adoc[2026-04-11 - Stone and Graphite Structural Reveal]

supplemental-ui/css/site-extra.css

Lines changed: 19 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@
1212
--color-stone-800: oklch(26.8% 0.007 34.298);
1313
--spacing: 0.25rem;
1414
--tracking-tight: -0.025em;
15-
--tracking-widest: 0.1em;
1615
--leading-relaxed: 1.625;
1716
--default-transition-duration: 150ms;
1817
--default-transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
@@ -172,14 +171,26 @@
172171
}
173172
}
174173
@layer utilities {
174+
.static {
175+
position: static;
176+
}
175177
.contents {
176178
display: contents;
177179
}
178180
.flex {
179181
display: flex;
180182
}
181-
.h-full {
182-
height: 100%;
183+
.h-4 {
184+
height: calc(var(--spacing) * 4);
185+
}
186+
.h-8 {
187+
height: calc(var(--spacing) * 8);
188+
}
189+
.w-4 {
190+
width: calc(var(--spacing) * 4);
191+
}
192+
.w-8 {
193+
width: calc(var(--spacing) * 8);
183194
}
184195
.transform {
185196
transform: var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,);
@@ -190,25 +201,12 @@
190201
.items-center {
191202
align-items: center;
192203
}
193-
.px-3 {
194-
padding-inline: calc(var(--spacing) * 3);
195-
}
196-
.font-mono {
197-
font-family: var(--font-mono);
198-
}
199-
.text-\[10px\] {
200-
font-size: 10px;
201-
}
202-
.tracking-widest {
203-
--tw-tracking: var(--tracking-widest);
204-
letter-spacing: var(--tracking-widest);
204+
.justify-center {
205+
justify-content: center;
205206
}
206207
.text-stone-400 {
207208
color: var(--color-stone-400);
208209
}
209-
.uppercase {
210-
text-transform: uppercase;
211-
}
212210
.transition {
213211
transition-property: color, background-color, border-color, outline-color, text-decoration-color, fill, stroke, --tw-gradient-from, --tw-gradient-via, --tw-gradient-to, opacity, box-shadow, transform, translate, scale, rotate, filter, -webkit-backdrop-filter, backdrop-filter, display, content-visibility, overlay, pointer-events;
214212
transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
@@ -219,10 +217,6 @@
219217
transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
220218
transition-duration: var(--tw-duration, var(--default-transition-duration));
221219
}
222-
.select-none {
223-
-webkit-user-select: none;
224-
user-select: none;
225-
}
226220
.hover\:opacity-70 {
227221
&:hover {
228222
@media (hover: hover) {
@@ -324,11 +318,11 @@
324318
syntax: "*";
325319
inherits: false;
326320
}
327-
@property --tw-tracking {
321+
@property --tw-leading {
328322
syntax: "*";
329323
inherits: false;
330324
}
331-
@property --tw-leading {
325+
@property --tw-tracking {
332326
syntax: "*";
333327
inherits: false;
334328
}
@@ -345,8 +339,8 @@
345339
--tw-rotate-z: initial;
346340
--tw-skew-x: initial;
347341
--tw-skew-y: initial;
348-
--tw-tracking: initial;
349342
--tw-leading: initial;
343+
--tw-tracking: initial;
350344
--tw-border-style: solid;
351345
}
352346
}
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
<footer class="footer">
2+
<p>This page was built using the Antora default UI.</p>
3+
<p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
4+
</footer>
5+
<script src="{{{uiRootPath}}}/js/theme-toggle.js"></script>

supplemental-ui/partials/footer-scripts.hbs

Lines changed: 0 additions & 1 deletion
This file was deleted.

supplemental-ui/partials/head-scripts.hbs

Lines changed: 0 additions & 12 deletions
This file was deleted.

0 commit comments

Comments
 (0)