Merge branch 'worktree/pr343-retarget-latest-master' into worktree/pr344-retarget-stack

scripts/project-doc-site.spec.ts

@@ -172,13 +172,13 @@ describe('rewriteMarkdown', () => {
 })
 
 describe('docsPages locale routes', () => {
-  it('publishes every route in both locales and selects paired user sources', () => {
+  it('publishes every route in both locales and selects paired sources', () => {
     const byRoute = new Map(docsPages.map(page => [page.route, page]))
     for (const page of docsPages.filter(page => page.locale === 'root')) {
       const counterpart = byRoute.get(`en/${page.route}`)
       expect(counterpart, page.route).toBeDefined()
       expect(counterpart?.locale).toBe('en')
-      if (page.source.startsWith('docs/user/')) {
+      if (page.source.startsWith('docs/user/') || page.route === 'reference/cordis-primer.md') {
         expect(page.source).toMatch(/\.zh\.md$/)
         expect(page.contentLocale).toBe('zh-CN')
         expect(counterpart?.source).toBe(page.source.replace(/\.zh\.md$/, '.md'))

website/docs.ts

@@ -226,14 +226,24 @@ const cordisTutorial = mirroredPages(([
   ...(file === 'index.md' ? { sourceAliases: ['docs/cordis-tutorial'] } : {}),
 })))
 
+const cordisPrimerReference = pairedPages([
+  {
+    source: 'docs/cordis-primer.md',
+    route: 'reference/cordis-primer.md',
+    label: { root: 'Cordis 入门', en: 'Cordis primer' },
+    sidebar: { root: 'zh-reference', en: 'en-reference' },
+    section: { root: '概念', en: 'Concepts' },
+    order: 1,
+  },
+])
+
 const reference = mirroredPages([
   ...([
-    ['docs/architecture.md', 'reference/index.md', '架构', 'Architecture'],
-    ['docs/cordis-primer.md', 'reference/cordis-primer.md', 'Cordis 入门', 'Cordis primer'],
-    ['docs/capability-seams.md', 'reference/capability-seams.md', '能力服务', 'Capability services'],
-    ['docs/agent-lifecycle.md', 'reference/agent-lifecycle.md', 'Agent 生命周期', 'Agent lifecycle'],
-    ['docs/tool-execution-pipeline.md', 'reference/tool-execution-pipeline.md', 'Tool 执行', 'Tool execution'],
-  ] as const).map(([source, route, rootLabel, enLabel], order): MirroredPage => ({
+    ['docs/architecture.md', 'reference/index.md', '架构', 'Architecture', 0],
+    ['docs/capability-seams.md', 'reference/capability-seams.md', '能力服务', 'Capability services', 2],
+    ['docs/agent-lifecycle.md', 'reference/agent-lifecycle.md', 'Agent 生命周期', 'Agent lifecycle', 3],
+    ['docs/tool-execution-pipeline.md', 'reference/tool-execution-pipeline.md', 'Tool 执行', 'Tool execution', 4],
+  ] as const).map(([source, route, rootLabel, enLabel, order]): MirroredPage => ({
     source,
     route,
     contentLocale: 'en-US',
@@ -325,5 +335,6 @@ export const docsPages: DocsPage[] = [
   ...homeAndGuide,
   ...develop,
   ...cordisTutorial,
+  ...cordisPrimerReference,
   ...reference,
 ]