Bilibili-Banner 开源项目使用教程

Bilibili-Banner 开源项目使用教程

bilibili-banner 一键复刻 B 站首页动态 Banner，本仓库记录其历史Banner以供学习和欣赏（自2023-08-21开始） 项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-banner

1. 项目介绍

Bilibili-Banner 是一个开源项目，旨在复刻 B 站首页动态 Banner 的效果。该项目使用原生 JavaScript 实现，无需任何第三方依赖。它能够自动抓取资源并生成配置，从而可以快速复刻 B 站的动态 Banner，实现接近 1:1 的效果还原。

2. 项目快速启动

环境准备

在开始之前，请确保您的系统中已经安装了 Node.js。

安装项目

克隆项目到本地：

git clone https://github.com/palxiao/bilibili-banner.git

进入项目目录并安装依赖：

cd bilibili-banner
pnpm i
# 或者
yarn
# 或者
npm i

运行演示

启动本地服务器查看演示网页：

npm run serve

抓取 B 站首图数据

如果要获取最新的 B 站 Banner 数据，可以运行以下命令：

npm run grab "Banner名称"

其中 "Banner名称" 是你需要给 Banner 起的名字。这将在 assets 目录下生成对应的数据文件（以当天日期命名）。

重新启动本地服务器查看效果：

npm run serve

访问演示

在浏览器中访问 http://127.0.0.1:8080 即可看到最新的效果。

3. 应用案例和最佳实践

修改配置

在 config.js 文件中可以修改配置，如需使用 fetch 引入 json 配置，可以按以下方式修改：

// 示例配置修改
fetch('path/to/your/config.json')
  .then(response => response.json())
  .then(data => {
    // 使用 data 进行配置
  });

自定义参数

打开 assets 目录下对应的 data.json 文件，可以修改每个对象的参数，如加速度、旋转幅度、重力、大小变化和透明度等，然后刷新网页查看效果。

4. 典型生态项目

目前该项目主要作为一个单机版 Banner 复刻工具，未来可以扩展为支持更多交互效果或者集成到其他项目中，形成更加丰富多样的生态项目。例如，可以开发一个后台管理系统来动态管理 Banner 数据，或者将其集成到电商平台中作为商品展示的一部分。

bilibili-banner 一键复刻 B 站首页动态 Banner，本仓库记录其历史Banner以供学习和欣赏（自2023-08-21开始） 项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-banner