简体中文 | English

谦谦的主页

🎉 原版功能

• 载入动画
• 站点简介
• Hitokoto 一言
• 日期及时间
• 实时天气
• 时光进度条
• 音乐播放器
• 移动端适配

🎉 新增的功能

• 网站列表支持多链接
• 增加腾讯天气 API
• 增加图片壁纸随机不重复功能【强迫症必备】
• 移除音乐播放器（鸡肋功能）
• 给分页按钮增加模糊
• 增加萌ICP备案

修复的bug

• 修复高德天气 API
• 去除网页链接文字跳转
• 修复分页按钮不显示的bug

⚙️ 自动部署

如果遇到构建环境或者打包过程出现错误，则可以采用 Github Actions 来进行自动构建

• 在成功 fork 仓库后，前往 Actions 页面，若您是首次开启，则会出现下面的提示，点击开启

  

• 然后在仓库中进行任意修改后均会触发工作流的运行，在工作流完成后，会在下方生成一个可供下载的压缩包，这就是构建出的静态文件，可自行上传至服务器

  

⚙️ 手动部署

• 安装 node.js 环境

  node > 16.16.0
  npm > 8.15.0

• 然后以 管理员权限 运行 cmd 终端，并 cd 到 项目根目录

• 在 终端 中输入：

# 安装 pnpm
npm install -g pnpm

# 安装依赖
pnpm install

# 预览
pnpm dev

# 构建
pnpm build

构建完成后，静态资源会在 dist 目录 中生成，可将 dist 文件夹下的文件上传至服务器，也可使用 Vercel 等托管平台一键导入并自动部署

⚙️ Docker 部署

安装及配置 Docker 将不在此处说明，请自行解决

# 构建
docker build -t home .
# 运行
docker run -p 12445:12445 -d home

⚙️ Vercel 部署

其他部署平台大致相同，在此不做说明

1. 点击本仓库右上角的 Fork，复制本仓库到你的 GitHub 账号
2. 复制 /.env.example 文件并重命名为 /.env（ 重要 ）
3. 按需修改 /.env 文件中的配置
4. 点击 Deploy，即可成功部署

网站链接

在 src/assets/siteLinks.json 中可以自定义网站链接（以指向自己的网站）:

{
  "home": [
    {
      "icon": "Compass",
      "name": "NginxUI",
      "link": "",
      "ipv4": "https://a.example.com",
      "ipv6": "https://a.example.com",
      "vlan": "http://10.2.1.2:1000",
      "lan": "http://192.168.5.2:1000"
    }
  ],
  "cloud": [
    {
      "icon": "Compass",
      "name": "NginxUI",
      "link": "",
      "ipv4": "https://a.example.com",
      "ipv6": "https://a.example.com",
      "vlan": "http://10.2.1.2:1000",
      "lan": "http://192.168.5.2:1000"
    }
  ]
}

其中 icon 网站链接的图标可以在 src/components/Links/index.vue 中添加:

// 可前往 https://www.xicons.org 自行挑选并在此处引入
// 此处引入的是 fa 类型
import {
  Link,
  Blog,
  CompactDisc,
  Cloud,
  Compass,
  Book,
  Fire,
  LaptopCode,
} from "@vicons/fa";

...

// 网站链接图标
const siteIcon = {
  Blog,
  Cloud,
  CompactDisc,
  Compass,
  Book,
  Fire,
  LaptopCode,
};

社交链接

在 src/assets/socialLinks.json 中可以自定义社交链接。

天气

天气及地区获取需要相关 API

• 前往 高德开放平台控制台 创建一个 Web 服务 类型的 Key，并将 Key 填入 .env 中的 VITE_GD_WEATHER_KEY 中
• 前往 腾讯地图平台 创建一个 Web 服务 类型的 Key，并将 Key 填入 .env 中的 VITE_TX_WEATHER_KEY 中

也可自行更换其他方式

音乐

本项目中已移除，但保留了代码。如需打开，只需在.env中将音乐相关注释取消即可。

字体

现采用 HarmonyOS Sans 开源字体，采用字体拆分，提升加载速度

https://s1.hdslb.com/bfs/static/jinkela/long/font/regular.css

旧版方式

由于本项目引入了中文字体，需要压缩中文字体以提高网页加载速度（ 也可以取消使用中文字体 ）

中文字体去除繁体

• 安装 Python 3.7 和 pip
• 运行 pip install fonttools
• 下载 sc_unicode.txt
• 运行 pyftsubset 字体名称.ttf --unicodes-file=sc_unicode.txt

字体进一步压缩

• 编译安装 Google woff2

sudo apt-get install -y git g++ make
git clone --recursive https://github.com/google/woff2.git
cd woff2
make clean all

• 再压缩字体

./woff2_compress ./字体名称.ttf

• 最终可对原字体进行缓加载，先行加载压缩后的字体

详细信息可前往 虹墨空间站 查看原文

网站图标及网站背景

网站背景

可以在 public/images/mine 中修改网站背景

如果想要添加更多的本地图片作为网站背景，可以将图片重命名 background+数字 的形式，并在 src/components/Background/index.vue 中进行修改：

  if (type == 0) {
    const nextId = getBgRandom();
    // bgUrl.value = `/images/mine/background${bgRandom}.png`;
    bgUrl.value = `/images/mine/background${nextId}.webp`;
  }

网站图标

可以在 public/images/icon 中修改网站图标。

技术栈

• Vue
• Vite
• Pinia
• IconPark
• xicons
• Aplayer

API

• 韩小韩 WebAPI 接口
• 搏天 API
• 教书先生 API
• 高德开放平台
• Hitokoto 一言