Skip to content

Latest commit

 

History

History
124 lines (84 loc) · 7.11 KB

README.md

File metadata and controls

124 lines (84 loc) · 7.11 KB
Raw

Telegram Theme For Icalingua++

一个基于 Icalingua++ 的 Telegram 风格主题。

Motivation | 动机

我非常喜欢 Telegram Desktop 的 UI，但是在很多时候我都没法访问 Telegram，并且地区使用习惯的原因，我很难使用 Telegram，而是使用 QQ。

但是 Tencent QQ NT 版本的 UI 完全没有办法自由定制，即使定制成功了也是 HACK 进去的，对这款软件来说它并不合法。所以我决定使用 Icalingua++ 来实现这个主题。它完全可以实现 Telegram 的 UI，而且它是开源的，可以让更多的人使用。

总结：QQ NT 一坨屎，Icalingua++ 大大滴好！

但其实这个主题与其名曰主题，不如说是一个增强版的 Icalingua++，因为它不仅仅是一个主题，它还会增强 Icalingua++ 的功能与体验。

Attentions | 注意事项

  • 由于 Icalingua++ 的限制，我改变了消息列表的 DOM 结构，所以我暂时无法实现点击图片放大的功能。后续可能我会尝试重写灯箱来实现这个功能。Issue #16
  • 它强制改变了很多原本的DOM结构，这可能会导致一些功能出现问题，如果你发现了这些问题，欢迎提交 Issue。
  • 由于我们想要增强聊天功能，我们可能需要另外启动一个子进程来处理一些信息。如果你不信任我 / 不信任仓库代码，你可以不使用这个主题。
  • 在 #32 中，我实现了手动控制功能启动功能，你现在可以在 config.js 中设置你想要启动的功能了，你也可以将 manual 设置为 false 来启动所有功能。有关更多配置信息，请参阅 Config | 配置。

Features | 特性

  • 基础样式。 将 Telegram 的大部分样式移植到 Icalingua++。
  • 深度修改。 将同一联系人的多条消息合并为一条，以减少界面占用。
    • 更好的图片信息显示效果。 以更好的方式显示图片信息。
    • 新图标。 用 Telegram 风格的图标替换图标。
    • 漂亮的模态框。 更改模态框的样式，使其更加美观。
    • 不同的用户名颜色。 为每个用户名分配不同的颜色，以便更好地区分不同的联系人。
    • 良好的动效。 为 Icalingua++ 移除与主题不和谐的动效以及添加更多合理的动效。
  • 更多样式。 将添加更多样式，使 Icalingua++ 更像 Telegram。
  • 更好的开发体验。 自动重载样式和页面，以便开发者更好地开发主题。

Installation | 安装

Automatic | 自动安装

  1. 下载最新的发布版本或从 CI Release 下载最新的构建版本。
  2. 给予执行权限 chmod +x install.sh
  3. 在解压缩包后的目录下运行 ./install.sh。
  4. 重启 Icalingua++。

Manual | 手动安装

从 CI 下载

  1. 下载最新的发布版本或从 CI Release 下载最新的构建版本。
  2. 将 addon.js, style.css, main.js, config.js 复制到 Icalingua++ 的数据目录
  3. 重启 Icalingua++。

从源码安装

  1. 克隆这个仓库。
  2. 安装依赖 pnpm install。
  3. 给予执行权限 chmod +x dist/install.sh。
  4. 运行 cd dist && ./install.sh。
  5. 重启 Icalingua++。

Enhancements & Feat. | 增强 & 新功能

这个文件用于帮助一些由于 DOM 结构的原因无法直接通过改变 CSS 实现目标样式的元素。已经实现的功能有：

  • 获取 ChatGroup 的宽度以改变 ChatGroup Aside 为 Telegram 风格的头部菜单栏。
  • 合并同一联系人的多条消息为一条。
  • 更好的图片信息显示效果。（仅针对单张图片消息）
  • 移除回复消息的图标并改为点击即可回复消息的样式。
  • 为每个用户名分配不同的颜色。
  • 自动重载 CSS 和 JS 文件。
  • 手动控制功能启动功能。
  • 全新的图像显示器。
  • 主题自动更新器。
  • 用 Telegram 风格的图标替换图标。
  • 更改模态框的样式，使其更加美观。
  • 鼠标滑动以回复消息

Config | 配置

在 #32 中，我们引入了一个新的配置文件 config.js，你可以在这个文件中配置你想要启动的功能。有关这个文件的配置项定义，你可以前往 types.d.ts 查看。在此我简单介绍一下配置项：

Note

不知道咋写的先学下 JavaScript 吧，或者将 manual 设置为 false，这样所有功能都会启动。

core -- 启动的核心功能

你可以去前往 core 查看所有的核心功能。你需要填入的是核心功能的 Key。如：

在文件里有一行代码：

"modify-chat-box-interval": modifyChatBoxInterval,

我想启动这个功能，那么你在 config.js 的 core 中需要填入的是 [modify-chat-box-interval]，以此类推。

chatbox --- 启动的聊天框修改功能

与 core 类似，你可以去前往 chatbox 查看所有的聊天框修改功能。你需要填入的是聊天框修改功能的 Key。

其他注意事项

  • 你可以在 config.js 中设置 manual 为 false 来启动所有功能。
  • 当 dev 为 true 且你启动了 fileChangesListener 时，当你对 JS 文件进行修改时，Icalingua++ 会自动重载窗口，对 CSS 文件修改时，Icalingua++ 会自动重载 CSS 文件。
  • 当 dev 为 true 时，全部功能都会启动，你无法通过 manual 或其他办法来关闭功能（除了删代码 🙂）。
  • 修改了 config.js 后，你需要重启 / 重载 Icalingua++ 才能使配置生效。
  • 你如果“不小心”填错了功能的 Key，你大可以放心这个功能是不会被启动的，并且在控制台会有错误警告。
  • 如果你对这种控制台乱拉屎的行为非常厌恶 🤬，你可以将 log 设置为 false 来关闭控制台输出。

Preview

Light Dark
light dark

Author

Telegram Theme For Icalingua++ © Wibus, Released under AGPLv3. Created on Jul 1, 2023

Personal Website · Blog · GitHub @wibus-wee · Telegram @wibus✪