bridgetown-stoa 0.0.2 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +8 -0
- data/README.md +14 -1
- data/layouts/bridgetown-stoa/layout.serb +30 -4
- data/lib/bridgetown-stoa/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 4a78f506b84ad2518d27d4f7cb6cfc133fcd3dae4dadd2622d3f3698ede1dbc3
|
|
4
|
+
data.tar.gz: d567d1a4059a6da89a02d9124a47230557042332983e2a13cdaeb7cbb1e4fb83
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 3039e265e94aa9571ee8d8846cb988f2dc73bc75f2f8391e393db22684faea404747728e76c3434acff558faa576ea40d39769180f0e59e6395b419717b41795
|
|
7
|
+
data.tar.gz: c331e8d344ac1f991822edebd681a86e64e07cf7ee745bb343f447314bd397e5e5944d131a296ef9f5e7dba180485f30d23037b09e42cba51d410639bd02fe44
|
data/CHANGELOG.md
CHANGED
|
@@ -9,6 +9,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
9
9
|
|
|
10
10
|
- ...
|
|
11
11
|
|
|
12
|
+
## [0.1.0] - 2026-05-22
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
- `bridgetown-stoa/layout` is now a self-contained HTML document (doctype, `<head>` with title/meta/asset tags, and `<header>`/`<main>`/`<footer>` chrome). Consumers no longer need to provide their own `default` layout to use Stoa. The layout also prepends `resource.data.title` to `<title>` when set. (#5)
|
|
16
|
+
|
|
17
|
+
### Notes
|
|
18
|
+
- The layout wires `asset_path :css` / `:js` for the host site's esbuild bundle. Bridgetown sites created with `bridgetown new` ship esbuild by default; sites without frontend bundling will see `MISSING_FRONTEND_BUNDLING_CONFIG` in the asset URLs until they configure one (or shadow the layout to drop the tags).
|
|
19
|
+
|
|
12
20
|
## [0.0.2] - 2026-05-22
|
|
13
21
|
|
|
14
22
|
### Fixed
|
data/README.md
CHANGED
|
@@ -29,10 +29,23 @@ One layout is registered: `bridgetown-stoa/layout`. Apply it via front matter:
|
|
|
29
29
|
```yaml
|
|
30
30
|
---
|
|
31
31
|
layout: bridgetown-stoa/layout
|
|
32
|
+
title: My Page
|
|
32
33
|
---
|
|
33
34
|
```
|
|
34
35
|
|
|
35
|
-
The layout
|
|
36
|
+
The layout is self-contained: it renders a full HTML document (doctype, `<head>` with title and asset tags, semantic `<header>`/`<main>`/`<footer>` regions) and yields the page body into `<main>`. You do **not** need a `default` layout in your site to use Stoa.
|
|
37
|
+
|
|
38
|
+
The document title is `{page title} | {site metadata title}` when a page sets `title:` in front matter, and just the site title otherwise. The layout also injects `asset_path :css` / `:js` so your site's esbuild bundle loads automatically.
|
|
39
|
+
|
|
40
|
+
### Overriding the layout
|
|
41
|
+
|
|
42
|
+
To customize the chrome, shadow the layout in your own site:
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
src/_layouts/bridgetown-stoa/layout.serb
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Bridgetown's layout resolution picks the host site's file over the gem's, so you can replace the entire layout or copy ours and edit it. (More granular override points — head, nav, footer partials — will land as the theme grows.)
|
|
36
49
|
|
|
37
50
|
## Development
|
|
38
51
|
|
|
@@ -1,4 +1,30 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="{{ site.locale || 'en' }}">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
|
+
<title>
|
|
7
|
+
{% if resource.data.title %}{{ resource.data.title }} | {% end %}{{ site.metadata.title }}
|
|
8
|
+
</title>
|
|
9
|
+
{% if resource.data.description %}
|
|
10
|
+
<meta name="description" content="{{ resource.data.description }}">
|
|
11
|
+
{% end %}
|
|
12
|
+
<link rel="stylesheet" href="{%= asset_path :css %}">
|
|
13
|
+
</head>
|
|
14
|
+
<body>
|
|
15
|
+
<header class="stoa-header">
|
|
16
|
+
<a href="/" class="stoa-site-title">{{ site.metadata.title }}</a>
|
|
17
|
+
</header>
|
|
18
|
+
<main class="stoa-main">
|
|
19
|
+
{%= yield %}
|
|
20
|
+
</main>
|
|
21
|
+
<footer class="stoa-footer">
|
|
22
|
+
<small>
|
|
23
|
+
Built with <a href="https://www.bridgetownrb.com">Bridgetown</a>
|
|
24
|
+
<span>+</span>
|
|
25
|
+
<a href="https://github.com/Guided-Rails/bridgetown-stoa">Stoa</a>.
|
|
26
|
+
</small>
|
|
27
|
+
</footer>
|
|
28
|
+
<script src="{%= asset_path :js %}" defer></script>
|
|
29
|
+
</body>
|
|
30
|
+
</html>
|