# Gtk Alt Documentation

> The GTK theming reference I wished existed. CSS selectors, widget hierarchy, inspector tricks, and real examples. Everything you need to build a Linux desktop theme from zero.

- URL: https://mandalsuraj.com/blog/gtk-theming-guide
- Author: Suraj Mandal (https://mandalsuraj.com)
- Published: 2017-02-24
- Project date: 2017-03-15
- Tags: linux, theming, docs-as-code, hugo, static-site, css, webdev
- Source: https://github.com/surajmandalcell/Gtk-Theming-Guide
- Docs site: https://gtkthemingguide.surajmandal.in

![Gtk Alt Documentation cover](https://mandalsuraj.com/images/blog/gtk-theming-guide/cover.png)

GTK theming facts were spread across forums, source trees, and tests. I put the useful parts into one **Hugo reference site**.

## What The Guide Covers

- GTK Inspector setup and theme search paths.
- GTK 2 and GTK 3 differences.
- CSS imports, selectors, and widget nodes.
- Icon theme folders and cache refreshes.
- Common file permission errors.

The project grew through focused updates to setup pages, selector notes, tools, FAQs, and site formatting.

## Visual Proof

![Current GTK theming guide home page](https://mandalsuraj.com/images/blog/gtk-theming-guide/Gtk-theming-guide.png)

### Original Site

![Original GTK theming guide from 2017](https://mandalsuraj.com/images/blog/gtk-theming-guide/main.png)