feat(文档): 统一代码块语法标记并添加GitHub编辑功能

将多个文档中的代码块语法标记从`url`、`textile`等统一改为`bash`以提高一致性添加GitHub编辑配置和前端组件，允许用户直接在GitHub上编辑文档
2026-01-31 00:53:19 +08:00 · 2025-09-05 03:35:58 +08:00
parent 7c13ef8901 16af4a267d
commit 52720591c3
9 changed files with 47 additions and 11 deletions
--- a/src/config.ts
+++ b/src/config.ts
@@ -1,5 +1,6 @@
 import type {
    ExpressiveCodeConfig,
+	GitHubEditConfig,
 	ImageFallbackConfig,
 	LicenseConfig,
 	NavBarConfig,
@@ -11,6 +12,7 @@ import { LinkPreset } from "./types/config";

 export const siteConfig: SiteConfig = {
 	title: "AcoFork Blog",
+	subtitle: "技术分享与实践",
 	description:
 		"分享网络技术、服务器部署、内网穿透、静态网站搭建、CDN优化、容器化部署等技术教程与实践经验的个人技术博客，专注于云原生、无服务器架构和前后端开发，作者为afoim/二叉树树",

@@ -123,4 +125,9 @@ export const umamiConfig: UmamiConfig = {

 export const expressiveCodeConfig: ExpressiveCodeConfig = {
 	theme: "github-dark",
+};
+
+export const gitHubEditConfig: GitHubEditConfig = {
+	enable: true,
+	baseUrl: "https://github.com/afoim/fuwari/blob/main/src/content/posts",
 };
--- a/src/content/posts/h3c-debug.md
+++ b/src/content/posts/h3c-debug.md
@@ -65,7 +65,7 @@ lang: ''

 进入下述网址，你就能看到Telnet开关，打开即可

-```url
+```bash
 https://192.168.124.1/debug.asp
 ```

--- a/src/content/posts/ip6-arpa.md
+++ b/src/content/posts/ip6-arpa.md
@@ -68,7 +68,7 @@ lang: ''

 获取必要信息，发起更改SSL提供商请求

-```curl
+```bash
 curl --location --request PATCH 'https://api.cloudflare.com/client/v4/zones/<zone_id>/ssl/universal/settings' --header 'X-Auth-Email: 你的CF注册邮箱' --header 'X-Auth-Key: 你的CF全局APIKey' --header 'Content-Type: application/json' --data-raw '{"enabled":true,"certificate_authority":"ssl_com"}'
 ```

--- a/src/content/posts/netlify-oss.md
+++ b/src/content/posts/netlify-oss.md
@@ -24,7 +24,7 @@ lang: ''

 我是这样写的

-```textile
+```bash
 Open Source Team Application
 Applicant Name: no name provided
 Applicant Email: acofork@gmail.com
--- a/src/content/posts/reality.md
+++ b/src/content/posts/reality.md
@@ -66,7 +66,7 @@ x-ui vX.X.X installation finished, it is running now...

 然后访问面板。其中 `WebBasePath` 在安装后会展示

-```url
+```bash
 https://公网IP:面板端口/WebBasePath
 ```

--- a/src/content/posts/vercel-deny.md
+++ b/src/content/posts/vercel-deny.md
@@ -267,7 +267,7 @@ if __name__ == "__main__":

 示例ip.txt

-```textile
+```bash
 223.26.78.6
 182.101.26.81
 101.226.41.74
--- a/src/content/posts/wyy-timestrap.md
+++ b/src/content/posts/wyy-timestrap.md
@@ -21,13 +21,13 @@ lang: ''

 接下来拼接URL

-```url
+```bash
 https://music.163.com/api/song/media?id=29812004
 ```

 访问就得到歌词时间戳啦

-```url
+```bash
 {"songStatus":1,"lyricVersion":44,"lyric":"[by:月餖]\n[00:19.30]The clock stopped ticking forever ago\n\n[00:23.300]How long have I been up?\n[00:25.300]I don't know.\n[00:26.300]I can't get a grip,\n[00:28.300]But I can't let go\n[00:30.300]There wasn't anything\n[00:31.300]To hold onto though...\n[00:33.300]Why can't I see?\n[00:35.300]Why can't I see?\n[00:37.300]All the colors that you see?\n[00:40.300]Please, Can I be,\n[00:42.300]Please, Can I be\n[00:44.300]Colorful and free?\n[00:47.300]WHAT THE HELL'S GOING ON?!\n[00:48.300]CAN SOMEONE TELL ME PLEASE--\n[00:50.300]WHY, I'M SWITCHING FASTER THAN THE CHANNELS ON TV!!\n[00:53.300]I'M black, THEN I'M white!!\n[00:55.300]NO!!!\n[00:56.300]SOMETHING ISN'T RIGHT!!\n[00:57.300]MY ENEMY'S INVISIBLE, I DON'T KNOW HOW TO FIGHT!!\n[01:01.300]THE TREMBLING FEAR IS MORE THAN I CAN TAKE,\n[01:04.300]WHEN I'M UP AGAINST\n[01:05.300]THE ECHO IN THE MIRROR!!\n[01:08.300]ECHO!!\n[01:14.300]\n[02:23.300]I'm gonna burn my house down,\n[02:27.300]Into an ugly black.\n[02:28.300]I'm gonna run away, Now\n[02:31.300]And never look back.\n[02:32.300]I'm gonna burn my house down,\n[02:34.300]Into an ugly black.\n[02:35.300]I'm gonna run away, Now\n[02:37.300]And never look back.\n[02:39.300]I'm gonna run away down,\n[02:41.300]I'm gonna run away.\n[02:42.300]I'm gonna run away, Now\n[02:44.300]I'm gonna run away\n[02:53.300]I'm gonna burn my house down.\n[02:54.300]And never look back.\n[02:56.300]And never look back.\n[02:58.300]AND NEVER LOOK BACK!!\n[02:59.300]WHAT THE HELL'S GOING ON?!\n[03:01.300]CAN SOMEONE TELL ME PLEASE--\n[03:03.300]WHY, I'M SWITCHING FASTER THAN THE CHANNELS ON TV!!\n[03:06.300]I'M black, THEN I'M white!!\n[03:08.300]NO!!!\n[03:08.300]SOMETHING ISN'T RIGHT!!\n[03:10.300]MY ENEMY'S INVISIBLE, I DON'T KNOW HOW TO FIGHT!!\n[03:13.300]WHAT THE HELL'S GOING ON?!\n[03:15.300]CAN SOMEONE TELL ME PLEASE--\n[03:17.300]WHY, I'M SWITCHING FASTER THAN THE CHANNELS ON TV!!\n[03:20.300]I'M black, THEN I'M white!!\n[03:21.300]NO!!!\n[03:22.300]SOMETHING ISN'T RIGHT!!\n[03:23.300]MY ENEMY'S INVISIBLE, I DON'T KNOW HOW TO FIGHT!!\n[03:27.300]THE TREMBLING FEAR IS MORE THAN I CAN TAKE,\n[03:31.300]WHEN I'M UP AGAINST\n[03:32.300]THE ECHO IN THE MIRROR!!\n[03:34.300]THE TREMBLING FEAR IS MORE THAN I CAN TAKE,\n[03:37.300]WHEN I'M UP AGAINST\n[03:39.300]THE ECHO IN THE MIRROR!!","code":200}
 ```

--- a/src/pages/posts/[...slug].astro
+++ b/src/pages/posts/[...slug].astro
@@ -7,7 +7,7 @@ import MainGridLayout from "@layouts/MainGridLayout.astro";
 import { getSortedPosts } from "@utils/content-utils";
 import { getDir, getPostUrlBySlug } from "@utils/url-utils";
 import { Icon } from "astro-icon/components";
-import { licenseConfig } from "src/config";
+import { gitHubEditConfig, licenseConfig } from "src/config";
 import PostMetadata from "../../components/PostMeta.astro";
 import ImageWrapper from "../../components/misc/ImageWrapper.astro";
 import { profileConfig, siteConfig } from "../../config";
@@ -116,9 +116,29 @@ const jsonLd = {
                <Content />
            </Markdown>

-
-
-            {licenseConfig.enable && <License title={entry.data.title} slug={entry.slug} pubDate={entry.data.published} class="mb-6 rounded-xl license-container onload-animation"></License>}
+            <!-- GitHub 编辑链接 -->
+            {gitHubEditConfig.enable && (
+                <div class="mb-6 p-4 rounded-xl bg-[var(--license-block-bg)] border border-[var(--line-divider)] onload-animation">
+                    <div class="flex items-center gap-3">
+                        <div class="h-5 w-5 rounded bg-[var(--primary)] flex items-center justify-center">
+                            <Icon name="material-symbols:edit-outline" class="text-[0.875rem] text-white dark:text-black/70"></Icon>
+                        </div>
+                        <div class="flex-1">
+                            <p class="text-black/80 dark:text-white/80 text-sm mb-1">发现错误或想要改进这篇文章？</p>
+                            <a 
+                                href={`${gitHubEditConfig.baseUrl}/${entry.slug}.md`}
+                                target="_blank"
+                                rel="noopener noreferrer"
+                                class="inline-flex items-center gap-1 text-[var(--primary)] hover:text-[oklch(0.65_0.16_var(--hue))] text-sm font-medium transition-colors"
+                            >
+                                <Icon name="fa6-brands:github" class="text-[0.875rem]"></Icon>
+                                在 GitHub 上编辑此页
+                                <Icon name="material-symbols:open-in-new" class="text-[0.75rem]"></Icon>
+                            </a>
+                        </div>
+                    </div>
+                </div>
+            )}
            
            <!-- 文章帮助反馈区域 -->
            <div class="mb-4 p-3 rounded-lg bg-[var(--license-block-bg)] border border-[var(--line-divider)] onload-animation">
@@ -141,6 +161,10 @@ const jsonLd = {
                    </div>
                </div>
            </div>
+
+            {licenseConfig.enable && <License title={entry.data.title} slug={entry.slug} pubDate={entry.data.published} class="mb-6 rounded-xl license-container onload-animation"></License>}
+            
+
            
            <!-- Giscus 评论区 -->
            <script src="https://giscus.app/client.js"
--- a/src/types/config.ts
+++ b/src/types/config.ts
@@ -113,4 +113,9 @@ export type BlogPostData = {

 export type ExpressiveCodeConfig = {
 	theme: string;
+};
+
+export type GitHubEditConfig = {
+	enable: boolean;
+	baseUrl: string;
 };