Firefox GNOME 主题

一个适用于 Firefox 的 GNOME 主题

该主题遵循最新的 GNOME Adwaita 风格。

[!警告]

免责声明：

请注意，此主题可能会执行一些 Firefox 上游不支持的操作。如果您在使用此主题时遇到问题，请先在此处报告，或测试是否可以在原版 Firefox 中重现。

如果您是软件发行版的维护者，请不要默认为您的用户提供这些更改，除非您明确说明他们正在使用修改过的 Firefox 用户界面版本。

主题截图

描述

这是一组 CSS 代码，用于使 Firefox 看起来更接近 GNOME 的原生应用程序。

联系我们

Matrix 聊天室：#firefox-gnome-theme:matrix.org

Firefox 版本支持

本仓库的 master 分支支持当前 Firefox 稳定版本 129。

与旧版 Firefox 兼容的主题版本被保留为 git 标签。

我们还有 beta 和 nightly 分支，用于仅适用于当前 Firefox beta 和 nightly 版本的修复。

安装

包管理器

Arch Linux

安装 AUR 包 firefox-gnome-theme
按照 cat /usr/share/doc/firefox-gnome-theme/INSTALL.md 中的说明操作

使用 curl 的一键安装

要安装此主题，您可以运行以下命令，该命令使用 curl 下载一个脚本，该脚本将下载主题的最新发布版本（非 master 版本）并为您运行自动安装脚本。

警告：从互联网运行脚本时务必小心。

curl -s -o- https://raw.githubusercontent.com/rafaelmardojai/firefox-gnome-theme/master/scripts/install-by-curl.sh | bash

安装脚本

如果您想使用稳定版以外的其他版本主题，可以手动下载主题并运行其安装脚本。

首先，您需要通过 git 克隆获取主题仓库的最新副本。

克隆此仓库并进入文件夹：

git clone https://github.com/rafaelmardojai/firefox-gnome-theme.git
cd firefox-gnome-theme

如果需要，切换到 git 分支或标签，否则使用 master 并忽略此步骤。
```
git checkout beta # 设置 beta 分支
git checkout v78.1 # 设置 v78.1 标签
```

除了 curl 安装外，此主题还提供了两个安装脚本。

自动安装脚本

此脚本将查找来自各个已知位置（~/.mozilla/firefox/、Flatpak、Snap 等）的 Firefox 配置文件，并在每个配置文件中安装主题。如果存在 GTK 主题的颜色变体，它还会启用该变体。

您可以通过运行以下命令执行它：

./scripts/auto-install.sh

手动安装脚本

此脚本仅会将主题安装到默认 Firefox 文件夹 ~/.mozilla/firefox/ 中找到的配置文件中。该脚本接受各种标志来更改其行为。

以下是一些使用示例：

./scripts/install.sh # 标准
./scripts/install.sh -p pc8577yz.default-release # 仅安装到名为 pc8577yz.default-release 的配置文件
./scripts/install.sh -f ~/.var/app/org.mozilla.firefox/.mozilla/firefox # Flatpak
./scripts/install.sh -f ~/snap/firefox/common/.mozilla/firefox #Snap

脚本选项

-f <firefox_folder_path> 可选
- 设置自定义 Firefox 文件夹路径，例如 ~/.mozilla/icecat/。
- 默认：~/.mozilla/firefox/
-p <profile_name> 可选
- 设置自定义配置文件名称，例如 e0j6yb0p.default-nightly。
- 默认：Firefox 文件夹中找到的所有配置文件
-t <theme_name> 可选
- 设置主题中使用的颜色。
- 默认：Adwaita。
- 选项：adwaita、maia。

高级说明

如果您想检出与您的 Firefox 版本匹配的主题版本标签，可以运行：

git checkout v$(firefox --version | cut -d ' ' -f 3 | cut -d '.' -f 1) # 使用 Firefox 版本

手动安装

在 Firefox 中转到 about:support。
应用程序基础 > 配置文件目录 > 打开目录。
在终端中打开目录。
如果不存在，创建 chrome 目录：
```
mkdir -p chrome
cd chrome
```

将此仓库克隆到子目录：

git clone https://github.com/rafaelmardojai/firefox-gnome-theme.git

如果不存在或为空，创建单行用户 CSS 文件（至少需要一行用于 sed）：

[[ -s userChrome.css ]] || echo >> userChrome.css
[[ -s userContent.css ]] || echo >> userContent.css

在 CSS 文件开头导入此主题（所有 @import 必须位于任何现有 @namespace 声明之前）：

sed -i '1s/^/@import "firefox-gnome-theme\/userChrome.css";\n/' userChrome.css
sed -i '1s/^/@import "firefox-gnome-theme\/userContent.css";\n/' userContent.css

创建首选项文件的符号链接：

cd .. # 返回到配置文件目录
ln -fs chrome/firefox-gnome-theme/configuration/user.js user.js

重启 Firefox。
打开 Firefox 自定义面板，将新标签按钮移动到标题栏。
享受您崭新的 GNOME 风格 Firefox。

所需的 Firefox 首选项

我们在 configuration/user.js 中提供了一个 user.js 配置文件，该文件启用了此主题工作所需的一些首选项。

如果您按照上述安装方法之一进行操作，应该已经安装了此文件，但无论如何，请确保在 about:config 中启用了以下首选项：

toolkit.legacyUserProfileCustomizations.stylesheets

此首选项用于在 Firefox 中加载自定义 CSS，否则主题将无法工作。
svg.context-properties.content.enabled

此首选项用于重新着色图标，否则您将看到到处都是黑色图标。

对于其他非必需的首选项，请查看 configuration/user.js。

更新

您可以再次按照安装脚本步骤更新主题。

卸载

转到您的配置文件文件夹。（在 Firefox 中转到 about:support > 应用程序基础 > 配置文件目录 > 打开目录）
删除 chrome 文件夹。
从配置文件文件夹中的 user.js 中删除不需要的首选项。安装脚本会在该文件中附加所需的首选项，您可以通过查看本仓库中的 configuration/user.js 来检查它附加了哪些首选项。

启用可选功能

可以通过在 about:config 中创建新的 boolean 首选项来启用可选功能。

转到 about:config 页面
输入您想要启用的功能的键
将其设置为 boolean 并点击添加按钮
重启 Firefox

功能

隐藏单个标签 gnomeTheme.hideSingleTab

当只打开一个标签时隐藏标签栏。

注意： 您应该将新标签按钮移出标签栏，否则当只有一个标签时它将被隐藏。您可以通过右键单击任何工具栏并选择"自定义工具栏…"来重新排列工具栏。

注意 2： 当使用 Simple Tab Groups 扩展等隐藏标签时，此功能不起作用。在这种情况下，CSS 无法判断只有一个可见标签。
正常宽度标签 gnomeTheme.normalWidthTabs

使用默认 Firefox 的正常宽度标签。
交换标签页关闭按钮位置 gnomeTheme.swapTabClose

默认情况下，标签页关闭按钮跟随窗口控件的位置，此选项可以恢复原有行为。

书签工具栏置于标签页下方 gnomeTheme.bookmarksToolbarUnderTabs

将书签工具栏移至标签页下方。

活动标签页对比度 gnomeTheme.activeTabContrast

为活动标签页增加更多对比度。

仅关闭选中的标签页 gnomeTheme.closeOnlySelectedTabs

仅在选中的标签页上显示关闭按钮。

系统图标 gnomeTheme.systemIcons

使用系统主题图标而非主题自带的 Adwaita 图标。

注意： 此功能存在一个已知的颜色问题。

不使用主题图标 gnomeTheme.noThemedIcons

使用默认 Firefox 图标而非主题自带图标。

符号化标签页图标 gnomeTheme.symbolicTabIcons

使所有标签页图标看起来像符号图标。

隐藏 WebRTC 指示器 gnomeTheme.hideWebrtcIndicator

隐藏多余的 WebRTC 指示器，因为 GNOME 在右上角提供了自己的隐私图标。

隐藏统一扩展按钮 gnomeTheme.hideUnifiedExtensions

从导航栏隐藏统一扩展按钮，您也可以使用 extensions.unifiedExtensions.enabled 代替，但这仅适用于 Firefox 111 之前的版本。

从标题栏按钮拖动窗口 gnomeTheme.dragWindowHeaderbarButtons

允许从标题栏按钮拖动窗口。

注意： 此功能存在 BUG。它可能会意外激活按钮，导致不愉快的行为。

将标签页作为标题栏 gnomeTheme.tabsAsHeaderbar

将标签页置于窗口顶部，并使用标签栏容纳窗口控件，类似 Firefox 的标准标签栏。

注意： 与 gnomeTheme.hideSingleTab 一起启用时，将用标题栏替换单个标签页。

OLED 黑色主题 gnomeTheme.oledBlack

将深色主题改为黑色变体。

扩展支持

我们还提供了一些可选功能来支持某些 Firefox 扩展。

请注意，扩展支持由社区维护，因此不接受支持新扩展的请求，且现有支持可能会失效，直到有人修复。

Tab Center Reborn 支持 gnomeTheme.extensions.tabCenterReborn

通过扩展启用垂直标签页：Tab Center Reborn。

注意： 您还需要将 configuration/extensions/tab-center-reborn.css 文件的内容复制到 Tab Center Reborn 的设置页面。
注意2： 您可以通过 gnomeTheme.extensions.tabCenterReborn.alwaysOpen 保持垂直标签页始终打开。
注意3： 您可以通过禁用扩展中的动画并添加 gnomeTheme.extensions.tabCenterReborn.animationDisabled 标志来禁用动画。

已知问题

CSD 有锐利的边角

参见上游Bug。

Wayland 修复：

转到 about:config 页面
搜索 layers.acceleration.force-enabled 首选项并将其设置为 true。
重启 Firefox，问题应该解决了！

X11 修复：

转到 about:config 页面
输入 mozilla.widget.use-argb-visuals
将其设置为 boolean 并点击添加按钮
重启 Firefox，问题应该解决了！

使用系统图标时图标颜色错误

在某些系统上，原本应该是白色的图标可能会显示为黑色。我不清楚原因，但您可以直接在 system-icons.css 文件中调整它们，查找 --gnome-icons-hack-filter 和 --gnome-window-icons-hack-filter 变量，并尝试调整 CSS 滤镜。