Skip to content

Commit

Permalink
Version 2.7.0
Browse files Browse the repository at this point in the history
  • Loading branch information
luigifab committed Jun 6, 2023
1 parent 0617a20 commit f7dbc2e
Show file tree
Hide file tree
Showing 81 changed files with 1,711 additions and 950 deletions.
2 changes: 1 addition & 1 deletion FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1 +1 @@
custom: ["https://gandi.link/f/4b904048", "https://ekwateur.fr/?parrain=EKW001147103"]
custom: ["https://fr.tipeee.com/luigifab", "https://gandi.link/f/4b904048", "https://ekwateur.fr/?parrain=EKW001147103", "https://www.ebuyclub.com/?parrain=ebc4"]
58 changes: 33 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,50 +22,58 @@ GTK 4\
[![Preview with GTK 4 - RTL - Main window](images/thumbs/gtk4-rtl.png?raw=true)](images/gtk4-rtl.png?raw=true)
[![Preview with GTK 4 - RTL - Menu](images/thumbs/gtk4-rtl-menu.png?raw=true)](images/gtk4-rtl-menu.png?raw=true)

Theme used for the screenshots is available [here](https://github.com/luigifab/human-theme). Pango 1.42 for screenshots with GTK 2 and 3, Pango 1.48 for screenshots with GTK 4.
Theme used for the screenshots is available [here](https://github.com/luigifab/human-theme). For screenshots: Pango 1.42 with GTK 2.24 and 3.24.23-classic, Pango 1.50 with GTK 4.8.

* Some options are available from command line (read -h).
* The options menu allow to run some standard dialogs.
* The minus toolbar button allow to switch text direction.
* The plus toolbar button allow to show or hide: arrows on notebooks, text and marks on progress bars and scales.
* The refresh toolbar button and the refresh menu allow to reload the current theme (like the *sighup* signal).
* The menu keyboard shortcuts can be updated on hover (GTK 2.24 and 3.x, *gtk-can-change-accels*).
* The tabs of notebooks are scrollable with mouse (GTK 3.x and 4.x, *gtk-scroll-tabs*).
* For Ubuntu, the menu keyboard shortcuts can be updated on hover with: `export UBUNTU_MENUPROXY= && awf-gtk3`
## Tricks

* Some options are available from command line (read `-h` or man page).
* Options menu allow to run some standard dialogs.
* System and user themes menu allow to set current theme.
* Text direction menu allow to change text direction (LTR/RTL).
* Plus/minus toolbar buttons allow to show or hide: notebooks arrows, text and marks on progress bars and scales.
* Refresh toolbar button and refresh menu item allow to reload the current theme (like `SIGHUP` signal).
* Menu keyboard shortcuts can be updated on hover (GTK 2.24 and 3.x, *gtk-can-change-accels*).
* Notebooks tabs are scrollable (GTK 3.x and 4.x, *gtk-scroll-tabs*, like with GTK 2.24).
* With Ubuntu, menu keyboard shortcuts can also be updated on hover with: `UBUNTU_MENUPROXY= awf-gtk3`

## Installation

It require **GTK 2.24+** or **GTK 3.0+** *(including 3.24)* or **GTK 4.0+**, and *GLIB 2.28+*.

* Debian and Ubuntu: `sudo apt install awf-gtk2 awf-gtk3 awf-gtk4` (or via [PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages))
#### Installation for Debian and Ubuntu

* `sudo apt install awf-gtk2 awf-gtk3 awf-gtk4`

* Fedora: `sudo dnf install awf-gtk2 awf-gtk3 awf-gtk4`
#### Installation for Fedora

* openSUSE: `sudo zypper install awf-gtk2 awf-gtk3 awf-gtk4`
* `sudo dnf install awf-gtk2 awf-gtk3 awf-gtk4`

* The *build.sh* script will compile the program with all major GTK versions available.
#### Installation for openSUSE

* The *debian-gtkx/deb.sh* scripts will compile the program and create packages for Debian and Ubuntu.
* `sudo zypper install awf-gtk2 awf-gtk3 awf-gtk4`

* The *fedora-gtkx/rpm.sh* scripts will compile the program and create packages for Fedora.
#### Building from source

* The *opensuse-gtkx/rpm.sh* scripts will compile the program and create packages for openSUSE.
* To compile the program with all major GTK versions available, run: `build.sh`
* To compile the program and create DEB packages for Debian and Ubuntu, run: `debian-gtkx/deb.sh`
* To compile the program and create RPM package for Fedora, run: `fedora-gtkx/rpm.sh`
* To compile the program and create RPM package for openSUSE, run: `opensuse-gtkx/rpm.sh`

## PPA
#### Alternative installation for Debian and Ubuntu

Installation for Debian and Ubuntu with [PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages):
```bash
# https://launchpad.net/~luigifab/+archive/ubuntu/packages
sudo add-apt-repository ppa:luigifab/packages
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4
# or
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys FFE5BD439356DF7D
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu hirsute main" | sudo tee -a /etc/apt/sources.list
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4
# or
sudo wget -O /etc/apt/trusted.gpg.d/luigifab.gpg https://www.luigifab.fr/apt.gpg
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu hirsute main" | sudo tee -a /etc/apt/sources.list
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4
```
Expand All @@ -80,16 +88,16 @@ pub rsa4096 2020-10-31 [SC]

## Dev

To reload theme when source files change, you can use [Entr](https://github.com/eradman/entr) with the *sighup* signal:
To reload theme when source files change, you can use [Entr](https://github.com/eradman/entr) with the `SIGHUP` signal:
```
sudo apt install entr or sudo dnf install entr or sudo zypper install entr or ...
ls ~/.themes/yourtheme/gtk-3*/*.css | entr killall -s SIGHUP awf-gtk3
```

## Copyright

- Current version: 2.6.0 (09/09/2021)
- Compatibility: GTK 2.24 / 3.0 / 3.2 / 3.4 / 3.6 / 3.8 / 3.10 / 3.12 / 3.14 / 3.16 / 3.18 / 3.20 / 3.22 / 3.24 / 4.0 / 4.2
- Current version: 2.7.0 (06/06/2023)
- Compatibility: GTK 2.24 / 3.0..3.24 / 4.0 / 4.2 / 4.4 / 4.6 / 4.8 / 4.10
- Translations: English (en), French (fr)
- Links: [luigifab.fr](https://www.luigifab.fr/gtk/awf-extended) - [github.com](https://github.com/luigifab/awf-extended)\
[Debian awf-gtk3.deb](https://packages.debian.org/awf-gtk)
Expand All @@ -100,8 +108,8 @@ ls ~/.themes/yourtheme/gtk-3*/*.css | entr killall -s SIGHUP awf-gtk3
[openSUSE awf-gtk2.rpm](https://software.opensuse.org/package/awf-gtk2)
; [openSUSE awf-gtk3.rpm](https://software.opensuse.org/package/awf-gtk3)
; [openSUSE awf-gtk4.rpm](https://software.opensuse.org/package/awf-gtk4)\
[Ubuntu awf-gtk3.deb](https://packages.ubuntu.com/pkg/awf-gtk)
; [Ubuntu awf-gtk4.deb](https://packages.ubuntu.com/pkg/awf-gtk)\
[Ubuntu awf-gtk3.deb](https://packages.ubuntu.com/awf-gtk)
; [Ubuntu awf-gtk4.deb](https://packages.ubuntu.com/awf-gtk)\
[Ubuntu PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages)

This program is provided under the terms of the **GNU GPLv3+** license.\
Expand Down
6 changes: 3 additions & 3 deletions configure.ac
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
AC_INIT([A widget factory], [2.6.0])
AC_INIT([A widget factory], [2.7.0])
AC_CONFIG_SRCDIR([src/awf.c])

AM_INIT_AUTOMAKE
Expand All @@ -25,8 +25,8 @@ AC_SUBST(GTK2_LIBS)
AC_SUBST(GTK2_SUFFIX)

AC_CONFIG_FILES([
Makefile
src/Makefile
Makefile
src/Makefile
])

AC_OUTPUT
43 changes: 43 additions & 0 deletions debian-gtk/awf-gtk2.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.Dd 01/01/22
.Dt AWF 1
.Os Linux
.Sh NAME
.Nm awf-gtk2
.Nd Theme preview application for GTK 2.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl v
.Op Fl l
.Op Fl n
.Op Fl t Ar theme
.Op Fl s Ar filename
.Op Fl -ltr
.Op Fl -rtl
.Sh DESCRIPTION
A widget factory is a theme preview application for GTK. It displays the
various widget types provided by GTK in a single window allowing to see
the visual effect of the applied theme.
.Bl -tag -width "-s filename"
.It Fl h
Show help.
.It Fl v
Show version number.
.It Fl l
List available themes.
.It Fl n
Don't start spinners.
.It Fl t Ar theme
Run with the specified theme.
.It Fl s Ar filename
Run and save a png screenshot on SIGHUP.
.It Fl -ltr
Start with text from left to right (Left-To-Right).
.It Fl -rtl
Start with text from right to left (Right-To-Left).
.El
.Sh FILES
.Bl -tag -width "/home/user/.awf-gtk-accels" -compact
.It Pa /home/user/.awf-gtk-accels
Configuration of keyboard shortcuts.
.El
43 changes: 43 additions & 0 deletions debian-gtk/awf-gtk2.fr.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.Dd 01/01/22
.Dt AWF 1
.Os Linux
.Sh NAME
.Nm awf-gtk2
.Nd Application d'aperçu de thème pour GTK 2.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl v
.Op Fl l
.Op Fl n
.Op Fl t Ar theme
.Op Fl s Ar filename
.Op Fl -ltr
.Op Fl -rtl
.Sh DESCRIPTION
La fabrique à widgets est une application d'aperçu de thème pour GTK. Elle
affiche les différents types de widgets fournis par GTK dans une seule
fenêtre permettant de voir l'effet visuel du thème appliqué.
.Bl -tag -width "-s filename"
.It Fl h
Affiche l'aide.
.It Fl v
Affiche le numéro de version.
.It Fl l
Liste les thèmes disponibles.
.It Fl n
Ne démarre pas les spinners.
.It Fl t Ar theme
Démarre avec le thème spécifié.
.It Fl s Ar filename
Démarre et enregistre une capture d'écran png lors du SIGHUP.
.It Fl -ltr
Démarre avec le texte de gauche à droite (Left-To-Right).
.It Fl -rtl
Démarre avec le texte de droite à gauche (Right-To-Left).
.El
.Sh FILES
.Bl -tag -width "/home/user/.awf-gtk-accels" -compact
.It Pa /home/user/.awf-gtk-accels
Configuration des raccourcis clavier.
.El
2 changes: 2 additions & 0 deletions debian-gtk/awf-gtk2.manpages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
debian/awf-gtk2.1
debian/awf-gtk2.fr.1
43 changes: 43 additions & 0 deletions debian-gtk/awf-gtk3.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.Dd 01/01/22
.Dt AWF 1
.Os Linux
.Sh NAME
.Nm awf-gtk3
.Nd Theme preview application for GTK 3.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl v
.Op Fl l
.Op Fl n
.Op Fl t Ar theme
.Op Fl s Ar filename
.Op Fl -ltr
.Op Fl -rtl
.Sh DESCRIPTION
A widget factory is a theme preview application for GTK. It displays the
various widget types provided by GTK in a single window allowing to see
the visual effect of the applied theme.
.Bl -tag -width "-s filename"
.It Fl h
Show help.
.It Fl v
Show version number.
.It Fl l
List available themes.
.It Fl n
Don't start spinners.
.It Fl t Ar theme
Run with the specified theme.
.It Fl s Ar filename
Run and save a png screenshot on SIGHUP.
.It Fl -ltr
Start with text from left to right (Left-To-Right).
.It Fl -rtl
Start with text from right to left (Right-To-Left).
.El
.Sh FILES
.Bl -tag -width "/home/user/.awf-gtk-accels" -compact
.It Pa /home/user/.awf-gtk-accels
Configuration of keyboard shortcuts.
.El
43 changes: 43 additions & 0 deletions debian-gtk/awf-gtk3.fr.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.Dd 01/01/22
.Dt AWF 1
.Os Linux
.Sh NAME
.Nm awf-gtk3
.Nd Application d'aperçu de thème pour GTK 3.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl v
.Op Fl l
.Op Fl n
.Op Fl t Ar theme
.Op Fl s Ar filename
.Op Fl -ltr
.Op Fl -rtl
.Sh DESCRIPTION
La fabrique à widgets est une application d'aperçu de thème pour GTK. Elle
affiche les différents types de widgets fournis par GTK dans une seule
fenêtre permettant de voir l'effet visuel du thème appliqué.
.Bl -tag -width "-s filename"
.It Fl h
Affiche l'aide.
.It Fl v
Affiche le numéro de version.
.It Fl l
Liste les thèmes disponibles.
.It Fl n
Ne démarre pas les spinners.
.It Fl t Ar theme
Démarre avec le thème spécifié.
.It Fl s Ar filename
Démarre et enregistre une capture d'écran png lors du SIGHUP.
.It Fl -ltr
Démarre avec le texte de gauche à droite (Left-To-Right).
.It Fl -rtl
Démarre avec le texte de droite à gauche (Right-To-Left).
.El
.Sh FILES
.Bl -tag -width "/home/user/.awf-gtk-accels" -compact
.It Pa /home/user/.awf-gtk-accels
Configuration des raccourcis clavier.
.El
2 changes: 2 additions & 0 deletions debian-gtk/awf-gtk3.manpages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
debian/awf-gtk3.1
debian/awf-gtk3.fr.1
43 changes: 43 additions & 0 deletions debian-gtk/awf-gtk4.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.Dd 01/01/22
.Dt AWF 1
.Os Linux
.Sh NAME
.Nm awf-gtk4
.Nd Theme preview application for GTK 4.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl v
.Op Fl l
.Op Fl n
.Op Fl t Ar theme
.Op Fl s Ar filename
.Op Fl -ltr
.Op Fl -rtl
.Sh DESCRIPTION
A widget factory is a theme preview application for GTK. It displays the
various widget types provided by GTK in a single window allowing to see
the visual effect of the applied theme.
.Bl -tag -width "-s filename"
.It Fl h
Show help.
.It Fl v
Show version number.
.It Fl l
List available themes.
.It Fl n
Don't start spinners.
.It Fl t Ar theme
Run with the specified theme.
.It Fl s Ar filename
Run and save a png screenshot on SIGHUP.
.It Fl -ltr
Start with text from left to right (Left-To-Right).
.It Fl -rtl
Start with text from right to left (Right-To-Left).
.El
.Sh FILES
.Bl -tag -width "/home/user/.awf-gtk-accels" -compact
.It Pa /home/user/.awf-gtk-accels
Configuration of keyboard shortcuts.
.El
Loading

0 comments on commit f7dbc2e

Please sign in to comment.