Update README
This commit is contained in:
parent
71dc2de659
commit
eab2536401
110
README.md
110
README.md
|
@ -2,6 +2,7 @@
|
||||||
A GNOME theme for Firefox 60+.
|
A GNOME theme for Firefox 60+.
|
||||||
|
|
||||||
*This theme follows lastest GNOME default gtk theme adwaita*
|
*This theme follows lastest GNOME default gtk theme adwaita*
|
||||||
|
|
||||||
**This theme is under development and is not ready to use**
|
**This theme is under development and is not ready to use**
|
||||||
|
|
||||||
![Screenshot of the theme](screenshot.png)
|
![Screenshot of the theme](screenshot.png)
|
||||||
|
@ -9,116 +10,13 @@ A GNOME theme for Firefox 60+.
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
This is a bunch of CSS code to make Firefox look closer to GNOME's default
|
This is a bunch of CSS code to make Firefox look closer to GNOME's default
|
||||||
theme. It styles the UI and internal Firefox' pages like `about:` and
|
theme.
|
||||||
`view-source:`. Both light and dark variants are supported.
|
|
||||||
|
|
||||||
The `master` branch track current Firefox stable. If you need support
|
The `master` branch track current Firefox and GNOME stable.
|
||||||
for older versions, they are archived under version-specific git tags. Eg. if
|
|
||||||
you're using Firefox 57, switch to the `57` tag after cloning the repo:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
git checkout 57
|
|
||||||
```
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Extensions can no longer style UI elements, but we can still use good old
|
**TODO**
|
||||||
`userChrome.css` and `userContent.css` files. Just drop this repo to your
|
|
||||||
`chrome` directory:
|
|
||||||
|
|
||||||
1. Go to your Firefox profile's directory, if it's located in the default
|
|
||||||
location, this should work:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
cd ~/.mozilla/firefox/*.default
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Create a `chrome` directory if it doesn't exist.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
mkdir -p chrome
|
|
||||||
cd chrome
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Clone this repo to a subdirectory:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
git clone https://github.com/kurogetsusai/firefox-gnome-theme.git
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Create single-line user CSS files if non-existent or empty (at least one line
|
|
||||||
is needed for `sed`):
|
|
||||||
|
|
||||||
```sh
|
|
||||||
[[ -s userChrome.css ]] || echo >> userChrome.css
|
|
||||||
[[ -s userContent.css ]] || echo >> userContent.css
|
|
||||||
```
|
|
||||||
|
|
||||||
5. Import this theme at the beginning of the CSS files (all `@import`s must come
|
|
||||||
before any existing `@namespace` declarations):
|
|
||||||
|
|
||||||
```sh
|
|
||||||
sed -i '1s/^/@import "firefox-gnome-theme\/userChrome.css";\n/' userChrome.css
|
|
||||||
sed -i '1s/^/@import "firefox-gnome-theme\/userContent.css";\n/' userContent.css
|
|
||||||
```
|
|
||||||
|
|
||||||
6. Enable the theme in the `firefox-gnome-theme/userChrome.css` file. Open it
|
|
||||||
with a text editor and follow instructions to enable one of the theme variants.
|
|
||||||
You can also enable extra features here. Keep in mind this file might change in
|
|
||||||
future versions and your configuration will be lost. You can copy the `@import`s
|
|
||||||
you want to enable to the `userChrome.css` file directly in your `chrome`
|
|
||||||
directory if you want it to survive updates. Remember all `@import`s must be at
|
|
||||||
the top of the file, before other statements.
|
|
||||||
|
|
||||||
The GTK theme variant must match the variant you picked for this Firefox
|
|
||||||
theme, which means you must either enable (for the dark variant) or disable (for
|
|
||||||
the light one) global dark theme in GNOME Tweak Tools, or alternatively, you
|
|
||||||
can run Firefox with a specific variant without changing the global theme by
|
|
||||||
supplying the `GTK_THEME` variable like this:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
# for the dark theme
|
|
||||||
GTK_THEME=Adwaita:dark firefox
|
|
||||||
# for the light one
|
|
||||||
GTK_THEME=Adwaita:light firefox
|
|
||||||
```
|
|
||||||
|
|
||||||
7. Optionally you can enable styling of Firefox' internal pages in the
|
|
||||||
`userContent.css` file analogous to the `userChrome.css` file.
|
|
||||||
|
|
||||||
You might want to adjust your default link colors so they are more visible on
|
|
||||||
dark background, either drop the code below into your
|
|
||||||
`(firefox profile)/user.js` file or change them manually in `about:config`.
|
|
||||||
|
|
||||||
```js
|
|
||||||
user_pref("browser.active_color", "#cc1a1a");
|
|
||||||
user_pref("browser.anchor_color", "#0a8dff");
|
|
||||||
user_pref("browser.visited_color", "#0871cc");
|
|
||||||
user_pref("browser.display.background_color", "#2e3436");
|
|
||||||
user_pref("browser.display.foreground_color", "#ccc");
|
|
||||||
```
|
|
||||||
|
|
||||||
You can't get rid of the title bar for now (except for Fedora, where you can
|
|
||||||
enable CSD), but you will be able to do it in Firefox 60, when Firefox adds
|
|
||||||
client-side decoration support. For now you can use a GNOME extension like
|
|
||||||
[No Title Bar](https://extensions.gnome.org/extension/1267/no-title-bar/)
|
|
||||||
to hide it.
|
|
||||||
|
|
||||||
## Broken stuff
|
|
||||||
|
|
||||||
Icons might appear black where they should be white on some systems. I have no
|
|
||||||
idea why, but you can adjust them in the `ui/theme.css` file, look for
|
|
||||||
`filter: invert`.
|
|
||||||
|
|
||||||
I haven't finished styling the new tab page. I just replaced it with a
|
|
||||||
blank page, because I don't like all that clutter anyway, but feel free to
|
|
||||||
finish it yourself (my attempts are in the `userContent.css` file, look for
|
|
||||||
`about:newtab`).
|
|
||||||
|
|
||||||
Feel free to report issues here on GitHub and share your ideas if you know how
|
|
||||||
to fix them. Since I can't do everything alone, this project relies on
|
|
||||||
contributors, many existing features were added by our contributors, so don't
|
|
||||||
hesitate to become one of them!
|
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue