V变量—建站日记 - vercel
type: channel
link: https://888720.xyz/tag/vercel/
items: 适合"养老"的网站收藏夹导航——基于Astro的导航站主题,支持 Vercel 和 Cloudflare Pages一键部署

适合"养老"的网站收藏夹导航——基于Astro的导航站主题,支持 Vercel 和 Cloudflare Pages一键部署
type: item
date: 2025-06-12T22:22:00+08:00
description: 1 前言源码来源于Nodeseek的zywe，源码地址。演示地址：dh.zywe.de关于xwnav-theme源码的简介：人人都能搭建的简洁美观收藏夹网站。不仅仅是简单的链接集合，更是智能化的导航平台，让您只需专注于内容管理而非技术细节,**只需编辑一个数据文件，所有功能都会自动更新，极大简化了维护工作，打包后部署超轻量化（1-2mb）。🌟 独特优势🤖 自动化功能，让您只需专注于内容管理而非技术细节,只需修改一个数据文件（src/data/navLinks.js），所有功能都会自动更新，极大简化了维护工作自动化功能🖼️ 自动图标获取：添加新网站和新分类时无需手动下载图标，脚本自动获取并优化图标引用图标一条龙📑 自动分类导航：侧边栏分类导航会根据数据文件自动更新，无需手动修改HTML🔎 自动搜索索引：搜索功能会自动检测新增网站和分类，无需额外配置🃏 自动卡片生成：网站卡片布局会自动适应新增内容，保持一致的视觉效果🎨 自动主题切换：根据用户系统配置自动切换暗色/亮色主题🧹 自动清理图标：图标管理脚本会自动清理未使用的图标文件，保持项目整洁📱 自动响应式适配：无需编写额外代码，完美适配各种设备屏幕🗺️ 自动生成站点地图：每次构建项目自动生成robots.txt和sitemap.xml📝 自动SEO元数据：每次构建项目自动生成和管理SEO相关的元标签等等代码🟢灯塔PageSpeed Insights2🌈 主要特点🏷 简洁直观的界面：分类清晰，操作便捷🔍 智能搜索功能：快速查找您需要的网站📎 双分类导航栏：主页横向导航+侧边导航📃 卡片式网站展示：直观美观，一目了然🔄 自动化工作流：减少手动操作，提高效率🌓 暗色模式：智能切换暗色/亮色模式⏱️ 快速返回顶部：一键回到顶部的便捷按钮🚀 快速加载：基于Astro框架构建，性能卓越📸 图片懒加载：提升加载速度和用户体验🔊 流畅的动画过渡：提升用户界面交互体验💻 智能顶部栏: 上滑展出,下滑收缩不挡视野🙌 人性化设计: 搜索框侧边栏可点空白处退出🌤️ 实时天气显示：集成API实时获取当地天气📱 响应式布局：适配所有设备屏幕🔒 无需数据库：纯静态设计，无需数据库🔑 隐藏链接地址：悬停在卡片，不显示链接地址💾 Island岛屿架构按需加载：动态组件独立渲染，提升加载速度静态首屏：首屏纯静态生成，并行加载交互组件延迟水合：交互元素延迟水合，减少首屏阻塞查询优先：搜索和导航操作优先渲染浏览器缓存：利用存储机制优化重复访问3🎶 部署教程推荐：本地Windows开发 + Linux服务器部署:本地开发和构建,仅将执行构建命令后的dist目录部署到服务器3.1 git 拉取git clone https://github.com/zywe03/astro-nav-theme.git(或者下载压缩包源码解压)3.2 windowns安装Node.js 环境安装 Node.js 18.0+ (推荐LTS版本)官网Windows用户：直接从官网下载安装包3.3 包管理器选择启用 pnpm（轻量、高效）corepack enable corepack prepare pnpm@latest --activate3.4 开始安装# 安装依赖 pnpm i # 浏览器实时看效果 pnpm dev # 自动下载图标 npx tsx .\icon-system\0icon.ts # 打包构建生成/dist目录 pnpm build3.5 上传/dist目录到服务器,nginx反代4 借助AI导入导航数据第一次导入大量网址链接,借助AI快速生成网站导航内容(强烈建议)列出想要生成的网站所属分类,名称或网站,短和长描述让AI生成，节省工作量AI提示词:统一分类opensource 网站： github baidu.com 谷歌 具体按照以下样式生成，使用“JavaScript风格格式+单引号”，不要添加"icon字段"和"[]"" { id: 'github', title: 'GitHub', description: '全球最大的开源代码托管平台，支持 Git 版本控制，适用于协作开发、项目管理和自动化工作流，是开发者共享与协作的核心工具。' shortDesc: '代码托管平台。', url: 'https://github.com/', category: 'opensource', }, 描述根据网站实际内容,专业,准确,介绍背景独特优势等等,不要太刻板,臃肿,重复插入数据文件navLinks.js后 执行npx tsx .\icon-system\0icon.ts自动下载图标,即可完成,大量导航网站导入5 💬 日常使用关键文件和目录说明5.1 核心数据文件src/data/navLinks.js: 存储所有网站数…