mdorigin 0.1.8 → 0.2.1
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 +14 -0
- package/dist/adapters/cloudflare.d.ts +42 -5
- package/dist/adapters/cloudflare.js +250 -10
- package/dist/adapters/node.js +2 -2
- package/dist/cli/build-cloudflare.js +27 -2
- package/dist/cli/build-search.js +15 -4
- package/dist/cli/help.js +8 -7
- package/dist/cli/init-cloudflare.js +7 -1
- package/dist/cli/main.js +5 -0
- package/dist/cli/search.js +16 -4
- package/dist/cli/sync-cloudflare-r2.d.ts +1 -0
- package/dist/cli/sync-cloudflare-r2.js +47 -0
- package/dist/cloudflare-runtime.d.ts +1 -1
- package/dist/cloudflare.d.ts +44 -6
- package/dist/cloudflare.js +340 -19
- package/dist/core/api.js +34 -1
- package/dist/core/content-store.d.ts +1 -0
- package/dist/core/content-store.js +8 -1
- package/dist/core/extensions.d.ts +5 -9
- package/dist/core/markdown.d.ts +1 -0
- package/dist/core/markdown.js +9 -2
- package/dist/core/request-handler.js +46 -60
- package/dist/core/site-config.d.ts +4 -10
- package/dist/core/site-config.js +18 -10
- package/dist/html/template.d.ts +5 -9
- package/dist/html/template.js +25 -25
- package/dist/html/theme.d.ts +1 -2
- package/dist/html/theme.js +2 -642
- package/dist/index-builder.js +5 -4
- package/dist/search.d.ts +27 -4
- package/dist/search.js +301 -38
- package/package.json +5 -3
- package/dist/html/template-kind.d.ts +0 -1
- package/dist/html/template-kind.js +0 -1
|
@@ -1,4 +1,7 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
|
+
export function isIgnoredContentName(name) {
|
|
3
|
+
return name.startsWith('.');
|
|
4
|
+
}
|
|
2
5
|
export class MemoryContentStore {
|
|
3
6
|
entries;
|
|
4
7
|
constructor(entries) {
|
|
@@ -23,7 +26,7 @@ export class MemoryContentStore {
|
|
|
23
26
|
continue;
|
|
24
27
|
}
|
|
25
28
|
const [firstSegment, ...rest] = remainder.split('/');
|
|
26
|
-
if (firstSegment
|
|
29
|
+
if (isIgnoredContentName(firstSegment)) {
|
|
27
30
|
continue;
|
|
28
31
|
}
|
|
29
32
|
if (rest.length === 0) {
|
|
@@ -53,6 +56,7 @@ const MEDIA_TYPES = new Map([
|
|
|
53
56
|
['.js', 'text/javascript; charset=utf-8'],
|
|
54
57
|
['.json', 'application/json; charset=utf-8'],
|
|
55
58
|
['.md', 'text/markdown; charset=utf-8'],
|
|
59
|
+
['.mp4', 'video/mp4'],
|
|
56
60
|
['.pdf', 'application/pdf'],
|
|
57
61
|
['.py', 'text/plain; charset=utf-8'],
|
|
58
62
|
['.png', 'image/png'],
|
|
@@ -84,6 +88,9 @@ export function normalizeContentPath(inputPath) {
|
|
|
84
88
|
resolved.includes('/../')) {
|
|
85
89
|
return null;
|
|
86
90
|
}
|
|
91
|
+
if (resolved.split('/').some(isIgnoredContentName)) {
|
|
92
|
+
return null;
|
|
93
|
+
}
|
|
87
94
|
return resolved;
|
|
88
95
|
}
|
|
89
96
|
export function normalizeDirectoryPath(inputPath) {
|
|
@@ -1,7 +1,5 @@
|
|
|
1
1
|
import type { ManagedIndexEntry, ParsedDocumentMeta } from './markdown.js';
|
|
2
2
|
import type { EditLinkConfig, ResolvedSiteConfig, SiteLogo, SiteNavItem, SiteSocialLink } from './site-config.js';
|
|
3
|
-
import type { TemplateName } from '../html/template-kind.js';
|
|
4
|
-
import type { BuiltInThemeName } from '../html/theme.js';
|
|
5
3
|
type MaybePromise<T> = T | Promise<T>;
|
|
6
4
|
export interface IndexTransformContext {
|
|
7
5
|
mode: 'build' | 'render';
|
|
@@ -11,7 +9,7 @@ export interface IndexTransformContext {
|
|
|
11
9
|
siteConfig?: ResolvedSiteConfig;
|
|
12
10
|
}
|
|
13
11
|
export interface PageRenderModel {
|
|
14
|
-
kind: '
|
|
12
|
+
kind: 'page' | 'listing';
|
|
15
13
|
requestPath: string;
|
|
16
14
|
sourcePath: string;
|
|
17
15
|
siteTitle: string;
|
|
@@ -27,8 +25,6 @@ export interface PageRenderModel {
|
|
|
27
25
|
date?: string;
|
|
28
26
|
showSummary: boolean;
|
|
29
27
|
showDate: boolean;
|
|
30
|
-
theme: BuiltInThemeName;
|
|
31
|
-
template: TemplateName;
|
|
32
28
|
topNav: SiteNavItem[];
|
|
33
29
|
footerNav: SiteNavItem[];
|
|
34
30
|
footerText?: string;
|
|
@@ -38,10 +34,10 @@ export interface PageRenderModel {
|
|
|
38
34
|
stylesheetContent?: string;
|
|
39
35
|
canonicalPath?: string;
|
|
40
36
|
alternateMarkdownPath?: string;
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
37
|
+
listingEntries: ManagedIndexEntry[];
|
|
38
|
+
listingRequestPath: string;
|
|
39
|
+
listingInitialPostCount: number;
|
|
40
|
+
listingLoadMoreStep: number;
|
|
45
41
|
searchEnabled: boolean;
|
|
46
42
|
}
|
|
47
43
|
export interface RenderHookContext {
|
package/dist/core/markdown.d.ts
CHANGED
|
@@ -28,5 +28,6 @@ export declare function parseMarkdownDocument(sourcePath: string, markdown: stri
|
|
|
28
28
|
export declare function renderMarkdown(markdown: string): Promise<string>;
|
|
29
29
|
export declare function rewriteMarkdownLinksInHtml(html: string): string;
|
|
30
30
|
export declare function stripManagedIndexBlock(markdown: string): string;
|
|
31
|
+
export declare function stripMachineOnlyMarkdownComments(markdown: string): string;
|
|
31
32
|
export declare function stripManagedIndexLinks(markdown: string, hrefs: ReadonlySet<string>): string;
|
|
32
33
|
export declare function extractManagedIndexEntries(markdown: string): ManagedIndexEntry[];
|
package/dist/core/markdown.js
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import matter from 'gray-matter';
|
|
2
2
|
import { remark } from 'remark';
|
|
3
3
|
import remarkGfm from 'remark-gfm';
|
|
4
|
-
import
|
|
4
|
+
import remarkRehype from 'remark-rehype';
|
|
5
|
+
import rehypeRaw from 'rehype-raw';
|
|
6
|
+
import rehypeStringify from 'rehype-stringify';
|
|
5
7
|
export function getDocumentTitle(meta, body, fallback) {
|
|
6
8
|
return (firstNonEmptyString(meta.title, meta.name) ??
|
|
7
9
|
extractFirstHeading(body) ??
|
|
@@ -24,7 +26,9 @@ export async function parseMarkdownDocument(sourcePath, markdown) {
|
|
|
24
26
|
export async function renderMarkdown(markdown) {
|
|
25
27
|
const output = await remark()
|
|
26
28
|
.use(remarkGfm)
|
|
27
|
-
.use(
|
|
29
|
+
.use(remarkRehype, { allowDangerousHtml: true })
|
|
30
|
+
.use(rehypeRaw)
|
|
31
|
+
.use(rehypeStringify, { allowDangerousHtml: true })
|
|
28
32
|
.process(markdown);
|
|
29
33
|
return String(output);
|
|
30
34
|
}
|
|
@@ -34,6 +38,9 @@ export function rewriteMarkdownLinksInHtml(html) {
|
|
|
34
38
|
export function stripManagedIndexBlock(markdown) {
|
|
35
39
|
return markdown.replace(/\n?<!-- INDEX:START -->[\s\S]*?<!-- INDEX:END -->\n?/g, '\n').trimEnd();
|
|
36
40
|
}
|
|
41
|
+
export function stripMachineOnlyMarkdownComments(markdown) {
|
|
42
|
+
return markdown.replace(/<!--\s*mdorigin:[\s\S]*?-->/g, '');
|
|
43
|
+
}
|
|
37
44
|
export function stripManagedIndexLinks(markdown, hrefs) {
|
|
38
45
|
if (hrefs.size === 0) {
|
|
39
46
|
return markdown;
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
|
+
import { isIgnoredContentName } from './content-store.js';
|
|
2
3
|
import { inferDirectoryContentType } from './content-type.js';
|
|
3
4
|
import { getDirectoryIndexCandidates } from './directory-index.js';
|
|
4
5
|
import { extractManagedIndexEntries, getDocumentSummary, getDocumentTitle as getParsedDocumentTitle, parseMarkdownDocument, stripManagedIndexBlock, stripManagedIndexLinks, } from './markdown.js';
|
|
5
6
|
import { applyIndexTransforms, renderFooterOverride, renderHeaderOverride, renderPageWithPlugins, transformHtmlWithPlugins, } from './extensions.js';
|
|
6
7
|
import { handleApiRoute } from './api.js';
|
|
7
8
|
import { normalizeRequestPath, resolveRequest } from './router.js';
|
|
8
|
-
import { escapeHtml,
|
|
9
|
+
import { escapeHtml, renderListingArticleItems, renderDocument, } from '../html/template.js';
|
|
9
10
|
export async function handleSiteRequest(store, pathname, options) {
|
|
10
11
|
const plugins = options.plugins ?? [];
|
|
11
12
|
const searchEnabled = options.searchApi !== undefined;
|
|
@@ -21,7 +22,7 @@ export async function handleSiteRequest(store, pathname, options) {
|
|
|
21
22
|
return renderSitemap(store, options);
|
|
22
23
|
}
|
|
23
24
|
const resolved = resolveRequest(pathname);
|
|
24
|
-
const
|
|
25
|
+
const listingFragmentRequest = getListingFragmentRequest(options.searchParams);
|
|
25
26
|
const negotiatedMarkdown = shouldServeMarkdownForRequest(resolved, options.acceptHeader);
|
|
26
27
|
if (resolved.kind === 'not-found' || !resolved.sourcePath) {
|
|
27
28
|
const aliasRedirect = await tryRedirectAlias(store, pathname, options);
|
|
@@ -82,21 +83,16 @@ export async function handleSiteRequest(store, pathname, options) {
|
|
|
82
83
|
: isRootHomeRequest(resolved.requestPath) && navigation.items.length > 0
|
|
83
84
|
? stripManagedIndexLinks(entry.text, new Set(navigation.items.map((item) => item.href)))
|
|
84
85
|
: entry.text;
|
|
85
|
-
const
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
return renderCatalogPostsFragment(catalogEntries, catalogFragmentRequest);
|
|
96
|
-
}
|
|
97
|
-
const documentBody = options.siteConfig.template === 'catalog'
|
|
98
|
-
? stripManagedIndexBlock(renderedBody)
|
|
99
|
-
: renderedBody;
|
|
86
|
+
const listingEntries = await applyIndexTransforms(extractManagedIndexEntries(renderedBody), plugins, {
|
|
87
|
+
mode: 'render',
|
|
88
|
+
requestPath: resolved.requestPath,
|
|
89
|
+
sourcePath: resolved.sourcePath,
|
|
90
|
+
siteConfig: options.siteConfig,
|
|
91
|
+
});
|
|
92
|
+
if (listingFragmentRequest !== null && listingEntries.length > 0) {
|
|
93
|
+
return renderListingPostsFragment(listingEntries, listingFragmentRequest);
|
|
94
|
+
}
|
|
95
|
+
const documentBody = listingEntries.length > 0 ? stripManagedIndexBlock(renderedBody) : renderedBody;
|
|
100
96
|
const renderedParsed = documentBody === entry.text
|
|
101
97
|
? parsed
|
|
102
98
|
: await parseMarkdownDocument(resolved.sourcePath, documentBody);
|
|
@@ -107,18 +103,19 @@ export async function handleSiteRequest(store, pathname, options) {
|
|
|
107
103
|
renderedParsed,
|
|
108
104
|
siteConfig: options.siteConfig,
|
|
109
105
|
topNav: navigation.items,
|
|
110
|
-
|
|
106
|
+
listingEntries,
|
|
111
107
|
searchEnabled,
|
|
112
108
|
plugins,
|
|
113
109
|
varyOnAccept: shouldVaryOnAccept(resolved),
|
|
114
110
|
});
|
|
115
111
|
}
|
|
116
|
-
function
|
|
117
|
-
|
|
112
|
+
function getListingFragmentRequest(searchParams) {
|
|
113
|
+
const format = searchParams?.get('listing-format') ?? searchParams?.get('catalog-format');
|
|
114
|
+
if (format !== 'posts') {
|
|
118
115
|
return null;
|
|
119
116
|
}
|
|
120
|
-
const offset = normalizeNonNegativeInteger(searchParams
|
|
121
|
-
const limit = normalizePositiveInteger(searchParams
|
|
117
|
+
const offset = normalizeNonNegativeInteger(searchParams?.get('listing-offset') ?? searchParams?.get('catalog-offset') ?? null);
|
|
118
|
+
const limit = normalizePositiveInteger(searchParams?.get('listing-limit') ?? searchParams?.get('catalog-limit') ?? null);
|
|
122
119
|
if (offset === null || limit === null) {
|
|
123
120
|
return null;
|
|
124
121
|
}
|
|
@@ -140,7 +137,7 @@ function normalizePositiveInteger(value) {
|
|
|
140
137
|
}
|
|
141
138
|
function buildPageRenderModel(options) {
|
|
142
139
|
return {
|
|
143
|
-
kind: options.
|
|
140
|
+
kind: options.listingEntries.length > 0 ? 'listing' : 'page',
|
|
144
141
|
requestPath: options.resolvedRequestPath,
|
|
145
142
|
sourcePath: options.sourcePath,
|
|
146
143
|
siteTitle: options.siteConfig.siteTitle,
|
|
@@ -158,8 +155,6 @@ function buildPageRenderModel(options) {
|
|
|
158
155
|
date: options.siteConfig.showDate === false ? undefined : options.parsed.meta.date,
|
|
159
156
|
showSummary: options.siteConfig.showSummary,
|
|
160
157
|
showDate: options.siteConfig.showDate,
|
|
161
|
-
theme: options.siteConfig.theme,
|
|
162
|
-
template: options.siteConfig.template,
|
|
163
158
|
topNav: options.topNav,
|
|
164
159
|
footerNav: options.siteConfig.footerNav,
|
|
165
160
|
footerText: options.siteConfig.footerText,
|
|
@@ -169,10 +164,10 @@ function buildPageRenderModel(options) {
|
|
|
169
164
|
stylesheetContent: options.siteConfig.stylesheetContent,
|
|
170
165
|
canonicalPath: getCanonicalHtmlPathForContentPath(options.sourcePath),
|
|
171
166
|
alternateMarkdownPath: getMarkdownRequestPathForContentPath(options.sourcePath),
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
167
|
+
listingEntries: options.listingEntries,
|
|
168
|
+
listingRequestPath: options.resolvedRequestPath,
|
|
169
|
+
listingInitialPostCount: options.siteConfig.listingInitialPostCount,
|
|
170
|
+
listingLoadMoreStep: options.siteConfig.listingLoadMoreStep,
|
|
176
171
|
searchEnabled: options.searchEnabled,
|
|
177
172
|
};
|
|
178
173
|
}
|
|
@@ -184,7 +179,7 @@ async function renderStructuredPage(options) {
|
|
|
184
179
|
parsed: options.parsed,
|
|
185
180
|
siteConfig: options.siteConfig,
|
|
186
181
|
topNav: options.topNav,
|
|
187
|
-
|
|
182
|
+
listingEntries: options.listingEntries,
|
|
188
183
|
searchEnabled: options.searchEnabled,
|
|
189
184
|
});
|
|
190
185
|
const renderContext = {
|
|
@@ -198,7 +193,7 @@ async function renderStructuredPage(options) {
|
|
|
198
193
|
};
|
|
199
194
|
const headerHtml = await renderHeaderOverride(options.plugins, currentContext);
|
|
200
195
|
const footerHtml = await renderFooterOverride(options.plugins, currentContext);
|
|
201
|
-
return
|
|
196
|
+
return renderDocument({
|
|
202
197
|
siteTitle: currentPage.siteTitle,
|
|
203
198
|
siteDescription: currentPage.siteDescription,
|
|
204
199
|
siteUrl: currentPage.siteUrl,
|
|
@@ -211,8 +206,6 @@ async function renderStructuredPage(options) {
|
|
|
211
206
|
date: currentPage.date,
|
|
212
207
|
showSummary: currentPage.showSummary,
|
|
213
208
|
showDate: currentPage.showDate,
|
|
214
|
-
theme: currentPage.theme,
|
|
215
|
-
template: currentPage.template,
|
|
216
209
|
topNav: currentPage.topNav,
|
|
217
210
|
footerNav: currentPage.footerNav,
|
|
218
211
|
footerText: currentPage.footerText,
|
|
@@ -221,14 +214,14 @@ async function renderStructuredPage(options) {
|
|
|
221
214
|
stylesheetContent: currentPage.stylesheetContent,
|
|
222
215
|
canonicalPath: currentPage.canonicalPath,
|
|
223
216
|
alternateMarkdownPath: currentPage.alternateMarkdownPath,
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
217
|
+
listingEntries: currentPage.listingEntries,
|
|
218
|
+
listingRequestPath: currentPage.listingRequestPath,
|
|
219
|
+
listingInitialPostCount: currentPage.listingInitialPostCount,
|
|
220
|
+
listingLoadMoreStep: currentPage.listingLoadMoreStep,
|
|
228
221
|
searchEnabled: currentPage.searchEnabled,
|
|
229
222
|
headerHtml,
|
|
230
223
|
footerHtml,
|
|
231
|
-
})
|
|
224
|
+
});
|
|
232
225
|
});
|
|
233
226
|
const finalHtml = await transformHtmlWithPlugins(renderedPage.html, options.plugins, {
|
|
234
227
|
page: renderedPage.page,
|
|
@@ -242,7 +235,7 @@ async function renderStructuredPage(options) {
|
|
|
242
235
|
body: finalHtml,
|
|
243
236
|
};
|
|
244
237
|
}
|
|
245
|
-
function
|
|
238
|
+
function renderListingPostsFragment(entries, request) {
|
|
246
239
|
const articles = entries.filter((entry) => entry.kind === 'article');
|
|
247
240
|
const visibleArticles = articles.slice(request.offset, request.offset + request.limit);
|
|
248
241
|
const nextOffset = request.offset + visibleArticles.length;
|
|
@@ -252,7 +245,7 @@ function renderCatalogPostsFragment(entries, request) {
|
|
|
252
245
|
'content-type': 'application/json; charset=utf-8',
|
|
253
246
|
},
|
|
254
247
|
body: JSON.stringify({
|
|
255
|
-
itemsHtml:
|
|
248
|
+
itemsHtml: renderListingArticleItems(visibleArticles),
|
|
256
249
|
hasMore: nextOffset < articles.length,
|
|
257
250
|
nextOffset,
|
|
258
251
|
}),
|
|
@@ -424,8 +417,6 @@ async function renderDirectoryListing(store, requestPath, siteConfig, searchEnab
|
|
|
424
417
|
body,
|
|
425
418
|
showSummary: false,
|
|
426
419
|
showDate: false,
|
|
427
|
-
theme: siteConfig.theme,
|
|
428
|
-
template: siteConfig.template,
|
|
429
420
|
topNav: navigation.items,
|
|
430
421
|
footerNav: siteConfig.footerNav,
|
|
431
422
|
footerText: siteConfig.footerText,
|
|
@@ -484,22 +475,17 @@ async function tryRenderAlternateDirectoryIndex(store, requestPath, options) {
|
|
|
484
475
|
: isRootHomeRequest(requestPath) && navigation.items.length > 0
|
|
485
476
|
? stripManagedIndexLinks(entry.text, new Set(navigation.items.map((item) => item.href)))
|
|
486
477
|
: entry.text;
|
|
487
|
-
const
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
return renderCatalogPostsFragment(catalogEntries, catalogFragmentRequest);
|
|
499
|
-
}
|
|
500
|
-
const documentBody = options.siteConfig.template === 'catalog'
|
|
501
|
-
? stripManagedIndexBlock(renderedBody)
|
|
502
|
-
: renderedBody;
|
|
478
|
+
const listingEntries = await applyIndexTransforms(extractManagedIndexEntries(renderedBody), plugins, {
|
|
479
|
+
mode: 'render',
|
|
480
|
+
requestPath,
|
|
481
|
+
sourcePath: candidatePath,
|
|
482
|
+
siteConfig: options.siteConfig,
|
|
483
|
+
});
|
|
484
|
+
const listingFragmentRequest = getListingFragmentRequest(options.searchParams);
|
|
485
|
+
if (listingFragmentRequest !== null && listingEntries.length > 0) {
|
|
486
|
+
return renderListingPostsFragment(listingEntries, listingFragmentRequest);
|
|
487
|
+
}
|
|
488
|
+
const documentBody = listingEntries.length > 0 ? stripManagedIndexBlock(renderedBody) : renderedBody;
|
|
503
489
|
const renderedParsed = documentBody === entry.text
|
|
504
490
|
? parsed
|
|
505
491
|
: await parseMarkdownDocument(candidatePath, documentBody);
|
|
@@ -510,7 +496,7 @@ async function tryRenderAlternateDirectoryIndex(store, requestPath, options) {
|
|
|
510
496
|
renderedParsed,
|
|
511
497
|
siteConfig: options.siteConfig,
|
|
512
498
|
topNav: navigation.items,
|
|
513
|
-
|
|
499
|
+
listingEntries,
|
|
514
500
|
searchEnabled: options.searchApi !== undefined,
|
|
515
501
|
plugins,
|
|
516
502
|
});
|
|
@@ -750,7 +736,7 @@ async function inspectDirectoryShape(store, directoryPath) {
|
|
|
750
736
|
let hasExtraMarkdownFiles = false;
|
|
751
737
|
let hasAssetFiles = false;
|
|
752
738
|
for (const entry of entries) {
|
|
753
|
-
if (entry.name
|
|
739
|
+
if (isIgnoredContentName(entry.name)) {
|
|
754
740
|
continue;
|
|
755
741
|
}
|
|
756
742
|
if (entry.kind === 'directory') {
|
|
@@ -1,7 +1,5 @@
|
|
|
1
1
|
import type { ContentStore } from './content-store.js';
|
|
2
2
|
import type { MdoPlugin } from './extensions.js';
|
|
3
|
-
import type { TemplateName } from '../html/template-kind.js';
|
|
4
|
-
import type { BuiltInThemeName } from '../html/theme.js';
|
|
5
3
|
export interface SiteNavItem {
|
|
6
4
|
label: string;
|
|
7
5
|
href: string;
|
|
@@ -29,16 +27,14 @@ export interface SiteConfig {
|
|
|
29
27
|
showDate?: boolean;
|
|
30
28
|
showSummary?: boolean;
|
|
31
29
|
stylesheet?: string;
|
|
32
|
-
theme?: BuiltInThemeName;
|
|
33
|
-
template?: TemplateName;
|
|
34
30
|
topNav?: SiteNavItem[];
|
|
35
31
|
footerNav?: SiteNavItem[];
|
|
36
32
|
footerText?: string;
|
|
37
33
|
socialLinks?: SiteSocialLink[];
|
|
38
34
|
editLink?: EditLinkConfig;
|
|
39
35
|
showHomeIndex?: boolean;
|
|
40
|
-
|
|
41
|
-
|
|
36
|
+
listingInitialPostCount?: number;
|
|
37
|
+
listingLoadMoreStep?: number;
|
|
42
38
|
}
|
|
43
39
|
export interface UserSiteConfig extends SiteConfig {
|
|
44
40
|
plugins?: MdoPlugin[];
|
|
@@ -52,16 +48,14 @@ export interface ResolvedSiteConfig {
|
|
|
52
48
|
logo?: SiteLogo;
|
|
53
49
|
showDate: boolean;
|
|
54
50
|
showSummary: boolean;
|
|
55
|
-
theme: BuiltInThemeName;
|
|
56
|
-
template: TemplateName;
|
|
57
51
|
topNav: SiteNavItem[];
|
|
58
52
|
footerNav: SiteNavItem[];
|
|
59
53
|
footerText?: string;
|
|
60
54
|
socialLinks: SiteSocialLink[];
|
|
61
55
|
editLink?: EditLinkConfig;
|
|
62
56
|
showHomeIndex: boolean;
|
|
63
|
-
|
|
64
|
-
|
|
57
|
+
listingInitialPostCount: number;
|
|
58
|
+
listingLoadMoreStep: number;
|
|
65
59
|
stylesheetContent?: string;
|
|
66
60
|
siteTitleConfigured: boolean;
|
|
67
61
|
siteDescriptionConfigured: boolean;
|
package/dist/core/site-config.js
CHANGED
|
@@ -14,6 +14,7 @@ export async function loadUserSiteConfig(options = {}) {
|
|
|
14
14
|
? path.resolve(cwd, options.configPath)
|
|
15
15
|
: await resolveDefaultConfigPath(cwd, rootDir);
|
|
16
16
|
const parsedConfig = await loadConfigSource(configFilePath);
|
|
17
|
+
const legacyConfig = parsedConfig;
|
|
17
18
|
const stylesheetPath = parsedConfig.stylesheet
|
|
18
19
|
? path.resolve(path.dirname(configFilePath), parsedConfig.stylesheet)
|
|
19
20
|
: null;
|
|
@@ -34,8 +35,6 @@ export async function loadUserSiteConfig(options = {}) {
|
|
|
34
35
|
logo: normalizeLogo(parsedConfig.logo),
|
|
35
36
|
showDate: parsedConfig.showDate ?? true,
|
|
36
37
|
showSummary: parsedConfig.showSummary ?? true,
|
|
37
|
-
theme: isBuiltInThemeName(parsedConfig.theme) ? parsedConfig.theme : 'paper',
|
|
38
|
-
template: isTemplateName(parsedConfig.template) ? parsedConfig.template : 'document',
|
|
39
38
|
topNav: normalizeTopNav(parsedConfig.topNav),
|
|
40
39
|
footerNav: normalizeTopNav(parsedConfig.footerNav),
|
|
41
40
|
footerText: typeof parsedConfig.footerText === 'string' && parsedConfig.footerText !== ''
|
|
@@ -46,13 +45,14 @@ export async function loadUserSiteConfig(options = {}) {
|
|
|
46
45
|
showHomeIndex: typeof parsedConfig.showHomeIndex === 'boolean'
|
|
47
46
|
? parsedConfig.showHomeIndex
|
|
48
47
|
: normalizeTopNav(parsedConfig.topNav).length === 0,
|
|
49
|
-
|
|
50
|
-
|
|
48
|
+
listingInitialPostCount: normalizePositiveInteger(parsedConfig.listingInitialPostCount ?? legacyConfig.catalogInitialPostCount, 10),
|
|
49
|
+
listingLoadMoreStep: normalizePositiveInteger(parsedConfig.listingLoadMoreStep ?? legacyConfig.catalogLoadMoreStep, 10),
|
|
51
50
|
stylesheetContent,
|
|
52
51
|
siteTitleConfigured: typeof parsedConfig.siteTitle === 'string' && parsedConfig.siteTitle !== '',
|
|
53
52
|
siteDescriptionConfigured: typeof parsedConfig.siteDescription === 'string' &&
|
|
54
53
|
parsedConfig.siteDescription !== '',
|
|
55
54
|
};
|
|
55
|
+
warnOnLegacyConfig(legacyConfig, configFilePath);
|
|
56
56
|
return {
|
|
57
57
|
siteConfig,
|
|
58
58
|
plugins: Array.isArray(parsedConfig.plugins) ? parsedConfig.plugins : [],
|
|
@@ -93,12 +93,6 @@ async function resolveDefaultConfigPath(cwd, rootDir) {
|
|
|
93
93
|
}
|
|
94
94
|
return (await findConfigPath(cwd)) ?? path.join(cwd, 'mdorigin.config.json');
|
|
95
95
|
}
|
|
96
|
-
function isBuiltInThemeName(value) {
|
|
97
|
-
return value === 'paper' || value === 'atlas' || value === 'gazette';
|
|
98
|
-
}
|
|
99
|
-
function isTemplateName(value) {
|
|
100
|
-
return value === 'document' || value === 'catalog';
|
|
101
|
-
}
|
|
102
96
|
function isNodeNotFound(error) {
|
|
103
97
|
return (typeof error === 'object' &&
|
|
104
98
|
error !== null &&
|
|
@@ -275,3 +269,17 @@ function normalizeSiteHref(value) {
|
|
|
275
269
|
}
|
|
276
270
|
return `/${value.replace(/^\.?\//, '')}`;
|
|
277
271
|
}
|
|
272
|
+
function warnOnLegacyConfig(config, configFilePath) {
|
|
273
|
+
if ('theme' in config) {
|
|
274
|
+
console.warn(`[mdorigin] ${configFilePath}: "theme" is deprecated and ignored. mdorigin now uses a single built-in atlas presentation.`);
|
|
275
|
+
}
|
|
276
|
+
if ('template' in config) {
|
|
277
|
+
console.warn(`[mdorigin] ${configFilePath}: "template" is deprecated and ignored. Listing behavior is now part of the default presentation.`);
|
|
278
|
+
}
|
|
279
|
+
if ('catalogInitialPostCount' in config) {
|
|
280
|
+
console.warn(`[mdorigin] ${configFilePath}: "catalogInitialPostCount" is deprecated. Use "listingInitialPostCount" instead.`);
|
|
281
|
+
}
|
|
282
|
+
if ('catalogLoadMoreStep' in config) {
|
|
283
|
+
console.warn(`[mdorigin] ${configFilePath}: "catalogLoadMoreStep" is deprecated. Use "listingLoadMoreStep" instead.`);
|
|
284
|
+
}
|
|
285
|
+
}
|
package/dist/html/template.d.ts
CHANGED
|
@@ -1,7 +1,5 @@
|
|
|
1
1
|
import type { SiteLogo, SiteNavItem, SiteSocialLink } from '../core/site-config.js';
|
|
2
2
|
import type { ManagedIndexEntry } from '../core/markdown.js';
|
|
3
|
-
import type { TemplateName } from './template-kind.js';
|
|
4
|
-
import { type BuiltInThemeName } from './theme.js';
|
|
5
3
|
export interface RenderDocumentOptions {
|
|
6
4
|
siteTitle: string;
|
|
7
5
|
siteDescription?: string;
|
|
@@ -15,8 +13,6 @@ export interface RenderDocumentOptions {
|
|
|
15
13
|
date?: string;
|
|
16
14
|
showSummary?: boolean;
|
|
17
15
|
showDate?: boolean;
|
|
18
|
-
theme: BuiltInThemeName;
|
|
19
|
-
template: TemplateName;
|
|
20
16
|
topNav?: SiteNavItem[];
|
|
21
17
|
footerNav?: SiteNavItem[];
|
|
22
18
|
footerText?: string;
|
|
@@ -25,14 +21,14 @@ export interface RenderDocumentOptions {
|
|
|
25
21
|
stylesheetContent?: string;
|
|
26
22
|
canonicalPath?: string;
|
|
27
23
|
alternateMarkdownPath?: string;
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
24
|
+
listingEntries?: ManagedIndexEntry[];
|
|
25
|
+
listingRequestPath?: string;
|
|
26
|
+
listingInitialPostCount?: number;
|
|
27
|
+
listingLoadMoreStep?: number;
|
|
32
28
|
searchEnabled?: boolean;
|
|
33
29
|
headerHtml?: string;
|
|
34
30
|
footerHtml?: string;
|
|
35
31
|
}
|
|
36
32
|
export declare function renderDocument(options: RenderDocumentOptions): string;
|
|
37
33
|
export declare function escapeHtml(value: string): string;
|
|
38
|
-
export declare function
|
|
34
|
+
export declare function renderListingArticleItems(entries: readonly ManagedIndexEntry[]): string;
|
package/dist/html/template.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { getDefaultThemeStyles } from './theme.js';
|
|
2
2
|
export function renderDocument(options) {
|
|
3
3
|
const title = escapeHtml(options.title);
|
|
4
4
|
const siteTitle = escapeHtml(options.siteTitle);
|
|
@@ -25,7 +25,7 @@ export function renderDocument(options) {
|
|
|
25
25
|
const alternateMarkdownMeta = options.alternateMarkdownPath
|
|
26
26
|
? `<link rel="alternate" type="text/markdown" href="${escapeHtml(options.alternateMarkdownPath)}">`
|
|
27
27
|
: '';
|
|
28
|
-
const stylesheetBlock = `<style>${
|
|
28
|
+
const stylesheetBlock = `<style>${getDefaultThemeStyles()}${options.stylesheetContent ? `\n${options.stylesheetContent}` : ''}</style>`;
|
|
29
29
|
const navBlock = options.topNav && options.topNav.length > 0
|
|
30
30
|
? `<nav class="site-nav"><ul>${options.topNav
|
|
31
31
|
.map((item) => `<li><a href="${escapeHtml(item.href)}">${escapeHtml(item.label)}</a></li>`)
|
|
@@ -84,11 +84,11 @@ export function renderDocument(options) {
|
|
|
84
84
|
const footerBlock = footerNavBlock || footerTextBlock || footerMetaBlock
|
|
85
85
|
? `<footer class="site-footer"><div class="site-footer__inner">${footerNavBlock}${footerTextBlock}${footerMetaBlock}</div></footer>`
|
|
86
86
|
: '';
|
|
87
|
-
const articleBody = options.
|
|
88
|
-
?
|
|
89
|
-
requestPath: options.
|
|
90
|
-
initialPostCount: options.
|
|
91
|
-
loadMoreStep: options.
|
|
87
|
+
const articleBody = options.listingEntries && options.listingEntries.length > 0
|
|
88
|
+
? renderListingArticle(options.body, options.listingEntries, {
|
|
89
|
+
requestPath: options.listingRequestPath ?? '/',
|
|
90
|
+
initialPostCount: options.listingInitialPostCount ?? 10,
|
|
91
|
+
loadMoreStep: options.listingLoadMoreStep ?? 10,
|
|
92
92
|
})
|
|
93
93
|
: options.body;
|
|
94
94
|
const searchScript = options.searchEnabled ? renderSearchScript() : '';
|
|
@@ -109,7 +109,7 @@ export function renderDocument(options) {
|
|
|
109
109
|
alternateMarkdownMeta,
|
|
110
110
|
stylesheetBlock,
|
|
111
111
|
'</head>',
|
|
112
|
-
|
|
112
|
+
'<body>',
|
|
113
113
|
headerBlock,
|
|
114
114
|
'<main>',
|
|
115
115
|
`<article>${articleBody}</article>`,
|
|
@@ -159,7 +159,7 @@ function renderSocialIcon(icon) {
|
|
|
159
159
|
function iconSvg(pathData) {
|
|
160
160
|
return `<svg viewBox="0 0 24 24" aria-hidden="true"><path d="${pathData}"></path></svg>`;
|
|
161
161
|
}
|
|
162
|
-
function
|
|
162
|
+
function renderListingArticle(body, entries, options) {
|
|
163
163
|
if (entries.length === 0) {
|
|
164
164
|
return body;
|
|
165
165
|
}
|
|
@@ -170,10 +170,10 @@ function renderCatalogArticle(body, entries, options) {
|
|
|
170
170
|
const shouldLoadMore = articles.length > visibleArticles.length;
|
|
171
171
|
return [
|
|
172
172
|
`<div class="catalog-page__body">${body}</div>`,
|
|
173
|
-
'<section class="catalog-page" aria-label="
|
|
174
|
-
directories.length > 0 ?
|
|
173
|
+
'<section class="catalog-page" aria-label="Content listing">',
|
|
174
|
+
directories.length > 0 ? renderListingDirectories(directories) : '',
|
|
175
175
|
articles.length > 0
|
|
176
|
-
?
|
|
176
|
+
? renderListingArticles(visibleArticles, {
|
|
177
177
|
requestPath: options.requestPath,
|
|
178
178
|
nextOffset: visibleArticles.length,
|
|
179
179
|
loadMoreStep: options.loadMoreStep,
|
|
@@ -181,10 +181,10 @@ function renderCatalogArticle(body, entries, options) {
|
|
|
181
181
|
})
|
|
182
182
|
: '',
|
|
183
183
|
'</section>',
|
|
184
|
-
shouldLoadMore ?
|
|
184
|
+
shouldLoadMore ? renderListingLoadMoreScript() : '',
|
|
185
185
|
].join('');
|
|
186
186
|
}
|
|
187
|
-
function
|
|
187
|
+
function renderListingDirectories(entries) {
|
|
188
188
|
return [
|
|
189
189
|
'<div class="catalog-list catalog-list--directories">',
|
|
190
190
|
...entries.map((entry) => `<a class="catalog-item catalog-item--directory" href="${escapeHtml(entry.href)}"><strong class="catalog-item__title">${escapeHtml(entry.title)}</strong>${entry.detail
|
|
@@ -193,28 +193,28 @@ function renderCatalogDirectories(entries) {
|
|
|
193
193
|
'</div>',
|
|
194
194
|
].join('');
|
|
195
195
|
}
|
|
196
|
-
export function
|
|
196
|
+
export function renderListingArticleItems(entries) {
|
|
197
197
|
return entries
|
|
198
198
|
.map((entry) => `<a class="catalog-item" href="${escapeHtml(entry.href)}"><strong class="catalog-item__title">${escapeHtml(entry.title)}</strong>${entry.detail
|
|
199
199
|
? `<span class="catalog-item__detail">${escapeHtml(entry.detail)}</span>`
|
|
200
200
|
: ''}</a>`)
|
|
201
201
|
.join('');
|
|
202
202
|
}
|
|
203
|
-
function
|
|
203
|
+
function renderListingArticles(entries, options) {
|
|
204
204
|
return [
|
|
205
|
-
'<div class="catalog-list" data-
|
|
206
|
-
|
|
205
|
+
'<div class="catalog-list" data-listing-articles>',
|
|
206
|
+
renderListingArticleItems(entries),
|
|
207
207
|
'</div>',
|
|
208
208
|
options.hasMore
|
|
209
|
-
? `<div class="catalog-load-more"><button type="button" class="catalog-load-more__button" data-
|
|
209
|
+
? `<div class="catalog-load-more"><button type="button" class="catalog-load-more__button" data-listing-load-more data-request-path="${escapeHtml(options.requestPath)}" data-next-offset="${escapeHtml(String(options.nextOffset))}" data-load-more-step="${escapeHtml(String(options.loadMoreStep))}">Load more</button></div>`
|
|
210
210
|
: '',
|
|
211
211
|
].join('');
|
|
212
212
|
}
|
|
213
|
-
function
|
|
213
|
+
function renderListingLoadMoreScript() {
|
|
214
214
|
return `<script>
|
|
215
215
|
(() => {
|
|
216
|
-
const button = document.querySelector('[data-
|
|
217
|
-
const list = document.querySelector('[data-
|
|
216
|
+
const button = document.querySelector('[data-listing-load-more]');
|
|
217
|
+
const list = document.querySelector('[data-listing-articles]');
|
|
218
218
|
if (!(button instanceof HTMLButtonElement) || !(list instanceof HTMLElement)) {
|
|
219
219
|
return;
|
|
220
220
|
}
|
|
@@ -233,9 +233,9 @@ function renderCatalogLoadMoreScript() {
|
|
|
233
233
|
|
|
234
234
|
try {
|
|
235
235
|
const url = new URL(requestPath, window.location.origin);
|
|
236
|
-
url.searchParams.set('
|
|
237
|
-
url.searchParams.set('
|
|
238
|
-
url.searchParams.set('
|
|
236
|
+
url.searchParams.set('listing-format', 'posts');
|
|
237
|
+
url.searchParams.set('listing-offset', nextOffset);
|
|
238
|
+
url.searchParams.set('listing-limit', loadMoreStep);
|
|
239
239
|
|
|
240
240
|
const response = await fetch(url.toString(), {
|
|
241
241
|
headers: { Accept: 'application/json' },
|
package/dist/html/theme.d.ts
CHANGED
|
@@ -1,2 +1 @@
|
|
|
1
|
-
export
|
|
2
|
-
export declare function getBuiltInThemeStyles(theme: BuiltInThemeName): string;
|
|
1
|
+
export declare function getDefaultThemeStyles(): string;
|