feat: add Astro reference site and organize book contents

2026-10-09 23:40:37 +09:00
parent 6086f3c5ef
commit 01c9498e6d
39 changed files with 7772 additions and 0 deletions
@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import test from 'node:test';
+import documentLinks, { contentsRoot, documentHref, normalizeBase } from '../plugins/document-links.mjs';
+
+const source = path.join(contentsRoot, '3-protocol.md');
+test('canonical, draft and cross-directory links keep their fragments', () => {
+  assert.equal(documentHref('4.2-text-view.md#参照表記', source), '/book/4.2-text-view/#参照表記');
+  assert.equal(documentHref('draft/unresolved-issues.md', source), '/book/draft/unresolved-issues/');
+  assert.equal(documentHref('../3-protocol.md#value', path.join(contentsRoot, 'draft/rust-api-model.md')), '/book/3-protocol/#value');
+});
+test('base prefix and query are preserved', () => {
+  assert.equal(normalizeBase('/reference'), '/reference/');
+  assert.equal(documentHref('4-client.md?from=book#known-space', source, '/reference'), '/reference/book/4-client/?from=book#known-space');
+});
+test('external URLs, local anchors and non-Markdown assets are untouched', () => {
+  for (const url of ['https://example.test/file.md', '//example.test/file.md', '#名前と文字列', 'mailto:user@example.test', './image.svg']) {
+    assert.equal(documentHref(url, source), url);
+  }
+});
+test('invalid base and links escaping contents are rejected', () => {
+  for (const base of ['relative', '//example.test', '/foo?x', '/../x']) assert.throws(() => normalizeBase(base));
+  assert.throws(() => documentHref('../secret.md', source));
+});
+test('remark handles reference links but leaves code examples unchanged', () => {
+  const tree = { type: 'root', children: [
+    { type: 'link', url: '4-client.md', children: [] },
+    { type: 'definition', url: '4-client.md#known-space' },
+    { type: 'code', value: '[example](4-client.md)' },
+  ] };
+  documentLinks() (tree, { path: source });
+  assert.equal(tree.children[0].url, '/book/4-client/');
+  assert.equal(tree.children[1].url, '/book/4-client/#known-space');
+  assert.equal(tree.children[2].value, '[example](4-client.md)');
+});