diff options
Diffstat (limited to 'desktop-themes/TraditionalOk/doc/README.mkd')
| -rw-r--r-- | desktop-themes/TraditionalOk/doc/README.mkd | 204 |
1 files changed, 204 insertions, 0 deletions
diff --git a/desktop-themes/TraditionalOk/doc/README.mkd b/desktop-themes/TraditionalOk/doc/README.mkd new file mode 100644 index 00000000..97c03726 --- /dev/null +++ b/desktop-themes/TraditionalOk/doc/README.mkd @@ -0,0 +1,204 @@ +<p lang="fr"><strong><a hreflang="fr" href="http://www.jpfleury.net/logiciels/clearlooks-phenix.php">Lire cette page en français.</a></strong></p> + +## Overview + +The Clearlooks-Phenix project (formerly known as Clearwaita) aims at creating a GTK3 port of Clearlooks, the default theme for Gnome 2. Style is also included for GTK2, Unity and for Metacity, Openbox and Xfwm4 window managers. + +Here are screenshots (if applicable, click to download the original image): + +<a href="http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/doc/exemple1.png"><img src="http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/doc/exemple1.png" alt="Screenshot of a Gnome 3 desktop (fallback mode) with the Clearlooks-Phenix theme" width="658" height="493" /></a> + +<img src="http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/doc/exemple2.png" alt="Screenshot of gedit 3 with the Clearlooks-Phenix theme" width="659" height="537" /> + +<a href="http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/doc/exemple3.png"><img src="http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/doc/exemple3.png" alt="Screenshot of GTK+ Widget Factory with the Clearlooks-Phenix theme" width="658" height="435" /></a> + +## Requirements + +- Requirements for Clearlooks-Phenix 1: packages `gtk2-engines` (if GTK2 applications are used) and `gnome-themes-standard`. + +- Requirements for Clearlooks-Phenix 2: packages `gtk2-engines` (if GTK2 applications are used), `gnome-themes-standard` and `gtk3-engines-unico`. + +- Requirements for Clearlooks-Phenix 3: package `gtk2-engines` (if GTK2 applications are used). + +## Installation + +Regardless of the installation method chosen, the theme must be selected once the installation is complete: + +- On Gnome: with [gnome-tweak-tool](https://live.gnome.org/GnomeTweakTool), by setting *Theme > Window theme* and *Theme > GTK+ theme*, or in a terminal: + + dconf write /org/gnome/desktop/wm/preferences/theme \'Clearlooks-Phenix\' + dconf write /org/gnome/desktop/interface/gtk-theme \'Clearlooks-Phenix\' + +- On Xfce: by going to *Settings > Appearence > Style* in the main menu for the GTK theme, and to *Settings > Window Manager > Style* for the Xfwm4 theme, or in a terminal: + + xfconf-query -s Clearlooks-Phenix -c xfwm4 -p /general/theme + xfconf-query -s Clearlooks-Phenix -c xsettings -p /Net/ThemeName + +### Manually + +**Manual installation ensures you get the latest version of the theme.** See below for other installation methods. + +- Download the appropriate version according to your situation: + + - for GTK 3.0 and 3.2: [download Clearlooks-Phenix 1](http://jpfleury.indefero.net/p/clearlooks-phenix/source/download/v1/); + + - for GTK 3.4: [download Clearlooks-Phenix 2](http://jpfleury.indefero.net/p/clearlooks-phenix/source/download/v2/). + + - for GTK 3.6 and newer: [download Clearlooks-Phenix 3](http://jpfleury.indefero.net/p/clearlooks-phenix/source/download/master/). + + To find your GTK version: + + - You can check in your package manager the version of the package `libgtk-3-0`. + + - If you use Ubuntu, here's a correspondence between its versions and those of GTK (for a default installation of Ubuntu): + + - Ubuntu 11.10: GTK 3.2 + - Ubuntu 12.04: GTK 3.4 + - Ubuntu 12.10: GTK 3.6 + +- Extract the archive. + +- Rename the extracted folder to `Clearlooks-Phenix`. + +- Copy the folder `Clearlooks-Phenix` in one of the following two locations: + + - `~/.themes/` for the current user; + + - `/usr/share/themes/` for all users, including style for programs ran with root privileges (e.g. Synaptic). + +### Arch Linux + +An [AUR package](https://aur.archlinux.org/packages.php?ID=60380) is maintained by eworm. + +### Debian + +The package [`clearlooks-phenix-theme`](http://packages.debian.org/sid/clearlooks-phenix-theme) can be installed on Debian unstable. + +### Gentoo + +The following `ebuild` can be used: + + http://bbgentoo.ilb.ru/repos/bbgentoo/bbgentoo_overlay/tags/current/x11-themes/clearlooks-phenix/clearlooks-phenix-2.0.10.ebuild + +### Ubuntu + +The package [`clearlooks-phenix-theme`](http://packages.ubuntu.com/quantal/clearlooks-phenix-theme) can be installed on Ubuntu 12.10 and newer. However, this package is not up-to-date, and the [PPA maintained by Andrew Shadura](https://launchpad.net/~andrewshadoura/+archive/clearlooks-phenix) can be used instead. + +## Configuration + +### Wallpaper + +The wallpaper used for the Gnome 3 desktop screenshot is available in the folder `wallpapers`. + +### Icons + +The icon theme used for the same screenshot is Mist, installed with the package [`gnome-themes`](http://packages.ubuntu.com/oneiric/gnome-themes), under LGPL. However, this package is no longer available with last Ubuntu versions. Here's an easy way to install Mist: + +- [Download the archive of the Mist icon theme.](http://www.jpfleury.net/site/fichiers/Mist.tar) + +- Extract the archive. + +- Copy the folder `Mist` in one of the following two locations: + + - `~/.icons/` for the current user; + + - `/usr/share/icons/` for all users. + +- Then, choose Mist: + + - on Gnome: with gnome-tweak-tool by setting *Theme > Icon theme*; + + - on Xfce: by going to *Settings > Appearence > Icons* in the main menu. + +Also, color schemes were made by DDZ to fit with Clearlooks-Phenix: + +- [Gnome-Colors-Clearlooks](http://opendesktop.org/content/show.php?content=151907), color scheme for the icon theme Gnome-Colors; + +- [Humanities-Clearlooks](http://opendesktop.org/content/show.php?content=151908), color scheme for the icon theme Humanities. + +- [KDE3-Clearlooks-Colors](http://opendesktop.org/content/show.php?content=151994), color scheme for KDE 3. + +- [KDE4-Clearlooks-Colors](http://opendesktop.org/content/show.php?content=151993), color scheme for KDE 4. + +### Desktop managed by Nautilus + +By default, the font color on a desktop managed by Nautilus is black. To set it to white, open the file `gtk-3.0/applications.css` with a text editor, find the code relative to Nautilus: + + /************ + * Nautilus * + ************/ + + /* + COMMENTED + CSS + CODE + */ + +and uncomment it, as follows: + + /************ + * Nautilus * + ************/ + + UNCOMMENTED + CSS + CODE + +To get a custom color, change the color directly in the file `gtk-3.0/applications.css`. + +### Color variants + +From Clearlooks-Phenix 2, it's very easy to create color variants of the GTK3 theme. Only a few color declarations must be changed in the file `gtk-3.0/gtk-variant.css`. + +About button borders, they come from SVG files. [Inkscape](http://inkscape.org/) can be used to modify them. For more details, see the screencast [Utiliser Inkscape pour modifier la couleur de la bordure d'un bouton](http://www.youtube.com/watch?v=DWJHDS5hQsw). A Bash script is also shipped with Clearlooks-Phenix to assist the modification of SVG and PNG files. To use it, copy the file `doc/images.sh.txt`, paste it in the root folder of your development theme (same emplacement as the file `index.theme`) and rename it `images.sh`. Then, change variables in the first section of the file according to the color variant desired and run the script in a terminal (`bash images.sh`). The package `imagemagick` is required. + +### Window buttons layout + +If after installing or updating Ubuntu, the window buttons are on the left side, but you want them to the right, run the following command in a terminal: + + gconftool-2 --set /apps/metacity/general/button_layout --type string ":minimize,maximize,close" + +## Development + +Last version: 3.0.13 (2012-12-09) + +Git is used for revision control. [Repository can be browsed online or cloned.][git] + +Clearlooks-Phenix has an [issue tracker], on which bug reports and feature requests can be submitted. Comments can also be posted on the webpage [Clearlooks-Phenix on GNOME-Look.org][gnome-look]. + +[git]: http://jpfleury.indefero.net/p/clearlooks-phenix/source/tree/master/ +[issue tracker]: http://jpfleury.indefero.net/p/clearlooks-phenix/issues/ +[gnome-look]: http://gnome-look.org/content/show.php?content=145210 + +## License + +Author: Jean-Philippe Fleury <[email protected]> +Copyright © 2011-2012 Jean-Philippe Fleury + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see <http://www.gnu.org/licenses/>. + +### Third-party code + +- Adwaita theme, from the package [`gnome-themes-standard`](http://packages.ubuntu.com/oneiric/gnome-themes-standard), under LGPL. + +- File `gtk-2.0/gtkrc`, from the package [`gtk2-engines`](http://packages.ubuntu.com/oneiric/gtk2-engines), under LGPL. + +- File `metacity-1/metacity-theme-1.xml`, from the package [`gnome-themes-selected`](http://packages.ubuntu.com/oneiric/gnome-themes-selected), under LGPL. + +- File `openbox-3/themerc`, from the package [`openbox`](http://packages.ubuntu.com/oneiric/openbox), under GPL. + +- [Clearlooks XFWM4](http://xfce-look.org/content/show.php/Clearlooks+for+XFWM4?content=137055) theme, under GPL. + +- Files in `wallpapers`, based on an [image from volvoguy](http://gnome-look.org/content/show.php?content=22210), under GPL. + |