@vdaluz/astro-blog 0.11.0 → 0.12.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.
- package/README.md +6 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# @vdaluz/astro-blog
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@vdaluz/astro-blog)
|
|
3
4
|
[](https://github.com/vdaluz/astro-blog/actions/workflows/ci.yml)
|
|
5
|
+
[](LICENSE)
|
|
4
6
|
|
|
5
7
|
A blog needs a listing page, pagination, related posts, tag filters, JSON-LD, RSS, and a Shiki-highlighted code theme - most of it undifferentiated work you rebuild every time you spin up an Astro site. `@vdaluz/astro-blog` packages that layer as token-driven components, so styling comes from your own CSS custom properties, not a hardcoded palette. Ships raw `.astro` and `.ts` - the consuming app's Astro/Vite compiles them (no prebuild step). Built for and proven in production across two sites, [vdaluz.com](https://vdaluz.com) and [imperfectsystems.com](https://imperfectsystems.com) - see [Consumers](#consumers).
|
|
6
8
|
|
|
@@ -12,21 +14,6 @@ A blog needs a listing page, pagination, related posts, tag filters, JSON-LD, RS
|
|
|
12
14
|
npm install @vdaluz/astro-blog
|
|
13
15
|
```
|
|
14
16
|
|
|
15
|
-
Alternatively, a pinned https tarball from a tag works too, with no registry involved:
|
|
16
|
-
|
|
17
|
-
```jsonc
|
|
18
|
-
// package.json
|
|
19
|
-
"dependencies": {
|
|
20
|
-
"@vdaluz/astro-blog": "https://github.com/vdaluz/astro-blog/archive/refs/tags/v0.9.0.tar.gz"
|
|
21
|
-
}
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
> **Why a tarball, not `github:vdaluz/astro-blog#v0.1.0`?** npm canonicalizes GitHub
|
|
25
|
-
> shorthand (and even an explicit `git+https://` URL) to `git+ssh://` in the lockfile.
|
|
26
|
-
> CI runners (e.g. Cloudflare Pages/Workers) have no SSH key, so `npm ci` would fail to
|
|
27
|
-
> clone it. The `/archive/refs/tags/<tag>.tar.gz` URL is anonymous https with an integrity
|
|
28
|
-
> hash in the lockfile - it just works in CI. Bump the tag in the URL to upgrade.
|
|
29
|
-
|
|
30
17
|
Peer dependency: `astro` >= 6. For post body styling you'll also want `@tailwindcss/typography` in the app.
|
|
31
18
|
|
|
32
19
|
## Four things every consumer MUST do
|
|
@@ -240,3 +227,7 @@ Issues welcome. PRs by discussion - open an issue first for anything beyond a ty
|
|
|
240
227
|
|
|
241
228
|
- [vdaluz.com](https://vdaluz.com)
|
|
242
229
|
- [imperfectsystems.com](https://imperfectsystems.com)
|
|
230
|
+
|
|
231
|
+
## License
|
|
232
|
+
|
|
233
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vdaluz/astro-blog",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"description": "Token-driven Astro blog components, related-posts scoring, a schema factory, and Shiki config - proven in production on vdaluz.com and imperfectsystems.com.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"astro",
|