# nav

**Repository Path**: sakay/nav

## Basic Information

- **Project Name**: nav
- **Description**: sakaay ??????(Hugo ?)
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: hugo
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-25
- **Last Updated**: 2026-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sinc Nav - 极简个人导航页（Hugo 版）

一个基于 [Hugo](https://gohugo.io/) 构建的现代化、高颜值个人导航起始页。提供多引擎搜索、实时农历日期显示以及沉浸式动态背景体验。

原 VitePress + Vue 版本已完整迁移到 Hugo：**视觉、样式、交互零改动**，构建时间从数秒降到 **200ms 以内**。

![项目预览](docs/1.webp)

## ✨ 功能特性

- **⏱️ 实时信息**：显示当前时间、公历日期以及中国农历（年份/月份/日期）。
- **🔍 多引擎搜索**：内置 Google、百度、Bing 搜索引擎，支持一键切换。
- **🖼️ 沉浸式背景**：每次刷新从壁纸池随机取一张，PC / 手机各一套；也支持 MP4 视频壁纸。
- **📱 响应式设计**：完美适配桌面端与移动端访问。
- **⚡ 技术栈**：Hugo（静态生成，无前端框架）+ 原生 CSS/JS + 自研精简农历库。
- **🚀 纯静态**：构建产物零运行时依赖，可直接丢到任意静态托管 / OSS / CDN。

## 🛠️ 安装与运行

需要 [Hugo](https://gohugo.io/installation/)（普通版即可，**不需要 extended**；Windows 可 `winget install Hugo.Hugo.Extended`）。

```bash
# 本地预览（热更新）
hugo server

# 打包构建，产物在 public/
hugo
```

> 本仓库 `.tools/hugo.exe` 是一份便携版 Hugo（已在 .gitignore 中忽略），可直接用：
> `.tools/hugo.exe server` / `.tools/hugo.exe`

## ☁️ 部署到阿里云 Pages

### 方式一：平台自动构建

- 构建命令：`hugo`（已开启 `minifyOutput`，产物自动压缩）
- 输出目录：`public`
- 环境变量：`HUGO_VERSION=0.128.0` 或更高（若平台支持指定版本）

### 方式二：本地构建后上传

```bash
hugo
# 把 public/ 整个目录上传/同步到 Pages 的静态目录即可
```

> 如果托管在 OSS / CDN 静态网站：默认首页设为 `index.html`，404 页面设为 `404.html`（Hugo 已生成）。
> `static/ads.txt` 会自动输出到站点根目录，AdSense 的 `ads.txt` 校验无需额外配置。

## ⚙️ 配置说明

全部配置集中在 **`hugo.toml`**：

```toml
[params.startPage]
  title = "sakaayの导航页"
  bgVideo = ""                  # 填了视频就优先播放视频，覆盖静态壁纸
  bgImage = [ "/assets/bg/static/d22.webp", ... ]        # 电脑端壁纸池
  bgImageMobile = [ "/assets/bg/static-mobile/m8.webp" ] # 手机端壁纸池

[params.footer]
  author = "十三"
  siteName = "nav.nw177.cn"

[params.ads]                    # Google AdSense 广告位
  client = "ca-pub-... "
```

**导航卡片数据**：`data/apps.json`（数组，每项一个分组，`items` 里配 `name` / `icon` / `url`）。
`icon` 填 emoji 即显示文字图标，填 `/assets/icon/xxx.png` 即显示图片图标。

**搜索引擎**：`layouts/partials/search.html` 顶部的 `$engines` 列表，可自由增删。

## 📂 目录结构

```
.
├── hugo.toml                     # 站点与首页/页脚/广告配置
├── content/_index.md             # 首页（内容为空，样式在布局里）
├── data/apps.json                # 导航卡片分组数据
├── assets/                       # 需经 Hugo Pipes 处理的资源
│   ├── css/main.css              # 全站样式（由 Vue 组件样式 1:1 迁移）
│   └── js/
│       ├── lunar.js              # 精简农历库（1900-2100，约 5KB）
│       └── main.js               # 时钟/搜索/Tab/广告 交互
├── layouts/
│   ├── index.html                # 首页结构
│   ├── 404.html
│   ├── _default/baseof.html
│   └── partials/{head,scripts,search,nav-grid,ads,footer}.html
├── static/                       # 原样输出的静态资源
│   ├── ads.txt
│   └── assets/{bg,icon,home}/    # 壁纸、图标、favicon
├── public/                       # 构建产物（已 gitignore）
└── legacy-vitepress/             # 旧 VitePress 工程存档，确认没问题后可删除
```

## 📄 许可证

MIT License