feat: add sidebar link validation script

myml · dengbo11 · commit 3edc73ee117b · 2025-09-26T17:16:47.000+08:00
1. Added prebuild script to validate sidebar links
2. Created new shell script sidebar-link-check.sh
3. Script generates link-check.md with all sidebar links
4. Runs automatically before build process

Log: Added automatic sidebar link validation before builds

Influence:
1. Verify script runs correctly during build process
2. Check generated link-check.md contains all expected links
3. Test with different sidebar configurations
4. Ensure script doesn't break existing build process

feat: 添加侧边栏链接验证脚本

1. 添加构建前脚本用于验证侧边栏链接
2. 创建新的shell脚本sidebar-link-check.sh
3. 脚本生成包含所有侧边栏链接的link-check.md文件
4. 在构建过程前自动运行

Log: 新增构建前自动验证侧边栏链接功能

Influence:
1. 验证脚本在构建过程中是否正确运行
2. 检查生成的link-check.md是否包含所有预期链接
3. 使用不同的侧边栏配置进行测试
4. 确保脚本不会破坏现有的构建流程
diff --git a/.gitignore b/.gitignore
@@ -2,3 +2,4 @@ node_modules
 cache
 dist
 .idea
+linyaps/link-check.md
diff --git a/.vitepress/sidebar/1.6.x.json b/.vitepress/sidebar/1.6.x.json
@@ -128,34 +128,6 @@
         }
       ]
     },
-    {
-      "collapsible": true,
-      "text": "ll-appimage-convert",
-      "items": [
-        {
-          "text": "简介",
-          "link": "/guide/1.6.x/ll-appimage-convert/introduction.md"
-        },
-        {
-          "text": "转换应用",
-          "link": "/guide/1.6.x/ll-appimage-convert/convert-appimage.md"
-        }
-      ]
-    },
-    {
-      "collapsible": true,
-      "text": "ll-flatpak-convert",
-      "items": [
-        {
-          "text": "简介",
-          "link": "/guide/1.6.x/ll-flatpak-convert/introduction.md"
-        },
-        {
-          "text": "转换应用",
-          "link": "/guide/1.6.x/ll-flatpak-convert/convert-flatpak.md"
-        }
-      ]
-    },
     {
       "collapsible": true,
       "text": "调试应用",
@@ -308,34 +280,6 @@
         }
       ]
     },
-    {
-      "collapsible": true,
-      "text": "ll-appimage-convert",
-      "items": [
-        {
-          "text": "Introduction",
-          "link": "/en/guide/1.6.x/ll-appimage-convert/introduction.md"
-        },
-        {
-          "text": "Conversion application",
-          "link": "/en/guide/1.6.x/ll-appimage-convert/convert-appimage.md"
-        }
-      ]
-    },
-    {
-      "collapsible": true,
-      "text": "ll-flatpak-convert",
-      "items": [
-        {
-          "text": "Introduction",
-          "link": "/en/guide/1.6.x/ll-flatpak-convert/introduction.md"
-        },
-        {
-          "text": "Conversion application",
-          "link": "/en/guide/1.6.x/ll-flatpak-convert/convert-flatpak.md"
-        }
-      ]
-    },
     {
       "collapsible": true,
       "text": "Debug App",
diff --git a/.vitepress/sidebar/1.7.x.json b/.vitepress/sidebar/1.7.x.json
@@ -84,21 +84,13 @@
           "text": "运行应用",
           "link": "/guide/1.7.x/ll-builder/run.md"
         },
-        {
-          "text": "转换 appimage",
-          "link": "/guide/1.7.x/ll-builder/convert.md"
-        },
         {
           "text": "导出 layer 文件",
           "link": "/guide/1.7.x/ll-builder/export.md"
         },
         {
           "text": "配置文件",
           "link": "/guide/1.7.x/ll-builder/manifests.md"
-        },
-        {
-          "text": "上架应用到商店",
-          "link": "/guide/1.7.x/ll-builder/github.md"
         }
       ]
     },
@@ -264,21 +256,13 @@
           "text": "Run Compiled App",
           "link": "/en/guide/1.7.x/ll-builder/run.md"
         },
-        {
-          "text": "Convert AppImage",
-          "link": "/en/guide/1.7.x/ll-builder/convert.md"
-        },
         {
           "text": "Export Layer File",
           "link": "/en/guide/1.7.x/ll-builder/export.md"
         },
         {
           "text": "Manifests",
           "link": "/en/guide/1.7.x/ll-builder/manifests.md"
-        },
-        {
-          "text": "App To Store",
-          "link": "/en/guide/1.7.x/ll-builder/github.md"
         }
       ]
     },
diff --git a/.vitepress/sidebar/1.8.x.json b/.vitepress/sidebar/1.8.x.json
@@ -44,7 +44,7 @@
         },
         {
           "text": "更新应用",
-          "link": "/guide/1.8.x/ll-cli/update.md"
+          "link": "/guide/1.8.x/ll-cli/upgrade.md"
         },
         {
           "text": "查看运行中的应用",
@@ -92,21 +92,13 @@
           "text": "运行应用",
           "link": "/guide/1.8.x/ll-builder/run.md"
         },
-        {
-          "text": "转换 appimage",
-          "link": "/guide/1.8.x/ll-builder/convert.md"
-        },
         {
           "text": "导出 layer 文件",
           "link": "/guide/1.8.x/ll-builder/export.md"
         },
         {
           "text": "配置文件",
           "link": "/guide/1.8.x/ll-builder/manifests.md"
-        },
-        {
-          "text": "上架应用到商店",
-          "link": "/guide/1.8.x/ll-builder/github.md"
         }
       ]
     },
@@ -280,21 +272,13 @@
           "text": "Run Compiled App",
           "link": "/en/guide/1.8.x/ll-builder/run.md"
         },
-        {
-          "text": "Convert AppImage",
-          "link": "/en/guide/1.8.x/ll-builder/convert.md"
-        },
         {
           "text": "Export Layer File",
           "link": "/en/guide/1.8.x/ll-builder/export.md"
         },
         {
           "text": "Manifests",
           "link": "/en/guide/1.8.x/ll-builder/manifests.md"
-        },
-        {
-          "text": "App To Store",
-          "link": "/en/guide/1.8.x/ll-builder/github.md"
         }
       ]
     },
diff --git a/.vitepress/sidebar/1.9.x.json b/.vitepress/sidebar/1.9.x.json
@@ -60,7 +60,7 @@
         },
         {
           "text": "更新应用",
-          "link": "/guide/ll-cli/update.md"
+          "link": "/guide/ll-cli/upgrade.md"
         },
         {
           "text": "查看运行中的应用",
@@ -304,21 +304,13 @@
           "text": "Run Compiled App",
           "link": "/en/guide/ll-builder/run.md"
         },
-        {
-          "text": "Convert AppImage",
-          "link": "/en/guide/ll-builder/convert.md"
-        },
         {
           "text": "Export Layer File",
           "link": "/en/guide/ll-builder/export.md"
         },
         {
           "text": "Manifests",
           "link": "/en/guide/ll-builder/manifests.md"
-        },
-        {
-          "text": "App To Store",
-          "link": "/en/guide/ll-builder/github.md"
         }
       ]
     },
diff --git a/package.json b/package.json
@@ -5,6 +5,7 @@
   },
   "scripts": {
     "dev": "vitepress dev",
+    "prebuild": "sh sidebar-link-check.sh",
     "build": "vitepress build",
     "preview": "vitepress preview"
   },
diff --git a/sidebar-link-check.sh b/sidebar-link-check.sh
@@ -0,0 +1,5 @@
+rm linyaps/link-check.md
+for filename in $(ls .vitepress/sidebar/); do
+  echo "generating links for $filename"
+  cat .vitepress/sidebar/$filename | grep 'link' | awk '{print $2'} | xargs -i echo -e "[$filename: {}]({})\n\n" >> linyaps/link-check.md
+done

-Original file line number
+Diff line change
 cache
 dist
 .idea
 +linyaps/link-check.md
Original file line number	Diff line number	Diff line change
`@@ -84,21 +84,13 @@`
`84`	`84`	`"text": "运行应用",`
`85`	`85`	`"link": "/guide/1.7.x/ll-builder/run.md"`
`86`	`86`	`},`
`87`		`- {`
`88`		`- "text": "转换 appimage",`
`89`		`- "link": "/guide/1.7.x/ll-builder/convert.md"`
`90`		`- },`
`91`	`87`	`{`
`92`	`88`	`"text": "导出 layer 文件",`
`93`	`89`	`"link": "/guide/1.7.x/ll-builder/export.md"`
`94`	`90`	`},`
`95`	`91`	`{`
`96`	`92`	`"text": "配置文件",`
`97`	`93`	`"link": "/guide/1.7.x/ll-builder/manifests.md"`
`98`		`- },`
`99`		`- {`
`100`		`- "text": "上架应用到商店",`
`101`		`- "link": "/guide/1.7.x/ll-builder/github.md"`
`102`	`94`	`}`
`103`	`95`	`]`
`104`	`96`	`},`
`@@ -264,21 +256,13 @@`
`264`	`256`	`"text": "Run Compiled App",`
`265`	`257`	`"link": "/en/guide/1.7.x/ll-builder/run.md"`
`266`	`258`	`},`
`267`		`- {`
`268`		`- "text": "Convert AppImage",`
`269`		`- "link": "/en/guide/1.7.x/ll-builder/convert.md"`
`270`		`- },`
`271`	`259`	`{`
`272`	`260`	`"text": "Export Layer File",`
`273`	`261`	`"link": "/en/guide/1.7.x/ll-builder/export.md"`
`274`	`262`	`},`
`275`	`263`	`{`
`276`	`264`	`"text": "Manifests",`
`277`	`265`	`"link": "/en/guide/1.7.x/ll-builder/manifests.md"`
`278`		`- },`
`279`		`- {`
`280`		`- "text": "App To Store",`
`281`		`- "link": "/en/guide/1.7.x/ll-builder/github.md"`
`282`	`266`	`}`
`283`	`267`	`]`
`284`	`268`	`},`
Original file line number	Diff line number	Diff line change
`@@ -44,7 +44,7 @@`
`44`	`44`	`},`
`45`	`45`	`{`
`46`	`46`	`"text": "更新应用",`
`47`		`- "link": "/guide/1.8.x/ll-cli/update.md"`
	`47`	`+ "link": "/guide/1.8.x/ll-cli/upgrade.md"`
`48`	`48`	`},`
`49`	`49`	`{`
`50`	`50`	`"text": "查看运行中的应用",`
`@@ -92,21 +92,13 @@`
`92`	`92`	`"text": "运行应用",`
`93`	`93`	`"link": "/guide/1.8.x/ll-builder/run.md"`
`94`	`94`	`},`
`95`		`- {`
`96`		`- "text": "转换 appimage",`
`97`		`- "link": "/guide/1.8.x/ll-builder/convert.md"`
`98`		`- },`
`99`	`95`	`{`
`100`	`96`	`"text": "导出 layer 文件",`
`101`	`97`	`"link": "/guide/1.8.x/ll-builder/export.md"`
`102`	`98`	`},`
`103`	`99`	`{`
`104`	`100`	`"text": "配置文件",`
`105`	`101`	`"link": "/guide/1.8.x/ll-builder/manifests.md"`
`106`		`- },`
`107`		`- {`
`108`		`- "text": "上架应用到商店",`
`109`		`- "link": "/guide/1.8.x/ll-builder/github.md"`
`110`	`102`	`}`
`111`	`103`	`]`
`112`	`104`	`},`
`@@ -280,21 +272,13 @@`
`280`	`272`	`"text": "Run Compiled App",`
`281`	`273`	`"link": "/en/guide/1.8.x/ll-builder/run.md"`
`282`	`274`	`},`
`283`		`- {`
`284`		`- "text": "Convert AppImage",`
`285`		`- "link": "/en/guide/1.8.x/ll-builder/convert.md"`
`286`		`- },`
`287`	`275`	`{`
`288`	`276`	`"text": "Export Layer File",`
`289`	`277`	`"link": "/en/guide/1.8.x/ll-builder/export.md"`
`290`	`278`	`},`
`291`	`279`	`{`
`292`	`280`	`"text": "Manifests",`
`293`	`281`	`"link": "/en/guide/1.8.x/ll-builder/manifests.md"`
`294`		`- },`
`295`		`- {`
`296`		`- "text": "App To Store",`
`297`		`- "link": "/en/guide/1.8.x/ll-builder/github.md"`
`298`	`282`	`}`
`299`	`283`	`]`
`300`	`284`	`},`
Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,7 @@`
`60`	`60`	`},`
`61`	`61`	`{`
`62`	`62`	`"text": "更新应用",`
`63`		`- "link": "/guide/ll-cli/update.md"`
	`63`	`+ "link": "/guide/ll-cli/upgrade.md"`
`64`	`64`	`},`
`65`	`65`	`{`
`66`	`66`	`"text": "查看运行中的应用",`
`@@ -304,21 +304,13 @@`
`304`	`304`	`"text": "Run Compiled App",`
`305`	`305`	`"link": "/en/guide/ll-builder/run.md"`
`306`	`306`	`},`
`307`		`- {`
`308`		`- "text": "Convert AppImage",`
`309`		`- "link": "/en/guide/ll-builder/convert.md"`
`310`		`- },`
`311`	`307`	`{`
`312`	`308`	`"text": "Export Layer File",`
`313`	`309`	`"link": "/en/guide/ll-builder/export.md"`
`314`	`310`	`},`
`315`	`311`	`{`
`316`	`312`	`"text": "Manifests",`
`317`	`313`	`"link": "/en/guide/ll-builder/manifests.md"`
`318`		`- },`
`319`		`- {`
`320`		`- "text": "App To Store",`
`321`		`- "link": "/en/guide/ll-builder/github.md"`
`322`	`314`	`}`
`323`	`315`	`]`
`324`	`316`	`},`