spark-cli/docmd.config.js at main · variableway/spark-cli · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
// docmd.config.js
export default defineConfig({
  // --- Core Metadata ---
  title: 'Spark CLI',
  url: 'https://variableway.github.io/spark-cli',

  // --- Source & Output ---
  src: 'docs',
  out: 'site',

  // --- Layout & UI Architecture ---
  layout: {
    spa: true,
    header: {
      enabled: true,
    },
    sidebar: {
      collapsible: true,
      defaultCollapsed: false,
    },
    optionsMenu: {
      position: 'sidebar-top',
      components: {
        search: true,
        themeSwitch: true,
        sponsor: null,
      },
    },
    footer: {
      style: 'minimal',
      content: '© ' + new Date().getFullYear() + ' Spark CLI',
      branding: true,
    },
  },

  // --- Theme Settings ---
  theme: {
    name: 'sky',
    appearance: 'system',
    codeHighlight: true,
    customCss: [],
  },

  // --- General Features ---
  minify: true,
  autoTitleFromH1: true,
  copyCode: true,
  pageNavigation: true,

  // --- Internationalization ---
  // Default locale (zh) renders at site root; English mirror lives under /en/.
  // Navigation labels are sourced from per-locale navigation.json files
  // (docs/zh/navigation.json and docs/en/navigation.json).
  i18n: {
    default: 'zh',
    position: 'options-menu',
    locales: [
      {
        id: 'zh',
        label: '简体中文',
        dir: 'ltr',
        translations: { editLinkText: '编辑此页' },
      },
      {
        id: 'en',
        label: 'English',
        dir: 'ltr',
        translations: { editLinkText: 'Edit this page' },
      },
    ],
  },

  // --- Plugins ---
  plugins: {
    seo: {
      defaultDescription: 'Spark CLI — daily dev automation and AI skill integration',
      openGraph: { defaultImage: '' },
      twitter: { cardType: 'summary_large_image' },
    },
    sitemap: { defaultChangefreq: 'weekly' },
    search: {},
    mermaid: {},
    llms: { fullContext: true },
  },

  // --- Edit Link ---
  // baseUrl always points at the default locale directory on disk so the
  // "Edit this page" link resolves to a real file in docs/zh/.
  editLink: {
    enabled: true,
    baseUrl: 'https://github.com/variableway/spark-cli/edit/main/docs/zh',
  },
});