docs/astro.config.mjs at master · hoochanlon/docs · 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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import expressiveCode from 'astro-expressive-code';
import rehypeExternalLinks from "rehype-external-links";
import markdoc from '@astrojs/markdoc';
import starlightImageZoom from 'starlight-image-zoom';
import starlightThemeGalaxy from 'starlight-theme-galaxy';
import starlightThemeRapide from 'starlight-theme-rapide';
import starlightThemeFlexoki from 'starlight-theme-flexoki';
import mermaid from 'astro-mermaid';

// https://astro.build/config
export default defineConfig({
   site: 'https://hoochanlon.github.io',
   base: 'docs',
    markdown: {
      rehypePlugins: [
        [
          rehypeExternalLinks,
          {
            target: "\_blank",
            rel: ["noopener", "noreferrer", "external"],
          },
      ],
    ],
  },
  vite: {
    resolve: {
      alias: {
        '@components': new URL('./src/components', import.meta.url).pathname,
        '@': new URL('./src', import.meta.url).pathname,
      },
    },
    ssr: {
      noExternal: ['@astrojs/starlight'],
    },
  },
    integrations: [
      mermaid({
        theme: 'forest',
        autoTheme: true
      }),
      expressiveCode(), starlight({
        plugins: [
          starlightImageZoom(),
          // starlightThemeFlexoki(),
          starlightThemeRapide(),
          // starlightThemeGalaxy(),
        ],
        title: 'My Docs',
        customCss: [
          // 你的自定义 CSS 文件的相对路径
          './src/styles/custom.css',
        ],
        locales: {
          root: {
            label: '简体中文',
            lang: 'zh-CN',
          },
      },
        social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/hoochanlon' }],
        editLink: {
            baseUrl: 'https://github.com/hoochanlon/docs/edit/master',
        },
        sidebar: [
            {
                label: '欢迎',
                items: [
                    { label: '内容主页', slug: 'welcome' },
                ],
            },
            {
                label: 'Astro-Starlight',
                items: [
                    { label: 'Astro-Starlight 简要配置', slug: 'astro-starlight/astro-starlight-example' },
                    { label: 'Astro-Starlight 扩展', slug: 'astro-starlight/starlight-writing-extensions'},
                    { label: 'Astro-Starlight 写作脚本', slug: 'astro-starlight/astro-starlight-scripts' },
                    { label: 'Astro-Starlight 加密内容示例', slug: 'astro-starlight/astro-starlight-encrypted' },
                ],
            },
            {
                label: '文本及用语规范',
                items: [
                    { label: '电子书层级内容用语约定', slug: 'writing-standards/ebook-content-guidelines' },
                    { label: '盘白清晰表达方式约定', slug: 'writing-standards/content-emphasis-guidelines' },

                ],
            },
            {
                label: '现代软件开发实践杂谈',
                items: [
                  { label: '从编写脚本到打造产品的历程', slug: 'dev-talk/script-to-app' },
                  { label: '技术社区与项目推广的冷思考', slug: 'dev-talk/tech-community-promotion-and-the-github-stars-bubble' },
                  { label: '网页书签信息过载问题', slug: 'dev-talk/bookmark-talk' },
                  { label: '谈谈软件开发成本与付费收益', slug: 'dev-talk/pay-talk' },
                  { label: '为了什么写文档？', slug: 'dev-talk/doc-talk' },
                ],
            },
            {
                label: '常用的命令备忘',
                items: [
                    { label: 'git 常用命令', slug: 'cmd/git-cmd' },
                    { label: '项目常用命令', slug: 'cmd/project-cmd' },
                ],
            },
            {
                label: '非蠢既坏的 MacOS',
                items: [
                    { label: '面向开放 MacOS 的一小步', slug: 'awful-mac/mac-cmd' },
                ],
            },
            {
                label: 'Mermaid 原理图',
                items: [
                    { label: '项目应用技术原理图 （一）', slug: 'mermaid/mermaid-myproject-1' },
                ],
            },

        ],
        }), markdoc()],
});