Proxmox Web UI暗黑主题(PVEDiscordDark)技术文档

Proxmox Web UI暗黑主题(PVEDiscordDark)技术文档

PVEDiscordDark A Discord-like dark theme for the Proxmox Web UI. 项目地址: https://gitcode.com/gh_mirrors/pv/PVEDiscordDark

本技术文档旨在提供详细的指导，帮助您安装、使用并理解Proxmox Web UI的暗黑主题——PVEDiscordDark。该主题受Discord界面启发，全面覆盖了Web UI中的每个角落，确保在图表、右键菜单等所有元素上的一致黑暗体验，以保护您的眼睛免受强烈光线伤害。

安装指南

步骤一：执行安装脚本

在运行Proxmox Web UI的节点上，通过以下命令下载并执行安装脚本。请注意，在每次更新Proxmox后，都需重新安装此主题以保持兼容性。

# 方法一：
wget https://raw.githubusercontent.com/Weilbyte/PVEDiscordDark/master/PVEDiscordDark.sh
bash PVEDiscordDark.sh install

# 或者，使用单行命令进行快捷安装：
bash <(curl -s https://raw.githubusercontent.com/Weilbyte/PVEDiscordDark/master/PVEDiscordDark.sh) install

步骤二：清除浏览器缓存

完成安装后，务必清除浏览器缓存以查看主题效果。

使用说明

PVEDiscordDark主题一旦安装成功，会自动应用于Proxmox Web UI，无需额外配置步骤。当您登录到Proxmox界面时，将直接体验到统一风格的暗色界面。

API使用文档

该项目不直接提供传统意义上的API接口供外部调用，它的“API”可以视作其自定义JavaScript代码，该代码修补了Web UI的颜色方案，实现了颜色切换功能。对于开发者而言，了解这部分内部机制有助于定制或扩展主题功能。具体修改或扩展建议深入研究源码中的js/PVEDiscordDark.js文件。

项目更新与卸载

更新主题

每次Proxmox进行升级后，重复上述安装过程即可获取主题的最新版本。

卸载主题

若要移除主题，执行卸载命令并清理浏览器缓存：

bash PVEDiscordDark.sh uninstall

高级选项与离线安装

• 环境变量：通过设置REPO和TAG环境变量，您可以指定从特定仓库和标签（推荐使用SHA-1哈希）安装主题。

• 离线安装：在当前工作目录创建名为offline的文件夹，并放入所需文件集（包含meta目录下的imagelist和supported文件、主题的图片、JavaScript和CSS文件），之后脚本会进入离线模式使用这些资源而非在线下载。

要获取离线包，可检查GitHub Actions的工件部分或发布页面的资产。

---

贡献者感谢: 感谢所有对PVEDiscordDark项目作出贡献的人们，特别鸣谢Crinisus在重写过程中发现并修复的bug。

在探索此项目的同时，欢迎发出您友好的信号——使用“AWOO”表达支持！

---

本文档提供了PVEDiscordDark主题的全方位指南，希望能帮助您顺利地享受到暗黑界面带来的舒适体验。如有更多技术疑问，参考项目GitHub页面上的Wiki和其他社区资源。

PVEDiscordDark A Discord-like dark theme for the Proxmox Web UI. 项目地址: https://gitcode.com/gh_mirrors/pv/PVEDiscordDark