[pull] main from Snailclimb:main

.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: Docs Test
+
+on:
+  - push
+  - pull_request
+
+jobs:
+  test-docs:
+    name: Test docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install deps
+        run: pnpm install --frozen-lockfile
+
+      - name: Build test
+        env:
+          NODE_OPTIONS: --max_old_space_size=4096
+        run: pnpm docs:build

.gitignore

@@ -1,17 +1,24 @@
-/node_modules
-/package-lock.json
+node_modules/
 # *.drawio
 *.drawio.bkp
 .DS_Store
 # VS Code Config file
 .vscode/
-# Vuepress Cache
-.cache/
-# Vuepress Temp
-.temp/
-# Vuepress Output
+# VuePress Cache
+**/.vuepress/.cache/
+# VuePress Temp
+**/.vuepress/.temp/
+# VuePress Output
 dist/
-# Build files
-packages/*/lib/
 traversal-folder-replace-string.py
 format-markdown.py
+
+.npmrc
+package-lock.json
+lintmd-config.json
+.claude/settings.local.json
+<<<<<<< Updated upstream
+=======
+/.obsidian
+docs/ai/claude.md
+>>>>>>> Stashed changes

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm nano-staged

.markdownlint-cli2.mjs

@@ -0,0 +1,28 @@
+export default {
+  config: {
+    default: true,
+    MD003: {
+      style: "atx",
+    },
+    MD004: {
+      style: "dash",
+    },
+    MD010: false,
+    MD013: false,
+    MD024: {
+      allow_different_nesting: true,
+    },
+    MD035: {
+      style: "---",
+    },
+    MD036: false,
+    MD040: false,
+    MD045: false,
+    MD046: false,
+  },
+  ignores: [
+    "**/node_modules/**",
+    // markdown import demo
+    "**/*.snippet.md",
+  ],
+};

.prettierignore

@@ -0,0 +1,15 @@
+# Vuepress Cache
+**/.vuepress/.cache/**
+# Vuepress Temp
+**/.vuepress/.temp/**
+# Vuepress Output
+dist/
+
+# Node modules
+node_modules/
+
+# pnpm lock file
+pnpm-lock.yaml
+
+index.html
+sw.js

docs/.vuepress/client.ts

@@ -0,0 +1,12 @@
+import { defineClientConfig } from "vuepress/client";
+import { h } from "vue";
+import LayoutToggle from "./components/LayoutToggle.vue";
+import GlobalUnlock from "./components/unlock/GlobalUnlock.vue";
+import UnlockContent from "./components/unlock/UnlockContent.vue";
+
+export default defineClientConfig({
+  enhance({ app }) {
+    app.component("UnlockContent", UnlockContent);
+  },
+  rootComponents: [() => h(LayoutToggle), () => h(GlobalUnlock)],
+});

docs/.vuepress/components/LayoutToggle.vue

@@ -0,0 +1,142 @@
+<template>
+  <button
+    class="layout-toggle-btn"
+    :class="{ 'is-hidden': isHidden }"
+    :title="isHidden ? '退出沉浸式阅读' : '沉浸式阅读'"
+    @click="toggleLayout"
+  >
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="16"
+      height="16"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      stroke-width="2"
+      stroke-linecap="round"
+      stroke-linejoin="round"
+    >
+      <path
+        v-if="!isHidden"
+        d="M8 3H5a2 2 0 0 0-2 2v3m18 0V5a2 2 0 0 0-2-2h-3m0 18h3a2 2 0 0 0 2-2v-3M3 16v3a2 2 0 0 0 2 2h3"
+      />
+      <path
+        v-else
+        d="M8 3v3a2 2 0 0 1-2 2H3m18 0h-3a2 2 0 0 1-2-2V3m0 18v-3a2 2 0 0 1 2-2h3M3 16h3a2 2 0 0 1 2 2v3"
+      />
+    </svg>
+    <span class="btn-text">{{ isHidden ? "退出沉浸" : "沉浸阅读" }}</span>
+  </button>
+</template>
+
+<script setup lang="ts">
+import { ref, onMounted, watch, computed } from "vue";
+import { usePageData } from "vuepress/client";
+
+const isHidden = ref(false);
+const pageData = usePageData();
+
+const STORAGE_KEY = "javaguide-layout-hidden";
+const IMMERSIVE_TITLE = "JavaGuide - 沉浸式阅读中";
+
+// 计算当前页面的原始标题
+const originalTitle = computed(() => {
+  const title = pageData.value.title;
+  const siteTitle = "JavaGuide";
+  return title ? `${title} | ${siteTitle}` : siteTitle;
+});
+
+const toggleLayout = () => {
+  isHidden.value = !isHidden.value;
+};
+
+// 更新浏览器标题
+const updateBrowserTitle = (hidden: boolean) => {
+  if (typeof document === "undefined") return;
+  document.title = hidden ? IMMERSIVE_TITLE : originalTitle.value;
+};
+
+// 应用隐藏状态
+const applyHiddenState = (hidden: boolean) => {
+  if (typeof document === "undefined") return;
+  document.documentElement.classList.toggle("layout-hidden", hidden);
+  updateBrowserTitle(hidden);
+};
+
+// 监听沉浸模式状态变化
+watch(isHidden, (newVal) => {
+  applyHiddenState(newVal);
+  localStorage?.setItem(STORAGE_KEY, String(newVal));
+});
+
+// 监听页面切换，更新标题
+watch(
+  () => pageData.value.path,
+  () => {
+    if (isHidden.value) {
+      updateBrowserTitle(true);
+    }
+  },
+);
+
+onMounted(() => {
+  const saved = localStorage?.getItem(STORAGE_KEY);
+  if (saved === "true") {
+    isHidden.value = true;
+    applyHiddenState(true);
+  }
+});
+</script>
+
+<style lang="scss" scoped>
+.layout-toggle-btn {
+  position: fixed;
+  right: 20px;
+  bottom: 150px;
+  z-index: 999;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  height: 36px;
+  padding: 0 14px;
+  font-size: 13px;
+  color: var(--vp-c-text);
+  background: var(--vp-c-bg);
+  border: 1px solid var(--vp-c-border);
+  border-radius: 18px;
+  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.1);
+  cursor: pointer;
+  transition: all 0.3s ease;
+  white-space: nowrap;
+
+  &:hover {
+    color: var(--vp-c-accent);
+    border-color: var(--vp-c-accent);
+    transform: scale(1.02);
+  }
+
+  &.is-hidden {
+    background: var(--vp-c-accent);
+    color: #fff;
+    border-color: var(--vp-c-accent);
+  }
+
+  svg {
+    width: 16px;
+    height: 16px;
+    flex-shrink: 0;
+  }
+
+  .btn-text {
+    font-weight: 500;
+  }
+}
+
+// 移动端和平板隐藏按钮
+@media (max-width: 959px) {
+  .layout-toggle-btn {
+    display: none;
+  }
+}
+</style>