From 5b8685740b7ce7366aad559802cc51d7ccfceacb Mon Sep 17 00:00:00 2001 From: Horst3180 Date: Tue, 29 Sep 2015 16:39:07 +0200 Subject: update READMEs --- README.md | 14 ++++++++++---- common/cinnamon/README | 19 ------------------- common/cinnamon/README.md | 20 ++++++++++++++++++++ common/gnome-shell/3.14/README | 19 ------------------- common/gnome-shell/3.14/README.md | 20 ++++++++++++++++++++ common/gnome-shell/3.16/README | 19 ------------------- common/gnome-shell/3.16/README.md | 20 ++++++++++++++++++++ common/gnome-shell/3.18/README | 19 ------------------- common/gnome-shell/3.18/README.md | 20 ++++++++++++++++++++ common/gtk-2.0/README.md | 16 ++++++++++++++++ common/gtk-3.0/3.14/README | 19 ------------------- common/gtk-3.0/3.14/README.md | 31 +++++++++++++++++++++++++++++++ common/gtk-3.0/3.16/README | 19 ------------------- common/gtk-3.0/3.16/README.md | 31 +++++++++++++++++++++++++++++++ common/gtk-3.0/3.18/README | 19 ------------------- common/gtk-3.0/3.18/README.md | 31 +++++++++++++++++++++++++++++++ 16 files changed, 199 insertions(+), 137 deletions(-) delete mode 100644 common/cinnamon/README create mode 100644 common/cinnamon/README.md delete mode 100644 common/gnome-shell/3.14/README create mode 100644 common/gnome-shell/3.14/README.md delete mode 100644 common/gnome-shell/3.16/README create mode 100644 common/gnome-shell/3.16/README.md delete mode 100644 common/gnome-shell/3.18/README create mode 100644 common/gnome-shell/3.18/README.md create mode 100644 common/gtk-2.0/README.md delete mode 100644 common/gtk-3.0/3.14/README create mode 100644 common/gtk-3.0/3.14/README.md delete mode 100644 common/gtk-3.0/3.16/README create mode 100644 common/gtk-3.0/3.16/README.md delete mode 100644 common/gtk-3.0/3.18/README create mode 100644 common/gtk-3.0/3.18/README.md diff --git a/README.md b/README.md index e0ce2b0..de69fcf 100644 --- a/README.md +++ b/README.md @@ -31,11 +31,11 @@ Arc is a flat theme with transparent elements for GTK 3, GTK 2 and Gnome-Shell. Main distributions that meet these requirements are * Arch Linux and Arch Linux based distros -* Ubuntu 15.04 +* Ubuntu 15.04 and 15.10 (**Ubuntu 14.04 and 14.10 are not supported**) * elementary OS Freya * Debian Jessie, Testing or Unstable * Gentoo -* Fedora 21 and 22 +* Fedora 21, 22 and 23 * OpenSuse 13.2 and Tumbleweed Derivatives of these distributions should work, aswell. @@ -57,10 +57,11 @@ Prebuilt packages for Ubuntu, Debian, Fedora and openSUSE are available at http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme **Note:** elementary OS Freya users can install the package for Ubuntu 15.04 -Arch Linux users can install the theme from the AUR +-- -https://aur.archlinux.org/packages/gtk-theme-arc-git/ +Arch Linux users can install the theme from the AUR +https://aur.archlinux.org/packages/gtk-theme-arc-git/ **Note:** If you're having trouble with the AUR package please email the package maintainer at zach@zach-adams.com before creating an issue. **Manual Installation** @@ -132,6 +133,11 @@ Now open the Plank preferences window by executing `plank --preferences` from a ### Troubleshooting +If you have Ubuntu with a newer GTK/Gnome version than the one included by default (i.e Ubuntu 14.04 with GTK 3.14 or Ubuntu 15.04 with GTK 3.16, etc.) the prebuilt packages don't work properly and you have to install the theme manually as described above. +This is also true for other distros with a different GTK/Gnome version than the one included by default + +-- + If you get artifacts like black or invisible backgrounds under Unity, disable overlay scrollbars with gsettings set com.canonical.desktop.interface scrollbar-mode normal diff --git a/common/cinnamon/README b/common/cinnamon/README deleted file mode 100644 index f040030..0000000 --- a/common/cinnamon/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/cinnamon/README.md b/common/cinnamon/README.md new file mode 100644 index 0000000..b717ab9 --- /dev/null +++ b/common/cinnamon/README.md @@ -0,0 +1,20 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + diff --git a/common/gnome-shell/3.14/README b/common/gnome-shell/3.14/README deleted file mode 100644 index f040030..0000000 --- a/common/gnome-shell/3.14/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gnome-shell/3.14/README.md b/common/gnome-shell/3.14/README.md new file mode 100644 index 0000000..b717ab9 --- /dev/null +++ b/common/gnome-shell/3.14/README.md @@ -0,0 +1,20 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + diff --git a/common/gnome-shell/3.16/README b/common/gnome-shell/3.16/README deleted file mode 100644 index f040030..0000000 --- a/common/gnome-shell/3.16/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gnome-shell/3.16/README.md b/common/gnome-shell/3.16/README.md new file mode 100644 index 0000000..b717ab9 --- /dev/null +++ b/common/gnome-shell/3.16/README.md @@ -0,0 +1,20 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + diff --git a/common/gnome-shell/3.18/README b/common/gnome-shell/3.18/README deleted file mode 100644 index f040030..0000000 --- a/common/gnome-shell/3.18/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gnome-shell/3.18/README.md b/common/gnome-shell/3.18/README.md new file mode 100644 index 0000000..b717ab9 --- /dev/null +++ b/common/gnome-shell/3.18/README.md @@ -0,0 +1,20 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + diff --git a/common/gtk-2.0/README.md b/common/gtk-2.0/README.md new file mode 100644 index 0000000..48c45f1 --- /dev/null +++ b/common/gtk-2.0/README.md @@ -0,0 +1,16 @@ +#### Editing the theme + +* The Colors and includes are defined in `gtkrc`, `gtkrc-dark` and `gtkrc-darker` for each theme variant. +* `main.rc` contains the major part of the theme +* `panel.rc` contains the panel styling for XFCE and Mate +* `apps.rc` contains some application specific rules + +Because this theme is heavily based on the pixmap engine, a lot of the styling comes from the images in the `assets` and `assets-dark` folders. Don't edit these images directly. Instead do the following + +* Open the `assets.svg` or `assets-dark.svg` file in inkscape. Each object in the .svg file corresponds to an image in the `assets` and `assets-dark` folder. + +* Find the object you want to edit and make your changes. Important: Don't change the obejct id. + +* Save `assets.svg` or `assets-dark.svg` and delete the images corresponding to the edited .svg objects from the `assets` or `assets-dark` folder (or just delete everything in the `assets` or `assets-dark` folder). + +* Run `./render-assets.sh` or `./render-dark-assets.sh` from a terminal. diff --git a/common/gtk-3.0/3.14/README b/common/gtk-3.0/3.14/README deleted file mode 100644 index f040030..0000000 --- a/common/gtk-3.0/3.14/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gtk-3.0/3.14/README.md b/common/gtk-3.0/3.14/README.md new file mode 100644 index 0000000..af100ea --- /dev/null +++ b/common/gtk-3.0/3.14/README.md @@ -0,0 +1,31 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + +-- + +#### Editing the images in the `assets` folder + +* Open the `assets.svg` file in inkscape. Each object in the .svg file corresponds to an image in the `assets` folder. + +* Find the object you want to edit and make your changes. Important: Don't change the obejct id. + +* Save `assets.svg` and delete the images corresponding to the edited .svg objects from the `assets` folder (or just delete everything in the `assets` folder). + +* Run `./render-assets.sh` from a terminal. diff --git a/common/gtk-3.0/3.16/README b/common/gtk-3.0/3.16/README deleted file mode 100644 index f040030..0000000 --- a/common/gtk-3.0/3.16/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gtk-3.0/3.16/README.md b/common/gtk-3.0/3.16/README.md new file mode 100644 index 0000000..af100ea --- /dev/null +++ b/common/gtk-3.0/3.16/README.md @@ -0,0 +1,31 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + +-- + +#### Editing the images in the `assets` folder + +* Open the `assets.svg` file in inkscape. Each object in the .svg file corresponds to an image in the `assets` folder. + +* Find the object you want to edit and make your changes. Important: Don't change the obejct id. + +* Save `assets.svg` and delete the images corresponding to the edited .svg objects from the `assets` folder (or just delete everything in the `assets` folder). + +* Run `./render-assets.sh` from a terminal. diff --git a/common/gtk-3.0/3.18/README b/common/gtk-3.0/3.18/README deleted file mode 100644 index f040030..0000000 --- a/common/gtk-3.0/3.18/README +++ /dev/null @@ -1,19 +0,0 @@ -This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. - -How to edit this theme: - -1. Install `nodejs` and `npm` - -2. Install `gulp` - - sudo npm install --global gulp - -3. Execute the following from the directory containing `gulpfile.js` - - npm install - -4. Edit the sass/*.scss files - -5. Regenerate the .css files by executing from the directory containing `gulpfile.js` - - gulp diff --git a/common/gtk-3.0/3.18/README.md b/common/gtk-3.0/3.18/README.md new file mode 100644 index 0000000..af100ea --- /dev/null +++ b/common/gtk-3.0/3.18/README.md @@ -0,0 +1,31 @@ +This theme uses libsass/gulp to process the sass/*.scss. Never edit any of the .css files manually. + +#### Editing the theme + +* Install `nvm` (https://github.com/creationix/nvm) + +* Install `gulp` + + npm i -g gulp + +* Execute the following from the directory containing `gulpfile.js` + + npm i + +* Edit the sass/*.scss files + +* Regenerate the .css files by executing from the directory containing `gulpfile.js` + + gulp + +-- + +#### Editing the images in the `assets` folder + +* Open the `assets.svg` file in inkscape. Each object in the .svg file corresponds to an image in the `assets` folder. + +* Find the object you want to edit and make your changes. Important: Don't change the obejct id. + +* Save `assets.svg` and delete the images corresponding to the edited .svg objects from the `assets` folder (or just delete everything in the `assets` folder). + +* Run `./render-assets.sh` from a terminal. -- cgit v1.2.3