@tnotesjs/core 0.1.22 → 0.1.24
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 +87 -87
- package/package.json +1 -1
- package/types/config.ts +60 -60
- package/types/index.ts +11 -11
- package/types/note.ts +33 -33
- package/vitepress/assets/icons/icon__check.svg +3 -3
- package/vitepress/assets/icons/icon__clipboard.svg +7 -7
- package/vitepress/assets/icons/icon__close.svg +1 -1
- package/vitepress/assets/icons/icon__collapse.svg +1 -1
- package/vitepress/assets/icons/icon__confirm.svg +1 -1
- package/vitepress/assets/icons/icon__copy.svg +4 -4
- package/vitepress/assets/icons/icon__focus.svg +1 -1
- package/vitepress/assets/icons/icon__fold.svg +3 -3
- package/vitepress/assets/icons/icon__folder.svg +1 -1
- package/vitepress/assets/icons/icon__fullscreen.svg +1 -1
- package/vitepress/assets/icons/icon__fullscreen_exit.svg +1 -1
- package/vitepress/assets/icons/icon__github.svg +3 -3
- package/vitepress/assets/icons/icon__mindmap.svg +1 -1
- package/vitepress/assets/icons/icon__next.svg +1 -1
- package/vitepress/assets/icons/icon__number_gray.svg +1 -1
- package/vitepress/assets/icons/icon__number_purple.svg +1 -1
- package/vitepress/assets/icons/icon__prev.svg +1 -1
- package/vitepress/assets/icons/icon__restore.svg +1 -1
- package/vitepress/assets/icons/icon__rotate.svg +4 -4
- package/vitepress/assets/icons/icon__search.svg +1 -1
- package/vitepress/assets/icons/icon__sidebar_collapsed.svg +1 -1
- package/vitepress/assets/icons/icon__sidebar_opened.svg +1 -1
- package/vitepress/assets/icons/icon__totop.svg +5 -5
- package/vitepress/assets/icons/icon__vscode.svg +5 -5
- package/vitepress/assets/icons/icon__zoom_fit.svg +1 -1
- package/vitepress/assets/icons/icon__zoom_in.svg +1 -1
- package/vitepress/assets/icons/icon__zoom_out.svg +1 -1
- package/vitepress/assets/icons/icon__zoom_reset.svg +1 -1
- package/vitepress/assets/icons/index.ts +39 -39
- package/vitepress/components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue +20 -20
- package/vitepress/components/CodeBlockFullscreen/CodeBlockFullscreen.vue +369 -369
- package/vitepress/components/CodeBlockFullscreen/index.ts +209 -209
- package/vitepress/components/CodeBlockFullscreen/styles.css +126 -126
- package/vitepress/components/Discussions/Discussions.vue +242 -242
- package/vitepress/components/EnWordList/EnWordList.vue +664 -664
- package/vitepress/components/EnWordList/RightClickMenu.vue +87 -87
- package/vitepress/components/Footprints/Footprints.vue +472 -472
- package/vitepress/components/Layout/AboutModal.vue +329 -329
- package/vitepress/components/Layout/AboutPanel.vue +485 -485
- package/vitepress/components/Layout/ContentCollapse.vue +591 -591
- package/vitepress/components/Layout/CustomSidebar.vue +817 -817
- package/vitepress/components/Layout/DocBeforeControls.vue +145 -145
- package/vitepress/components/Layout/DocFooter.vue +233 -233
- package/vitepress/components/Layout/ImagePreview.vue +485 -485
- package/vitepress/components/Layout/Layout.vue +744 -744
- package/vitepress/components/Layout/NoteStatus.vue +140 -140
- package/vitepress/components/Layout/SidebarItems.vue +1083 -1083
- package/vitepress/components/Layout/SidebarNavBefore.vue +170 -170
- package/vitepress/components/Layout/SidebarResizeHandle.vue +368 -311
- package/vitepress/components/Layout/Swiper.vue +167 -167
- package/vitepress/components/Layout/ToggleFullContent.vue +45 -45
- package/vitepress/components/Layout/ToggleSidebar.vue +35 -35
- package/vitepress/components/Layout/composables/useCollapseControl.ts +88 -88
- package/vitepress/components/Layout/composables/useNoteConfig.ts +119 -119
- package/vitepress/components/Layout/composables/useNoteSave.ts +178 -178
- package/vitepress/components/Layout/composables/useNoteValidation.ts +85 -85
- package/vitepress/components/Layout/composables/useRedirect.ts +113 -113
- package/vitepress/components/Layout/composables/useSidebarLayout.ts +122 -122
- package/vitepress/components/Layout/composables/useVSCodeIntegration.ts +85 -85
- package/vitepress/components/Layout/homeReadme.data.ts +124 -124
- package/vitepress/components/MarkMap/MarkMap.vue +562 -562
- package/vitepress/components/Mermaid/Mermaid.vue +644 -644
- package/vitepress/components/NotesTable/NotesTable.vue +175 -175
- package/vitepress/components/NotesTable/README.md +67 -67
- package/vitepress/components/Settings/Settings.vue +711 -711
- package/vitepress/components/SidebarCard/MindMapView.vue +484 -484
- package/vitepress/components/SidebarCard/NotesTrendChart.vue +108 -108
- package/vitepress/components/SidebarCard/SidebarCard.vue +945 -945
- package/vitepress/components/Tooltip/Tooltip.vue +70 -70
- package/vitepress/components/constants.ts +109 -109
- package/vitepress/components/notesConfig.data.ts +73 -73
- package/vitepress/components/sidebar.data.ts +59 -59
- package/vitepress/components/tnotes-config.data.ts +21 -21
- package/vitepress/components/utils.ts +26 -26
- package/vitepress/config/index.ts +169 -169
- package/vitepress/configs/constants.ts +26 -26
- package/vitepress/configs/head.config.ts +25 -25
- package/vitepress/configs/index.ts +9 -9
- package/vitepress/configs/markdown-it.d.ts +23 -23
- package/vitepress/configs/markdown.config.ts +368 -368
- package/vitepress/configs/theme.config.ts +108 -108
- package/vitepress/plugins/buildProgressPlugin.ts +434 -434
- package/vitepress/plugins/getNoteByConfigIdPlugin.ts +107 -107
- package/vitepress/plugins/renameNotePlugin.ts +68 -68
- package/vitepress/plugins/sidebarStructurePlugin.ts +260 -260
- package/vitepress/plugins/updateConfigPlugin.ts +63 -63
- package/vitepress/theme/index.ts +137 -137
- package/vitepress/theme/styles/base.scss +66 -64
- package/vitepress/theme/styles/components/404.scss +31 -31
- package/vitepress/theme/styles/components/collapse.scss +172 -172
- package/vitepress/theme/styles/components/markmap.scss +101 -101
- package/vitepress/theme/styles/components/swiper.scss +255 -255
- package/vitepress/theme/styles/index.scss +25 -25
- package/vitepress/theme/styles/layout.scss +79 -78
- package/vitepress/theme/styles/utilities.scss +39 -39
- package/vitepress/theme/styles/vitepress-override.scss +25 -25
|
@@ -1,175 +1,175 @@
|
|
|
1
|
-
<template>
|
|
2
|
-
<div v-if="errorMessage" class="error">
|
|
3
|
-
{{ errorMessage }}
|
|
4
|
-
</div>
|
|
5
|
-
|
|
6
|
-
<div v-else-if="notFoundIds.length > 0" class="warning">
|
|
7
|
-
以下笔记 ID 未找到配置: {{ notFoundIds.join(', ') }}
|
|
8
|
-
</div>
|
|
9
|
-
|
|
10
|
-
<table v-if="tableData.length > 0" class="notesTable">
|
|
11
|
-
<thead>
|
|
12
|
-
<tr>
|
|
13
|
-
<th>笔记</th>
|
|
14
|
-
<th>简介</th>
|
|
15
|
-
</tr>
|
|
16
|
-
</thead>
|
|
17
|
-
<tbody>
|
|
18
|
-
<tr v-for="note in tableData" :key="note.id">
|
|
19
|
-
<td>
|
|
20
|
-
<a :href="note.url" class="noteLink">
|
|
21
|
-
<span class="noteId">{{ note.id }}.</span>
|
|
22
|
-
<span>{{ note.title }}</span>
|
|
23
|
-
</a>
|
|
24
|
-
</td>
|
|
25
|
-
<td>
|
|
26
|
-
<span class="description" :class="{ empty: !note.description }">
|
|
27
|
-
{{ note.description || '暂无简介' }}
|
|
28
|
-
</span>
|
|
29
|
-
</td>
|
|
30
|
-
</tr>
|
|
31
|
-
</tbody>
|
|
32
|
-
</table>
|
|
33
|
-
</template>
|
|
34
|
-
|
|
35
|
-
<script setup lang="ts">
|
|
36
|
-
import { useData } from 'vitepress'
|
|
37
|
-
import { computed } from 'vue'
|
|
38
|
-
|
|
39
|
-
// @ts-expect-error - VitePress data loader exports data at runtime
|
|
40
|
-
import { data as allNotesConfig } from '../notesConfig.data.ts'
|
|
41
|
-
|
|
42
|
-
interface Props {
|
|
43
|
-
ids: string[]
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
const props = defineProps<Props>()
|
|
47
|
-
const vpData = useData()
|
|
48
|
-
|
|
49
|
-
// 错误消息
|
|
50
|
-
const errorMessage = computed(() => {
|
|
51
|
-
if (!props.ids || !Array.isArray(props.ids)) {
|
|
52
|
-
return '错误: ids 属性必须是一个数组'
|
|
53
|
-
}
|
|
54
|
-
if (props.ids.length === 0) {
|
|
55
|
-
return '错误: ids 数组不能为空'
|
|
56
|
-
}
|
|
57
|
-
return null
|
|
58
|
-
})
|
|
59
|
-
|
|
60
|
-
// 未找到的笔记 ID
|
|
61
|
-
const notFoundIds = computed(() => {
|
|
62
|
-
if (errorMessage.value) return []
|
|
63
|
-
|
|
64
|
-
return props.ids.filter((id) => !allNotesConfig[id])
|
|
65
|
-
})
|
|
66
|
-
|
|
67
|
-
// 表格数据
|
|
68
|
-
const tableData = computed(() => {
|
|
69
|
-
if (errorMessage.value) return []
|
|
70
|
-
|
|
71
|
-
return props.ids
|
|
72
|
-
.filter((id) => allNotesConfig[id]) // 只保留存在的笔记
|
|
73
|
-
.map((id) => {
|
|
74
|
-
const config = allNotesConfig[id]
|
|
75
|
-
const base = vpData.site.value.base || '/'
|
|
76
|
-
|
|
77
|
-
// 从 redirect 路径中提取笔记标题
|
|
78
|
-
// redirect 格式: notes/0001. 标题/README
|
|
79
|
-
let title = id
|
|
80
|
-
if (config.redirect) {
|
|
81
|
-
const match = config.redirect.match(/notes\/\d{4}\.\s*([^/]+)\/README/)
|
|
82
|
-
if (match) {
|
|
83
|
-
title = match[1]
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
return {
|
|
88
|
-
id,
|
|
89
|
-
title,
|
|
90
|
-
description: config.description || '',
|
|
91
|
-
url: config.redirect ? `${base}${config.redirect}` : '#',
|
|
92
|
-
}
|
|
93
|
-
})
|
|
94
|
-
})
|
|
95
|
-
</script>
|
|
96
|
-
|
|
97
|
-
<style scoped lang="scss">
|
|
98
|
-
.notesTable {
|
|
99
|
-
width: 100%;
|
|
100
|
-
border-collapse: collapse;
|
|
101
|
-
margin: 1.5rem 0;
|
|
102
|
-
font-size: 0.95rem;
|
|
103
|
-
|
|
104
|
-
th,
|
|
105
|
-
td {
|
|
106
|
-
padding: 0.75rem 1rem;
|
|
107
|
-
text-align: left;
|
|
108
|
-
border: 1px solid var(--vp-c-divider);
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
th {
|
|
112
|
-
background-color: var(--vp-c-bg-soft);
|
|
113
|
-
font-weight: 600;
|
|
114
|
-
color: var(--vp-c-text-1);
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
tbody tr {
|
|
118
|
-
transition: background-color 0.2s;
|
|
119
|
-
|
|
120
|
-
&:hover {
|
|
121
|
-
background-color: var(--vp-c-bg-soft);
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
td {
|
|
126
|
-
color: var(--vp-c-text-2);
|
|
127
|
-
}
|
|
128
|
-
|
|
129
|
-
.noteLink {
|
|
130
|
-
color: var(--vp-c-brand-1);
|
|
131
|
-
text-decoration: none;
|
|
132
|
-
font-weight: 500;
|
|
133
|
-
transition: color 0.2s;
|
|
134
|
-
|
|
135
|
-
&:hover {
|
|
136
|
-
color: var(--vp-c-brand-2);
|
|
137
|
-
text-decoration: underline;
|
|
138
|
-
}
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
.noteId {
|
|
142
|
-
font-family: var(--vp-font-family-mono);
|
|
143
|
-
font-size: 0.9em;
|
|
144
|
-
color: var(--vp-c-text-3);
|
|
145
|
-
margin-right: 0.5rem;
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
.description {
|
|
149
|
-
line-height: 1.6;
|
|
150
|
-
|
|
151
|
-
&.empty {
|
|
152
|
-
color: var(--vp-c-text-3);
|
|
153
|
-
font-style: italic;
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
.error {
|
|
159
|
-
padding: 1rem;
|
|
160
|
-
margin: 1rem 0;
|
|
161
|
-
border-left: 4px solid var(--vp-c-danger-1);
|
|
162
|
-
background-color: var(--vp-c-danger-soft);
|
|
163
|
-
color: var(--vp-c-danger-1);
|
|
164
|
-
border-radius: 4px;
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
.warning {
|
|
168
|
-
padding: 1rem;
|
|
169
|
-
margin: 1rem 0;
|
|
170
|
-
border-left: 4px solid var(--vp-c-warning-1);
|
|
171
|
-
background-color: var(--vp-c-warning-soft);
|
|
172
|
-
color: var(--vp-c-warning-1);
|
|
173
|
-
border-radius: 4px;
|
|
174
|
-
}
|
|
175
|
-
</style>
|
|
1
|
+
<template>
|
|
2
|
+
<div v-if="errorMessage" class="error">
|
|
3
|
+
{{ errorMessage }}
|
|
4
|
+
</div>
|
|
5
|
+
|
|
6
|
+
<div v-else-if="notFoundIds.length > 0" class="warning">
|
|
7
|
+
以下笔记 ID 未找到配置: {{ notFoundIds.join(', ') }}
|
|
8
|
+
</div>
|
|
9
|
+
|
|
10
|
+
<table v-if="tableData.length > 0" class="notesTable">
|
|
11
|
+
<thead>
|
|
12
|
+
<tr>
|
|
13
|
+
<th>笔记</th>
|
|
14
|
+
<th>简介</th>
|
|
15
|
+
</tr>
|
|
16
|
+
</thead>
|
|
17
|
+
<tbody>
|
|
18
|
+
<tr v-for="note in tableData" :key="note.id">
|
|
19
|
+
<td>
|
|
20
|
+
<a :href="note.url" class="noteLink">
|
|
21
|
+
<span class="noteId">{{ note.id }}.</span>
|
|
22
|
+
<span>{{ note.title }}</span>
|
|
23
|
+
</a>
|
|
24
|
+
</td>
|
|
25
|
+
<td>
|
|
26
|
+
<span class="description" :class="{ empty: !note.description }">
|
|
27
|
+
{{ note.description || '暂无简介' }}
|
|
28
|
+
</span>
|
|
29
|
+
</td>
|
|
30
|
+
</tr>
|
|
31
|
+
</tbody>
|
|
32
|
+
</table>
|
|
33
|
+
</template>
|
|
34
|
+
|
|
35
|
+
<script setup lang="ts">
|
|
36
|
+
import { useData } from 'vitepress'
|
|
37
|
+
import { computed } from 'vue'
|
|
38
|
+
|
|
39
|
+
// @ts-expect-error - VitePress data loader exports data at runtime
|
|
40
|
+
import { data as allNotesConfig } from '../notesConfig.data.ts'
|
|
41
|
+
|
|
42
|
+
interface Props {
|
|
43
|
+
ids: string[]
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
const props = defineProps<Props>()
|
|
47
|
+
const vpData = useData()
|
|
48
|
+
|
|
49
|
+
// 错误消息
|
|
50
|
+
const errorMessage = computed(() => {
|
|
51
|
+
if (!props.ids || !Array.isArray(props.ids)) {
|
|
52
|
+
return '错误: ids 属性必须是一个数组'
|
|
53
|
+
}
|
|
54
|
+
if (props.ids.length === 0) {
|
|
55
|
+
return '错误: ids 数组不能为空'
|
|
56
|
+
}
|
|
57
|
+
return null
|
|
58
|
+
})
|
|
59
|
+
|
|
60
|
+
// 未找到的笔记 ID
|
|
61
|
+
const notFoundIds = computed(() => {
|
|
62
|
+
if (errorMessage.value) return []
|
|
63
|
+
|
|
64
|
+
return props.ids.filter((id) => !allNotesConfig[id])
|
|
65
|
+
})
|
|
66
|
+
|
|
67
|
+
// 表格数据
|
|
68
|
+
const tableData = computed(() => {
|
|
69
|
+
if (errorMessage.value) return []
|
|
70
|
+
|
|
71
|
+
return props.ids
|
|
72
|
+
.filter((id) => allNotesConfig[id]) // 只保留存在的笔记
|
|
73
|
+
.map((id) => {
|
|
74
|
+
const config = allNotesConfig[id]
|
|
75
|
+
const base = vpData.site.value.base || '/'
|
|
76
|
+
|
|
77
|
+
// 从 redirect 路径中提取笔记标题
|
|
78
|
+
// redirect 格式: notes/0001. 标题/README
|
|
79
|
+
let title = id
|
|
80
|
+
if (config.redirect) {
|
|
81
|
+
const match = config.redirect.match(/notes\/\d{4}\.\s*([^/]+)\/README/)
|
|
82
|
+
if (match) {
|
|
83
|
+
title = match[1]
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
return {
|
|
88
|
+
id,
|
|
89
|
+
title,
|
|
90
|
+
description: config.description || '',
|
|
91
|
+
url: config.redirect ? `${base}${config.redirect}` : '#',
|
|
92
|
+
}
|
|
93
|
+
})
|
|
94
|
+
})
|
|
95
|
+
</script>
|
|
96
|
+
|
|
97
|
+
<style scoped lang="scss">
|
|
98
|
+
.notesTable {
|
|
99
|
+
width: 100%;
|
|
100
|
+
border-collapse: collapse;
|
|
101
|
+
margin: 1.5rem 0;
|
|
102
|
+
font-size: 0.95rem;
|
|
103
|
+
|
|
104
|
+
th,
|
|
105
|
+
td {
|
|
106
|
+
padding: 0.75rem 1rem;
|
|
107
|
+
text-align: left;
|
|
108
|
+
border: 1px solid var(--vp-c-divider);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
th {
|
|
112
|
+
background-color: var(--vp-c-bg-soft);
|
|
113
|
+
font-weight: 600;
|
|
114
|
+
color: var(--vp-c-text-1);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
tbody tr {
|
|
118
|
+
transition: background-color 0.2s;
|
|
119
|
+
|
|
120
|
+
&:hover {
|
|
121
|
+
background-color: var(--vp-c-bg-soft);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
td {
|
|
126
|
+
color: var(--vp-c-text-2);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
.noteLink {
|
|
130
|
+
color: var(--vp-c-brand-1);
|
|
131
|
+
text-decoration: none;
|
|
132
|
+
font-weight: 500;
|
|
133
|
+
transition: color 0.2s;
|
|
134
|
+
|
|
135
|
+
&:hover {
|
|
136
|
+
color: var(--vp-c-brand-2);
|
|
137
|
+
text-decoration: underline;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
.noteId {
|
|
142
|
+
font-family: var(--vp-font-family-mono);
|
|
143
|
+
font-size: 0.9em;
|
|
144
|
+
color: var(--vp-c-text-3);
|
|
145
|
+
margin-right: 0.5rem;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
.description {
|
|
149
|
+
line-height: 1.6;
|
|
150
|
+
|
|
151
|
+
&.empty {
|
|
152
|
+
color: var(--vp-c-text-3);
|
|
153
|
+
font-style: italic;
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
.error {
|
|
159
|
+
padding: 1rem;
|
|
160
|
+
margin: 1rem 0;
|
|
161
|
+
border-left: 4px solid var(--vp-c-danger-1);
|
|
162
|
+
background-color: var(--vp-c-danger-soft);
|
|
163
|
+
color: var(--vp-c-danger-1);
|
|
164
|
+
border-radius: 4px;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
.warning {
|
|
168
|
+
padding: 1rem;
|
|
169
|
+
margin: 1rem 0;
|
|
170
|
+
border-left: 4px solid var(--vp-c-warning-1);
|
|
171
|
+
background-color: var(--vp-c-warning-soft);
|
|
172
|
+
color: var(--vp-c-warning-1);
|
|
173
|
+
border-radius: 4px;
|
|
174
|
+
}
|
|
175
|
+
</style>
|
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
# NotesTable 组件
|
|
2
|
-
|
|
3
|
-
## 功能说明
|
|
4
|
-
|
|
5
|
-
`NotesTable` 组件用于在 Markdown 文件中渲染笔记列表表格,支持笔记链接跳转和简介显示。
|
|
6
|
-
|
|
7
|
-
## 使用方法
|
|
8
|
-
|
|
9
|
-
### 基础用法
|
|
10
|
-
|
|
11
|
-
```html
|
|
12
|
-
<NotesTable :ids="['0001', '0002', '0054', '0039']" />
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
### 简写形式
|
|
16
|
-
|
|
17
|
-
```html
|
|
18
|
-
<N :ids="['0001', '0002', '0054', '0039']" />
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Props
|
|
22
|
-
|
|
23
|
-
| 属性 | 类型 | 必填 | 说明 |
|
|
24
|
-
| ---- | -------- | ---- | -------------------------------------- |
|
|
25
|
-
| ids | string[] | 是 | 笔记 ID 数组,每个 ID 为 4 位数字字符串 |
|
|
26
|
-
|
|
27
|
-
## 示例效果
|
|
28
|
-
|
|
29
|
-
渲染后的表格包含两列:
|
|
30
|
-
|
|
31
|
-
1. 笔记列: 显示笔记 ID 和标题,支持点击跳转
|
|
32
|
-
2. 简介列: 显示笔记配置中的 `description` 字段内容
|
|
33
|
-
|
|
34
|
-
## 错误处理
|
|
35
|
-
|
|
36
|
-
### 1. ids 属性验证
|
|
37
|
-
|
|
38
|
-
- 如果 `ids` 不是数组,显示错误提示
|
|
39
|
-
- 如果 `ids` 为空数组,显示错误提示
|
|
40
|
-
|
|
41
|
-
### 2. 笔记不存在
|
|
42
|
-
|
|
43
|
-
- 如果某些 ID 在配置中找不到,会显示警告信息
|
|
44
|
-
- 表格只渲染存在的笔记
|
|
45
|
-
|
|
46
|
-
## 数据来源
|
|
47
|
-
|
|
48
|
-
组件从 `notesConfig.data.ts` 中读取笔记配置信息,包括:
|
|
49
|
-
|
|
50
|
-
- 笔记标题 (从 redirect 路径解析)
|
|
51
|
-
- 笔记简介 (description 字段)
|
|
52
|
-
- 笔记链接 (redirect 字段)
|
|
53
|
-
|
|
54
|
-
## 样式特性
|
|
55
|
-
|
|
56
|
-
- 响应式表格设计
|
|
57
|
-
- 悬停高亮效果
|
|
58
|
-
- 支持暗色/亮色主题
|
|
59
|
-
- 笔记链接带品牌色
|
|
60
|
-
- 空简介显示占位文本
|
|
61
|
-
|
|
62
|
-
## 注意事项
|
|
63
|
-
|
|
64
|
-
1. 笔记 ID 必须是 4 位数字字符串 (如 "0001", "0054")
|
|
65
|
-
2. 组件会自动过滤不存在的笔记 ID
|
|
66
|
-
3. 简介为空时显示 "暂无简介"
|
|
67
|
-
4. 链接会自动添加网站 base 路径
|
|
1
|
+
# NotesTable 组件
|
|
2
|
+
|
|
3
|
+
## 功能说明
|
|
4
|
+
|
|
5
|
+
`NotesTable` 组件用于在 Markdown 文件中渲染笔记列表表格,支持笔记链接跳转和简介显示。
|
|
6
|
+
|
|
7
|
+
## 使用方法
|
|
8
|
+
|
|
9
|
+
### 基础用法
|
|
10
|
+
|
|
11
|
+
```html
|
|
12
|
+
<NotesTable :ids="['0001', '0002', '0054', '0039']" />
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
### 简写形式
|
|
16
|
+
|
|
17
|
+
```html
|
|
18
|
+
<N :ids="['0001', '0002', '0054', '0039']" />
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Props
|
|
22
|
+
|
|
23
|
+
| 属性 | 类型 | 必填 | 说明 |
|
|
24
|
+
| ---- | -------- | ---- | -------------------------------------- |
|
|
25
|
+
| ids | string[] | 是 | 笔记 ID 数组,每个 ID 为 4 位数字字符串 |
|
|
26
|
+
|
|
27
|
+
## 示例效果
|
|
28
|
+
|
|
29
|
+
渲染后的表格包含两列:
|
|
30
|
+
|
|
31
|
+
1. 笔记列: 显示笔记 ID 和标题,支持点击跳转
|
|
32
|
+
2. 简介列: 显示笔记配置中的 `description` 字段内容
|
|
33
|
+
|
|
34
|
+
## 错误处理
|
|
35
|
+
|
|
36
|
+
### 1. ids 属性验证
|
|
37
|
+
|
|
38
|
+
- 如果 `ids` 不是数组,显示错误提示
|
|
39
|
+
- 如果 `ids` 为空数组,显示错误提示
|
|
40
|
+
|
|
41
|
+
### 2. 笔记不存在
|
|
42
|
+
|
|
43
|
+
- 如果某些 ID 在配置中找不到,会显示警告信息
|
|
44
|
+
- 表格只渲染存在的笔记
|
|
45
|
+
|
|
46
|
+
## 数据来源
|
|
47
|
+
|
|
48
|
+
组件从 `notesConfig.data.ts` 中读取笔记配置信息,包括:
|
|
49
|
+
|
|
50
|
+
- 笔记标题 (从 redirect 路径解析)
|
|
51
|
+
- 笔记简介 (description 字段)
|
|
52
|
+
- 笔记链接 (redirect 字段)
|
|
53
|
+
|
|
54
|
+
## 样式特性
|
|
55
|
+
|
|
56
|
+
- 响应式表格设计
|
|
57
|
+
- 悬停高亮效果
|
|
58
|
+
- 支持暗色/亮色主题
|
|
59
|
+
- 笔记链接带品牌色
|
|
60
|
+
- 空简介显示占位文本
|
|
61
|
+
|
|
62
|
+
## 注意事项
|
|
63
|
+
|
|
64
|
+
1. 笔记 ID 必须是 4 位数字字符串 (如 "0001", "0054")
|
|
65
|
+
2. 组件会自动过滤不存在的笔记 ID
|
|
66
|
+
3. 简介为空时显示 "暂无简介"
|
|
67
|
+
4. 链接会自动添加网站 base 路径
|