@ingram-tech/nk-blog 0.1.11 → 0.2.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 +43 -0
- package/dist/blog.d.ts +26 -5
- package/dist/blog.d.ts.map +1 -1
- package/dist/blog.js +41 -18
- package/dist/blog.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/schema.d.ts +3 -0
- package/dist/schema.d.ts.map +1 -1
- package/dist/schema.js +6 -1
- package/dist/schema.js.map +1 -1
- package/dist/seo.d.ts +31 -0
- package/dist/seo.d.ts.map +1 -1
- package/dist/seo.js +35 -3
- package/dist/seo.js.map +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js.map +1 -1
- package/dist/types.d.ts +10 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/blog.ts +84 -25
- package/src/index.ts +3 -0
- package/src/schema.ts +6 -1
- package/src/seo.ts +67 -3
- package/src/server.ts +1 -0
- package/src/types.ts +10 -1
package/README.md
CHANGED
|
@@ -61,6 +61,49 @@ export default async function Post({ params }: PageProps<"/blog/[slug]">) {
|
|
|
61
61
|
}
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
+
## Multilingual blogs
|
|
65
|
+
|
|
66
|
+
Set `defaultLang` and each post is written in one language:
|
|
67
|
+
|
|
68
|
+
```md
|
|
69
|
+
---
|
|
70
|
+
title: "Facturation électronique : ce qui change pour les utilisateurs Stripe"
|
|
71
|
+
lang: fr
|
|
72
|
+
translationKey: france-e-invoicing-mandate # the English post's slug; omit for a French-only post
|
|
73
|
+
---
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
- **`lang`** is the post's language; posts without it take `defaultLang`.
|
|
77
|
+
- **Slugs are unique per language**, so a translation can reuse its original's
|
|
78
|
+
slug or carry its own (a French slug for French search).
|
|
79
|
+
- **`translationKey`** groups a post with its translations. It defaults to the
|
|
80
|
+
slug, so same-slug posts link without declaring it. A post links only to
|
|
81
|
+
versions that exist: a French-only article advertises no English URL.
|
|
82
|
+
|
|
83
|
+
```ts
|
|
84
|
+
export const blog = createBlog({ source: fsSource("content/blog"), defaultLang: "en" });
|
|
85
|
+
|
|
86
|
+
await blog.previews({ lang: "fr" }); // the French index
|
|
87
|
+
await blog.post(slug, { lang: "fr" }); // a French post
|
|
88
|
+
const versions = await blog.translations(post);
|
|
89
|
+
|
|
90
|
+
const seoConfig = { baseUrl, basePath: "/blog", defaultLang: "en" };
|
|
91
|
+
postUrl(post, seoConfig); // /blog/what-is, /fr/blog/cest-quoi
|
|
92
|
+
const { canonical, languages } = blogPostAlternates(post, versions, seoConfig);
|
|
93
|
+
// → Metadata.alternates: { canonical, languages }
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
URLs: default-language posts live at `basePath`, others at `/<lang><basePath>`
|
|
97
|
+
(nk-i18n's prefix shape). Unlike nk-i18n's negotiated pages the default
|
|
98
|
+
language is not prefixed: a post is one document in one language with exactly
|
|
99
|
+
one address, so there is no language-neutral bare URL to reserve. Route the
|
|
100
|
+
other languages with a `[lang]` segment (`app/[lang]/blog/[slug]/page.tsx`,
|
|
101
|
+
`generateStaticParams` over `blog.posts()` minus the default language) so the
|
|
102
|
+
posts stay fully static. `blogPostArticle` sets `inLanguage`; a per-language
|
|
103
|
+
feed is `generateRss({ ...config, basePath: "/fr/blog", language: "fr" },
|
|
104
|
+
await blog.previews({ lang: "fr" }))`. `readTime` is English — localize from
|
|
105
|
+
`readingTimeMinutes`.
|
|
106
|
+
|
|
64
107
|
## The rules that keep this portable
|
|
65
108
|
|
|
66
109
|
- **Vocabulary, not imports.** A Tier-1 post references `<Callout>`, `<Figure>`,
|
package/dist/blog.d.ts
CHANGED
|
@@ -15,6 +15,13 @@ export interface BlogConfig {
|
|
|
15
15
|
wordsPerMinute?: number;
|
|
16
16
|
/** Include drafts (listing pages typically pass `NODE_ENV !== "production"`). */
|
|
17
17
|
drafts?: boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Language of every post that declares no `lang`. Set it to make the blog
|
|
20
|
+
* multilingual: each post is written in one language, slugs are unique per
|
|
21
|
+
* language, and posts sharing a `translationKey` are one another's
|
|
22
|
+
* translations. Unset, `lang` is only what frontmatter says.
|
|
23
|
+
*/
|
|
24
|
+
defaultLang?: string;
|
|
18
25
|
/**
|
|
19
26
|
* Site-specific image fallback (e.g. "look in /public/images/posts/<slug>").
|
|
20
27
|
* This is config precisely so per-site divergence never forks the reader.
|
|
@@ -31,15 +38,29 @@ export interface BlogConfig {
|
|
|
31
38
|
*/
|
|
32
39
|
onInvalid?: "throw" | "skip";
|
|
33
40
|
}
|
|
41
|
+
/** Narrows a listing to one language. Omitted, every language is included. */
|
|
42
|
+
export interface LangFilter {
|
|
43
|
+
lang?: string;
|
|
44
|
+
}
|
|
34
45
|
export interface Blog {
|
|
35
46
|
/** All non-draft posts, newest first, with bodies. */
|
|
36
|
-
posts(): Promise<BlogPost[]>;
|
|
47
|
+
posts(filter?: LangFilter): Promise<BlogPost[]>;
|
|
37
48
|
/** All non-draft posts, newest first, without bodies. */
|
|
38
|
-
previews(): Promise<BlogPostPreview[]>;
|
|
39
|
-
|
|
40
|
-
|
|
49
|
+
previews(filter?: LangFilter): Promise<BlogPostPreview[]>;
|
|
50
|
+
/**
|
|
51
|
+
* The post at `slug`. Slugs are unique per language, so pass `lang` on a
|
|
52
|
+
* multilingual blog; without it, the `defaultLang` post wins a shared slug.
|
|
53
|
+
*/
|
|
54
|
+
post(slug: string, filter?: LangFilter): Promise<BlogPost | null>;
|
|
55
|
+
slugs(filter?: LangFilter): Promise<string[]>;
|
|
41
56
|
/** The pinned (`featured: true`) post, else the newest. */
|
|
42
|
-
featured(): Promise<BlogPost | null>;
|
|
57
|
+
featured(filter?: LangFilter): Promise<BlogPost | null>;
|
|
58
|
+
/**
|
|
59
|
+
* Every language version of `post`, itself included, in `posts()` order —
|
|
60
|
+
* the input to `blogPostAlternates`. Drafts are excluded like everywhere
|
|
61
|
+
* else, so an unpublished translation is never advertised.
|
|
62
|
+
*/
|
|
63
|
+
translations(post: BlogPostPreview): Promise<BlogPostPreview[]>;
|
|
43
64
|
}
|
|
44
65
|
interface ParsedName {
|
|
45
66
|
slug: string;
|
package/dist/blog.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,KAAK,
|
|
1
|
+
{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAClE,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAChE;AAID,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAwDhF;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA0EnD"}
|
package/dist/blog.js
CHANGED
|
@@ -59,7 +59,8 @@ export function parsePost(file, config) {
|
|
|
59
59
|
image,
|
|
60
60
|
draft: frontmatter.draft || named.draftByName,
|
|
61
61
|
featured: frontmatter.featured,
|
|
62
|
-
lang: frontmatter.lang,
|
|
62
|
+
lang: frontmatter.lang ?? config.defaultLang,
|
|
63
|
+
translationKey: frontmatter.translationKey ?? slug,
|
|
63
64
|
canonical: frontmatter.canonical,
|
|
64
65
|
format: named.format,
|
|
65
66
|
readingTimeMinutes: time.minutes,
|
|
@@ -67,38 +68,60 @@ export function parsePost(file, config) {
|
|
|
67
68
|
content: body,
|
|
68
69
|
};
|
|
69
70
|
}
|
|
71
|
+
const inLang = (post, filter) => filter?.lang === undefined || post.lang === filter.lang;
|
|
70
72
|
export function createBlog(config) {
|
|
71
|
-
const
|
|
73
|
+
const all = async () => {
|
|
72
74
|
const files = await config.source.load();
|
|
73
75
|
const parsed = files
|
|
74
76
|
.map((file) => parsePost(file, config))
|
|
75
77
|
.filter((post) => post !== null);
|
|
76
|
-
// Collision
|
|
77
|
-
// post must fail the production build too, not only draft-enabled
|
|
78
|
-
// previews. Two files resolving to one
|
|
79
|
-
//
|
|
80
|
-
|
|
78
|
+
// Collision checks BEFORE the draft filter: a draft colliding with a
|
|
79
|
+
// live post must fail the production build too, not only draft-enabled
|
|
80
|
+
// previews. Two files resolving to one address, or two posts claiming
|
|
81
|
+
// to be the same translation, is a conflict — always a loud build
|
|
82
|
+
// failure, never a quiet last-one-wins.
|
|
83
|
+
const bySlug = new Map();
|
|
84
|
+
const byTranslation = new Map();
|
|
81
85
|
for (const post of parsed) {
|
|
82
|
-
|
|
83
|
-
|
|
86
|
+
const where = post.lang === undefined ? "" : ` in lang "${post.lang}"`;
|
|
87
|
+
const slugKey = `${post.lang ?? ""}\0${post.slug}`;
|
|
88
|
+
if (bySlug.has(slugKey)) {
|
|
89
|
+
throw new Error(`nk-blog: duplicate slug "${post.slug}"${where}`);
|
|
84
90
|
}
|
|
85
|
-
|
|
91
|
+
bySlug.set(slugKey, post);
|
|
92
|
+
const translationKey = `${post.lang ?? ""}\0${post.translationKey}`;
|
|
93
|
+
const claimed = byTranslation.get(translationKey);
|
|
94
|
+
if (claimed) {
|
|
95
|
+
throw new Error(`nk-blog: "${claimed.slug}" and "${post.slug}" are both the${where} version of translation "${post.translationKey}"`);
|
|
96
|
+
}
|
|
97
|
+
byTranslation.set(translationKey, post);
|
|
86
98
|
}
|
|
87
|
-
return [...
|
|
99
|
+
return [...bySlug.values()]
|
|
88
100
|
.filter((post) => config.drafts === true || !post.draft)
|
|
89
101
|
.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime() ||
|
|
90
102
|
// Same-day posts: deterministic order between builds.
|
|
91
|
-
a.slug.localeCompare(b.slug)
|
|
103
|
+
a.slug.localeCompare(b.slug) ||
|
|
104
|
+
(a.lang ?? "").localeCompare(b.lang ?? ""));
|
|
92
105
|
};
|
|
106
|
+
const posts = async (filter) => (await all()).filter((post) => inLang(post, filter));
|
|
93
107
|
return {
|
|
94
108
|
posts,
|
|
95
|
-
previews: async () => (await posts()).map(({ content: _content, ...preview }) => preview),
|
|
96
|
-
post: async (slug
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
109
|
+
previews: async (filter) => (await posts(filter)).map(({ content: _content, ...preview }) => preview),
|
|
110
|
+
post: async (slug, filter) => {
|
|
111
|
+
const matches = (await posts(filter)).filter((candidate) => candidate.slug === slug);
|
|
112
|
+
return (matches.find((candidate) => candidate.lang === config.defaultLang) ??
|
|
113
|
+
matches[0] ??
|
|
114
|
+
null);
|
|
115
|
+
},
|
|
116
|
+
slugs: async (filter) => (await posts(filter)).map((post) => post.slug),
|
|
117
|
+
featured: async (filter) => {
|
|
118
|
+
const listed = await posts(filter);
|
|
119
|
+
return listed.find((post) => post.featured) ?? listed[0] ?? null;
|
|
101
120
|
},
|
|
121
|
+
translations: async (post) => (await all())
|
|
122
|
+
.filter((candidate) => (candidate.translationKey ?? candidate.slug) ===
|
|
123
|
+
(post.translationKey ?? post.slug))
|
|
124
|
+
.map(({ content: _content, ...preview }) => preview),
|
|
102
125
|
};
|
|
103
126
|
}
|
|
104
127
|
//# sourceMappingURL=blog.js.map
|
package/dist/blog.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -3,5 +3,5 @@ export type { BlogPost, BlogPostPreview, PostFormat } from "./types.js";
|
|
|
3
3
|
export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, type BlogComponents, type VocabularyName, type VocabularyPropsMap, type CalloutProps, type FigureProps, type YouTubeProps, type TweetProps, type NewsletterSubscribeProps, } from "./contract.js";
|
|
4
4
|
export { readingTime, DEFAULT_WORDS_PER_MINUTE, type ReadingTime, } from "./reading-time.js";
|
|
5
5
|
export { formatPostDate } from "./date.js";
|
|
6
|
-
export { blogPostArticle, blogPostBreadcrumbs, postUrl, type BlogSeoConfig, } from "./seo.js";
|
|
6
|
+
export { blogIndexUrl, blogPostAlternates, blogPostArticle, blogPostBreadcrumbs, postUrl, type BlogPostAlternates, type BlogSeoConfig, } from "./seo.js";
|
|
7
7
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,KAAK,aAAa,GAClB,MAAM,UAAU,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,KAAK,kBAAkB,EACvB,KAAK,aAAa,GAClB,MAAM,UAAU,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -6,5 +6,5 @@ export { blogFrontmatterSchema, } from "./schema.js";
|
|
|
6
6
|
export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, } from "./contract.js";
|
|
7
7
|
export { readingTime, DEFAULT_WORDS_PER_MINUTE, } from "./reading-time.js";
|
|
8
8
|
export { formatPostDate } from "./date.js";
|
|
9
|
-
export { blogPostArticle, blogPostBreadcrumbs, postUrl, } from "./seo.js";
|
|
9
|
+
export { blogIndexUrl, blogPostAlternates, blogPostArticle, blogPostBreadcrumbs, postUrl, } from "./seo.js";
|
|
10
10
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,OAAO,EACN,qBAAqB,GAGrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,GASxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,OAAO,EACN,qBAAqB,GAGrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,GASxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,GAGP,MAAM,UAAU,CAAC"}
|
package/dist/schema.d.ts
CHANGED
|
@@ -29,6 +29,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
|
|
|
29
29
|
draft: z.ZodDefault<z.ZodBoolean>;
|
|
30
30
|
featured: z.ZodDefault<z.ZodBoolean>;
|
|
31
31
|
lang: z.ZodOptional<z.ZodString>;
|
|
32
|
+
translationKey: z.ZodOptional<z.ZodString>;
|
|
32
33
|
canonical: z.ZodOptional<z.ZodString>;
|
|
33
34
|
}, z.core.$strip>, z.ZodTransform<{
|
|
34
35
|
title: string;
|
|
@@ -42,6 +43,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
|
|
|
42
43
|
draft: boolean;
|
|
43
44
|
featured: boolean;
|
|
44
45
|
lang?: string | undefined;
|
|
46
|
+
translationKey?: string | undefined;
|
|
45
47
|
canonical?: string | undefined;
|
|
46
48
|
image: string | undefined;
|
|
47
49
|
authors: string[];
|
|
@@ -61,6 +63,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
|
|
|
61
63
|
draft: boolean;
|
|
62
64
|
featured: boolean;
|
|
63
65
|
lang?: string | undefined;
|
|
66
|
+
translationKey?: string | undefined;
|
|
64
67
|
canonical?: string | undefined;
|
|
65
68
|
}>>;
|
|
66
69
|
export type BlogFrontmatter = z.infer<typeof blogFrontmatterSchema>;
|
package/dist/schema.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAS5D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAS5D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6B9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
|
package/dist/schema.js
CHANGED
|
@@ -46,8 +46,13 @@ export const blogFrontmatterSchema = z
|
|
|
46
46
|
slug: slugSchema.optional(),
|
|
47
47
|
draft: z.boolean().default(false),
|
|
48
48
|
featured: z.boolean().default(false),
|
|
49
|
-
//
|
|
49
|
+
// The post's language (e.g. "fr"); `BlogConfig.defaultLang` when absent.
|
|
50
50
|
lang: nonEmpty.optional(),
|
|
51
|
+
// Groups a post with its translations; defaults to the slug, so posts
|
|
52
|
+
// sharing a slug across languages link without declaring it. Set it
|
|
53
|
+
// when a translation carries its own slug.
|
|
54
|
+
translationKey: nonEmpty.optional(),
|
|
55
|
+
// Reserved — validated now so adding behavior later isn't breaking.
|
|
51
56
|
canonical: nonEmpty.optional(),
|
|
52
57
|
})
|
|
53
58
|
.transform(({ author, authors, coverImage, image, ...rest }) => ({
|
package/dist/schema.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,6DAA6D;AAC7D,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,iBAAiB,MAAM,CAAC,KAAK,CAAC,iCAAiC;SACxE,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,KAAK,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAE5D,MAAM,UAAU,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,KAAK,CACL,WAAW,EACX,0EAA0E,CAC1E,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACpC,MAAM,CAAC;IACP,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
|
package/dist/seo.d.ts
CHANGED
|
@@ -9,8 +9,39 @@ export interface BlogSeoConfig {
|
|
|
9
9
|
publisher?: OrganizationInput;
|
|
10
10
|
/** Crumb label for the blog index; defaults to "Blog". */
|
|
11
11
|
blogName?: string;
|
|
12
|
+
/**
|
|
13
|
+
* The blog's default language — the same value as `BlogConfig.defaultLang`.
|
|
14
|
+
* Its posts live at `basePath`; every other language's posts at
|
|
15
|
+
* `/<lang><basePath>` (`/fr/blog/<slug>`), matching nk-i18n's prefix
|
|
16
|
+
* strategy. Unset, no URL carries a language.
|
|
17
|
+
*
|
|
18
|
+
* The default language is deliberately unprefixed, unlike nk-i18n's
|
|
19
|
+
* negotiated pages: a post is one document in one language, not a page
|
|
20
|
+
* rendered per visitor, so it has exactly one address and there is no
|
|
21
|
+
* language-neutral bare URL to keep free.
|
|
22
|
+
*/
|
|
23
|
+
defaultLang?: string;
|
|
12
24
|
}
|
|
25
|
+
/** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
|
|
26
|
+
export declare function blogIndexUrl(lang: string | undefined, config: BlogSeoConfig): string;
|
|
27
|
+
/** Absolute URL of a post, prefixed by its language when that isn't the default. */
|
|
13
28
|
export declare function postUrl(post: BlogPostPreview, config: BlogSeoConfig): string;
|
|
29
|
+
export interface BlogPostAlternates {
|
|
30
|
+
/** The post's own address, or its `canonical` override. */
|
|
31
|
+
canonical: string;
|
|
32
|
+
/**
|
|
33
|
+
* hreflang → URL for every language version, plus `x-default` pointing at
|
|
34
|
+
* the default-language version when there is one. Empty for a post with no
|
|
35
|
+
* translation: a single-member cluster says nothing.
|
|
36
|
+
*/
|
|
37
|
+
languages: Record<string, string>;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Canonical + hreflang alternates for a post, from `blog.translations(post)`.
|
|
41
|
+
* Spread into Next's `Metadata.alternates`. A post links only to versions that
|
|
42
|
+
* exist, so a French-only article never advertises an English URL.
|
|
43
|
+
*/
|
|
44
|
+
export declare function blogPostAlternates(post: BlogPostPreview, translations: readonly BlogPostPreview[], config: BlogSeoConfig): BlogPostAlternates;
|
|
14
45
|
/** BlogPosting JSON-LD for a post — the nk-seo bridge. */
|
|
15
46
|
export declare function blogPostArticle(post: BlogPostPreview, config: BlogSeoConfig, overrides?: Partial<ArticleInput>): WithContext<ArticleNode>;
|
|
16
47
|
/** Home → Blog → Post breadcrumb JSON-LD. */
|
package/dist/seo.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAEpF;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5E;AAED,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,SAAS,eAAe,EAAE,EACxC,MAAM,EAAE,aAAa,GACnB,kBAAkB,CAepB;AAaD,0DAA0D;AAC1D,wBAAgB,eAAe,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACnC,WAAW,CAAC,WAAW,CAAC,CAe1B;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,GACnB,WAAW,CAAC,kBAAkB,CAAC,CAMjC"}
|
package/dist/seo.js
CHANGED
|
@@ -1,6 +1,37 @@
|
|
|
1
1
|
import { article, breadcrumbList, } from "@ingram-tech/nk-seo";
|
|
2
|
+
/** `/fr` for a non-default language, `""` for the default (or no language). */
|
|
3
|
+
const langPrefix = (lang, config) => config.defaultLang !== undefined &&
|
|
4
|
+
lang !== undefined &&
|
|
5
|
+
lang !== config.defaultLang
|
|
6
|
+
? `/${lang}`
|
|
7
|
+
: "";
|
|
8
|
+
/** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
|
|
9
|
+
export function blogIndexUrl(lang, config) {
|
|
10
|
+
return `${config.baseUrl}${langPrefix(lang, config)}${config.basePath}`;
|
|
11
|
+
}
|
|
12
|
+
/** Absolute URL of a post, prefixed by its language when that isn't the default. */
|
|
2
13
|
export function postUrl(post, config) {
|
|
3
|
-
return `${
|
|
14
|
+
return `${blogIndexUrl(post.lang, config)}/${post.slug}`;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Canonical + hreflang alternates for a post, from `blog.translations(post)`.
|
|
18
|
+
* Spread into Next's `Metadata.alternates`. A post links only to versions that
|
|
19
|
+
* exist, so a French-only article never advertises an English URL.
|
|
20
|
+
*/
|
|
21
|
+
export function blogPostAlternates(post, translations, config) {
|
|
22
|
+
const canonical = toAbsoluteUrl(post.canonical ?? postUrl(post, config), config.baseUrl);
|
|
23
|
+
const versions = translations.filter((version) => version.lang !== undefined);
|
|
24
|
+
if (versions.length < 2)
|
|
25
|
+
return { canonical, languages: {} };
|
|
26
|
+
const languages = {};
|
|
27
|
+
for (const version of versions) {
|
|
28
|
+
if (version.lang)
|
|
29
|
+
languages[version.lang] = postUrl(version, config);
|
|
30
|
+
}
|
|
31
|
+
const fallback = versions.find((version) => version.lang === config.defaultLang);
|
|
32
|
+
if (fallback)
|
|
33
|
+
languages["x-default"] = postUrl(fallback, config);
|
|
34
|
+
return { canonical, languages };
|
|
4
35
|
}
|
|
5
36
|
// JSON-LD consumers don't resolve relative URLs, so anything without a scheme
|
|
6
37
|
// (leading-`/` or bare `img/x.png`) is absolutized against the site. Unlike
|
|
@@ -24,14 +55,15 @@ export function blogPostArticle(post, config, overrides = {}) {
|
|
|
24
55
|
image: post.image ? toAbsoluteUrl(post.image, config.baseUrl) : undefined,
|
|
25
56
|
keywords: post.tags.length ? post.tags : undefined,
|
|
26
57
|
publisher: config.publisher,
|
|
58
|
+
...(post.lang ? { extra: { inLanguage: post.lang } } : {}),
|
|
27
59
|
...overrides,
|
|
28
60
|
});
|
|
29
61
|
}
|
|
30
62
|
/** Home → Blog → Post breadcrumb JSON-LD. */
|
|
31
63
|
export function blogPostBreadcrumbs(post, config) {
|
|
32
64
|
return breadcrumbList([
|
|
33
|
-
{ name: "Home", url: config.baseUrl },
|
|
34
|
-
{ name: config.blogName ?? "Blog", url:
|
|
65
|
+
{ name: "Home", url: `${config.baseUrl}${langPrefix(post.lang, config)}` },
|
|
66
|
+
{ name: config.blogName ?? "Blog", url: blogIndexUrl(post.lang, config) },
|
|
35
67
|
{ name: post.title, url: postUrl(post, config) },
|
|
36
68
|
]);
|
|
37
69
|
}
|
package/dist/seo.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,EAGP,cAAc,GAId,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { createBlog, parsePost, parsePostFileName, type Blog, type BlogConfig, type BlogSource, type RawPostFile, } from "./blog.js";
|
|
1
|
+
export { createBlog, parsePost, parsePostFileName, type Blog, type BlogConfig, type BlogSource, type LangFilter, type RawPostFile, } from "./blog.js";
|
|
2
2
|
export { fsSource } from "./sources/fs.js";
|
|
3
3
|
export { githubSource, type GitHubRepoConfig } from "./sources/github.js";
|
|
4
4
|
export { publishPost, serializePost, type PublishedPost, type PublishPostInput, } from "./sources/publish.js";
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAMjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
|
package/dist/types.d.ts
CHANGED
|
@@ -17,8 +17,17 @@ export interface BlogPostPreview {
|
|
|
17
17
|
image?: string;
|
|
18
18
|
draft: boolean;
|
|
19
19
|
featured: boolean;
|
|
20
|
-
/**
|
|
20
|
+
/**
|
|
21
|
+
* The post's language: frontmatter `lang`, else `BlogConfig.defaultLang`.
|
|
22
|
+
* Undefined on a single-language blog that sets neither.
|
|
23
|
+
*/
|
|
21
24
|
lang?: string;
|
|
25
|
+
/**
|
|
26
|
+
* Shared by a post and its translations: frontmatter `translationKey`, else
|
|
27
|
+
* the slug. Always set by the reader; optional so hand-built previews
|
|
28
|
+
* (tests, fixtures) need not spell it out.
|
|
29
|
+
*/
|
|
30
|
+
translationKey?: string;
|
|
22
31
|
/** Reserved canonical-URL override for syndicated posts. */
|
|
23
32
|
canonical?: string;
|
|
24
33
|
format: PostFormat;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtC,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtC,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAS,SAAQ,eAAe;IAChD,OAAO,EAAE,MAAM,CAAC;CAChB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ingram-tech/nk-blog",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "File-based blog foundation for Next.js sites: frontmatter schema, build-time reader, limited-MDX rendering, a typed component contract with unstyled defaults, GitHub read/publish, and RSS.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -64,7 +64,7 @@
|
|
|
64
64
|
}
|
|
65
65
|
},
|
|
66
66
|
"devDependencies": {
|
|
67
|
-
"@ingram-tech/nk-dev": "0.
|
|
67
|
+
"@ingram-tech/nk-dev": "0.18.0",
|
|
68
68
|
"@types/mdast": "^4.0.4",
|
|
69
69
|
"@types/node": "^26.5.1",
|
|
70
70
|
"@types/react": "^19.3.0",
|
package/src/blog.ts
CHANGED
|
@@ -21,6 +21,13 @@ export interface BlogConfig {
|
|
|
21
21
|
wordsPerMinute?: number;
|
|
22
22
|
/** Include drafts (listing pages typically pass `NODE_ENV !== "production"`). */
|
|
23
23
|
drafts?: boolean;
|
|
24
|
+
/**
|
|
25
|
+
* Language of every post that declares no `lang`. Set it to make the blog
|
|
26
|
+
* multilingual: each post is written in one language, slugs are unique per
|
|
27
|
+
* language, and posts sharing a `translationKey` are one another's
|
|
28
|
+
* translations. Unset, `lang` is only what frontmatter says.
|
|
29
|
+
*/
|
|
30
|
+
defaultLang?: string;
|
|
24
31
|
/**
|
|
25
32
|
* Site-specific image fallback (e.g. "look in /public/images/posts/<slug>").
|
|
26
33
|
* This is config precisely so per-site divergence never forks the reader.
|
|
@@ -35,15 +42,30 @@ export interface BlogConfig {
|
|
|
35
42
|
onInvalid?: "throw" | "skip";
|
|
36
43
|
}
|
|
37
44
|
|
|
45
|
+
/** Narrows a listing to one language. Omitted, every language is included. */
|
|
46
|
+
export interface LangFilter {
|
|
47
|
+
lang?: string;
|
|
48
|
+
}
|
|
49
|
+
|
|
38
50
|
export interface Blog {
|
|
39
51
|
/** All non-draft posts, newest first, with bodies. */
|
|
40
|
-
posts(): Promise<BlogPost[]>;
|
|
52
|
+
posts(filter?: LangFilter): Promise<BlogPost[]>;
|
|
41
53
|
/** All non-draft posts, newest first, without bodies. */
|
|
42
|
-
previews(): Promise<BlogPostPreview[]>;
|
|
43
|
-
|
|
44
|
-
|
|
54
|
+
previews(filter?: LangFilter): Promise<BlogPostPreview[]>;
|
|
55
|
+
/**
|
|
56
|
+
* The post at `slug`. Slugs are unique per language, so pass `lang` on a
|
|
57
|
+
* multilingual blog; without it, the `defaultLang` post wins a shared slug.
|
|
58
|
+
*/
|
|
59
|
+
post(slug: string, filter?: LangFilter): Promise<BlogPost | null>;
|
|
60
|
+
slugs(filter?: LangFilter): Promise<string[]>;
|
|
45
61
|
/** The pinned (`featured: true`) post, else the newest. */
|
|
46
|
-
featured(): Promise<BlogPost | null>;
|
|
62
|
+
featured(filter?: LangFilter): Promise<BlogPost | null>;
|
|
63
|
+
/**
|
|
64
|
+
* Every language version of `post`, itself included, in `posts()` order —
|
|
65
|
+
* the input to `blogPostAlternates`. Drafts are excluded like everywhere
|
|
66
|
+
* else, so an unpublished translation is never advertised.
|
|
67
|
+
*/
|
|
68
|
+
translations(post: BlogPostPreview): Promise<BlogPostPreview[]>;
|
|
47
69
|
}
|
|
48
70
|
|
|
49
71
|
const POST_FILE = /^(?:(?<flat>[^/]+)|(?<dir>[^/]+)\/index)\.(?<ext>mdx?)$/;
|
|
@@ -117,7 +139,8 @@ export function parsePost(file: RawPostFile, config: BlogConfig): BlogPost | nul
|
|
|
117
139
|
image,
|
|
118
140
|
draft: frontmatter.draft || named.draftByName,
|
|
119
141
|
featured: frontmatter.featured,
|
|
120
|
-
lang: frontmatter.lang,
|
|
142
|
+
lang: frontmatter.lang ?? config.defaultLang,
|
|
143
|
+
translationKey: frontmatter.translationKey ?? slug,
|
|
121
144
|
canonical: frontmatter.canonical,
|
|
122
145
|
format: named.format,
|
|
123
146
|
readingTimeMinutes: time.minutes,
|
|
@@ -126,45 +149,81 @@ export function parsePost(file: RawPostFile, config: BlogConfig): BlogPost | nul
|
|
|
126
149
|
};
|
|
127
150
|
}
|
|
128
151
|
|
|
152
|
+
const inLang = (post: BlogPostPreview, filter?: LangFilter): boolean =>
|
|
153
|
+
filter?.lang === undefined || post.lang === filter.lang;
|
|
154
|
+
|
|
129
155
|
export function createBlog(config: BlogConfig): Blog {
|
|
130
|
-
const
|
|
156
|
+
const all = async (): Promise<BlogPost[]> => {
|
|
131
157
|
const files = await config.source.load();
|
|
132
158
|
const parsed = files
|
|
133
159
|
.map((file) => parsePost(file, config))
|
|
134
160
|
.filter((post): post is BlogPost => post !== null);
|
|
135
161
|
|
|
136
|
-
// Collision
|
|
137
|
-
// post must fail the production build too, not only draft-enabled
|
|
138
|
-
// previews. Two files resolving to one
|
|
139
|
-
//
|
|
140
|
-
|
|
162
|
+
// Collision checks BEFORE the draft filter: a draft colliding with a
|
|
163
|
+
// live post must fail the production build too, not only draft-enabled
|
|
164
|
+
// previews. Two files resolving to one address, or two posts claiming
|
|
165
|
+
// to be the same translation, is a conflict — always a loud build
|
|
166
|
+
// failure, never a quiet last-one-wins.
|
|
167
|
+
const bySlug = new Map<string, BlogPost>();
|
|
168
|
+
const byTranslation = new Map<string, BlogPost>();
|
|
141
169
|
for (const post of parsed) {
|
|
142
|
-
|
|
143
|
-
|
|
170
|
+
const where = post.lang === undefined ? "" : ` in lang "${post.lang}"`;
|
|
171
|
+
const slugKey = `${post.lang ?? ""}\0${post.slug}`;
|
|
172
|
+
if (bySlug.has(slugKey)) {
|
|
173
|
+
throw new Error(`nk-blog: duplicate slug "${post.slug}"${where}`);
|
|
174
|
+
}
|
|
175
|
+
bySlug.set(slugKey, post);
|
|
176
|
+
|
|
177
|
+
const translationKey = `${post.lang ?? ""}\0${post.translationKey}`;
|
|
178
|
+
const claimed = byTranslation.get(translationKey);
|
|
179
|
+
if (claimed) {
|
|
180
|
+
throw new Error(
|
|
181
|
+
`nk-blog: "${claimed.slug}" and "${post.slug}" are both the${where} version of translation "${post.translationKey}"`,
|
|
182
|
+
);
|
|
144
183
|
}
|
|
145
|
-
|
|
184
|
+
byTranslation.set(translationKey, post);
|
|
146
185
|
}
|
|
147
186
|
|
|
148
|
-
return [...
|
|
187
|
+
return [...bySlug.values()]
|
|
149
188
|
.filter((post) => config.drafts === true || !post.draft)
|
|
150
189
|
.sort(
|
|
151
190
|
(a, b) =>
|
|
152
191
|
new Date(b.date).getTime() - new Date(a.date).getTime() ||
|
|
153
192
|
// Same-day posts: deterministic order between builds.
|
|
154
|
-
a.slug.localeCompare(b.slug)
|
|
193
|
+
a.slug.localeCompare(b.slug) ||
|
|
194
|
+
(a.lang ?? "").localeCompare(b.lang ?? ""),
|
|
155
195
|
);
|
|
156
196
|
};
|
|
157
197
|
|
|
198
|
+
const posts = async (filter?: LangFilter): Promise<BlogPost[]> =>
|
|
199
|
+
(await all()).filter((post) => inLang(post, filter));
|
|
200
|
+
|
|
158
201
|
return {
|
|
159
202
|
posts,
|
|
160
|
-
previews: async () =>
|
|
161
|
-
(await posts()).map(({ content: _content, ...preview }) => preview),
|
|
162
|
-
post: async (slug) =>
|
|
163
|
-
(await posts()).
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
203
|
+
previews: async (filter) =>
|
|
204
|
+
(await posts(filter)).map(({ content: _content, ...preview }) => preview),
|
|
205
|
+
post: async (slug, filter) => {
|
|
206
|
+
const matches = (await posts(filter)).filter(
|
|
207
|
+
(candidate) => candidate.slug === slug,
|
|
208
|
+
);
|
|
209
|
+
return (
|
|
210
|
+
matches.find((candidate) => candidate.lang === config.defaultLang) ??
|
|
211
|
+
matches[0] ??
|
|
212
|
+
null
|
|
213
|
+
);
|
|
214
|
+
},
|
|
215
|
+
slugs: async (filter) => (await posts(filter)).map((post) => post.slug),
|
|
216
|
+
featured: async (filter) => {
|
|
217
|
+
const listed = await posts(filter);
|
|
218
|
+
return listed.find((post) => post.featured) ?? listed[0] ?? null;
|
|
168
219
|
},
|
|
220
|
+
translations: async (post) =>
|
|
221
|
+
(await all())
|
|
222
|
+
.filter(
|
|
223
|
+
(candidate) =>
|
|
224
|
+
(candidate.translationKey ?? candidate.slug) ===
|
|
225
|
+
(post.translationKey ?? post.slug),
|
|
226
|
+
)
|
|
227
|
+
.map(({ content: _content, ...preview }) => preview),
|
|
169
228
|
};
|
|
170
229
|
}
|
package/src/index.ts
CHANGED
|
@@ -33,8 +33,11 @@ export {
|
|
|
33
33
|
} from "./reading-time.js";
|
|
34
34
|
export { formatPostDate } from "./date.js";
|
|
35
35
|
export {
|
|
36
|
+
blogIndexUrl,
|
|
37
|
+
blogPostAlternates,
|
|
36
38
|
blogPostArticle,
|
|
37
39
|
blogPostBreadcrumbs,
|
|
38
40
|
postUrl,
|
|
41
|
+
type BlogPostAlternates,
|
|
39
42
|
type BlogSeoConfig,
|
|
40
43
|
} from "./seo.js";
|
package/src/schema.ts
CHANGED
|
@@ -54,8 +54,13 @@ export const blogFrontmatterSchema = z
|
|
|
54
54
|
slug: slugSchema.optional(),
|
|
55
55
|
draft: z.boolean().default(false),
|
|
56
56
|
featured: z.boolean().default(false),
|
|
57
|
-
//
|
|
57
|
+
// The post's language (e.g. "fr"); `BlogConfig.defaultLang` when absent.
|
|
58
58
|
lang: nonEmpty.optional(),
|
|
59
|
+
// Groups a post with its translations; defaults to the slug, so posts
|
|
60
|
+
// sharing a slug across languages link without declaring it. Set it
|
|
61
|
+
// when a translation carries its own slug.
|
|
62
|
+
translationKey: nonEmpty.optional(),
|
|
63
|
+
// Reserved — validated now so adding behavior later isn't breaking.
|
|
59
64
|
canonical: nonEmpty.optional(),
|
|
60
65
|
})
|
|
61
66
|
.transform(({ author, authors, coverImage, image, ...rest }) => ({
|
package/src/seo.ts
CHANGED
|
@@ -18,10 +18,73 @@ export interface BlogSeoConfig {
|
|
|
18
18
|
publisher?: OrganizationInput;
|
|
19
19
|
/** Crumb label for the blog index; defaults to "Blog". */
|
|
20
20
|
blogName?: string;
|
|
21
|
+
/**
|
|
22
|
+
* The blog's default language — the same value as `BlogConfig.defaultLang`.
|
|
23
|
+
* Its posts live at `basePath`; every other language's posts at
|
|
24
|
+
* `/<lang><basePath>` (`/fr/blog/<slug>`), matching nk-i18n's prefix
|
|
25
|
+
* strategy. Unset, no URL carries a language.
|
|
26
|
+
*
|
|
27
|
+
* The default language is deliberately unprefixed, unlike nk-i18n's
|
|
28
|
+
* negotiated pages: a post is one document in one language, not a page
|
|
29
|
+
* rendered per visitor, so it has exactly one address and there is no
|
|
30
|
+
* language-neutral bare URL to keep free.
|
|
31
|
+
*/
|
|
32
|
+
defaultLang?: string;
|
|
21
33
|
}
|
|
22
34
|
|
|
35
|
+
/** `/fr` for a non-default language, `""` for the default (or no language). */
|
|
36
|
+
const langPrefix = (lang: string | undefined, config: BlogSeoConfig): string =>
|
|
37
|
+
config.defaultLang !== undefined &&
|
|
38
|
+
lang !== undefined &&
|
|
39
|
+
lang !== config.defaultLang
|
|
40
|
+
? `/${lang}`
|
|
41
|
+
: "";
|
|
42
|
+
|
|
43
|
+
/** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
|
|
44
|
+
export function blogIndexUrl(lang: string | undefined, config: BlogSeoConfig): string {
|
|
45
|
+
return `${config.baseUrl}${langPrefix(lang, config)}${config.basePath}`;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** Absolute URL of a post, prefixed by its language when that isn't the default. */
|
|
23
49
|
export function postUrl(post: BlogPostPreview, config: BlogSeoConfig): string {
|
|
24
|
-
return `${
|
|
50
|
+
return `${blogIndexUrl(post.lang, config)}/${post.slug}`;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export interface BlogPostAlternates {
|
|
54
|
+
/** The post's own address, or its `canonical` override. */
|
|
55
|
+
canonical: string;
|
|
56
|
+
/**
|
|
57
|
+
* hreflang → URL for every language version, plus `x-default` pointing at
|
|
58
|
+
* the default-language version when there is one. Empty for a post with no
|
|
59
|
+
* translation: a single-member cluster says nothing.
|
|
60
|
+
*/
|
|
61
|
+
languages: Record<string, string>;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Canonical + hreflang alternates for a post, from `blog.translations(post)`.
|
|
66
|
+
* Spread into Next's `Metadata.alternates`. A post links only to versions that
|
|
67
|
+
* exist, so a French-only article never advertises an English URL.
|
|
68
|
+
*/
|
|
69
|
+
export function blogPostAlternates(
|
|
70
|
+
post: BlogPostPreview,
|
|
71
|
+
translations: readonly BlogPostPreview[],
|
|
72
|
+
config: BlogSeoConfig,
|
|
73
|
+
): BlogPostAlternates {
|
|
74
|
+
const canonical = toAbsoluteUrl(
|
|
75
|
+
post.canonical ?? postUrl(post, config),
|
|
76
|
+
config.baseUrl,
|
|
77
|
+
);
|
|
78
|
+
const versions = translations.filter((version) => version.lang !== undefined);
|
|
79
|
+
if (versions.length < 2) return { canonical, languages: {} };
|
|
80
|
+
|
|
81
|
+
const languages: Record<string, string> = {};
|
|
82
|
+
for (const version of versions) {
|
|
83
|
+
if (version.lang) languages[version.lang] = postUrl(version, config);
|
|
84
|
+
}
|
|
85
|
+
const fallback = versions.find((version) => version.lang === config.defaultLang);
|
|
86
|
+
if (fallback) languages["x-default"] = postUrl(fallback, config);
|
|
87
|
+
return { canonical, languages };
|
|
25
88
|
}
|
|
26
89
|
|
|
27
90
|
// JSON-LD consumers don't resolve relative URLs, so anything without a scheme
|
|
@@ -52,6 +115,7 @@ export function blogPostArticle(
|
|
|
52
115
|
image: post.image ? toAbsoluteUrl(post.image, config.baseUrl) : undefined,
|
|
53
116
|
keywords: post.tags.length ? post.tags : undefined,
|
|
54
117
|
publisher: config.publisher,
|
|
118
|
+
...(post.lang ? { extra: { inLanguage: post.lang } } : {}),
|
|
55
119
|
...overrides,
|
|
56
120
|
});
|
|
57
121
|
}
|
|
@@ -62,8 +126,8 @@ export function blogPostBreadcrumbs(
|
|
|
62
126
|
config: BlogSeoConfig,
|
|
63
127
|
): WithContext<BreadcrumbListNode> {
|
|
64
128
|
return breadcrumbList([
|
|
65
|
-
{ name: "Home", url: config.baseUrl },
|
|
66
|
-
{ name: config.blogName ?? "Blog", url:
|
|
129
|
+
{ name: "Home", url: `${config.baseUrl}${langPrefix(post.lang, config)}` },
|
|
130
|
+
{ name: config.blogName ?? "Blog", url: blogIndexUrl(post.lang, config) },
|
|
67
131
|
{ name: post.title, url: postUrl(post, config) },
|
|
68
132
|
]);
|
|
69
133
|
}
|
package/src/server.ts
CHANGED
package/src/types.ts
CHANGED
|
@@ -18,8 +18,17 @@ export interface BlogPostPreview {
|
|
|
18
18
|
image?: string;
|
|
19
19
|
draft: boolean;
|
|
20
20
|
featured: boolean;
|
|
21
|
-
/**
|
|
21
|
+
/**
|
|
22
|
+
* The post's language: frontmatter `lang`, else `BlogConfig.defaultLang`.
|
|
23
|
+
* Undefined on a single-language blog that sets neither.
|
|
24
|
+
*/
|
|
22
25
|
lang?: string;
|
|
26
|
+
/**
|
|
27
|
+
* Shared by a post and its translations: frontmatter `translationKey`, else
|
|
28
|
+
* the slug. Always set by the reader; optional so hand-built previews
|
|
29
|
+
* (tests, fixtures) need not spell it out.
|
|
30
|
+
*/
|
|
31
|
+
translationKey?: string;
|
|
23
32
|
/** Reserved canonical-URL override for syndicated posts. */
|
|
24
33
|
canonical?: string;
|
|
25
34
|
format: PostFormat;
|