Não há nenhum lugar para ser encontrado.
A especificação 'index.theme' para o tema GTK + não parece mais ser documentada desde que o GNOME 2 foi preterido. Ambos os sites GTK + e GNOME Developer são essencialmente tendo zero documentação sobre 'index.theme' para o tema GTK +.
Documentação notável
A documentação mais antiga, Guia de administração do sistema do GNOME 2.4 Desktop , foi atualizada pela última vez em 2003 e que continha a especificação 'index.theme' possivelmente original para o tema GTK +.
[Desktop Entry]
Type=X-GNOME-Metatheme
Name=High Contrast Large
Name[es]=Alto contraste grande
Comment=Large black-on-white text and icons
Comment[es]=Textos e iconos grandes en negro sobre blanco
Encoding=UTF-8
[X-GNOME-Metatheme]
GtkTheme=HighContrastLargePrint
IconTheme=HighContrast
MetacityTheme=Atlanta
ApplicationFont=sans 18
Depois disso, algumas mudanças foram introduzidas na lista de discussão do GNOME datada de Julho de 2004 e Outubro de 2004 (somente este último é citado abaixo) . Infelizmente, não há documentação atualizada por desenvolvedores GTK + ou GNOME para ilustrar essas mudanças.
O gnome-theme-manager lida atualmente com os temas GTK, Metacity e Icon, mas poderia ser estendido para lidar com telas e planos de fundo (possível integração com o atual seletor de plano de fundo?).
Uma documentação relativamente nova, o formato Gnome Theme Package do Xfce, foi atualizada pela última vez em 2010. Isso incluiu mais variáveis no arquivo index.theme que não são encontradas na especificação original e refletem algumas das mudanças mencionadas na lista de discussão do GNOME.
[Desktop Entry]
Name=example theme
Type=X-GNOME-Metatheme
Comment=
Encoding=UTF-8
[X-GNOME-Metatheme]
GtkTheme=Gilouche
MetacityTheme=Gilouche
IconTheme=gnome
BackgroundImage=.local/share/wallpapers/Naptime.jpg
MonospaceFont=
ApplicationFont=
DesktopFont=
SoundTheme=
GtkColorScheme=
O fato de suporte foi encontrado em Obra / Documentação / GTK-Themes do Ubuntu Wiki, que mencionou uma das variáveis adicionais. Este material, no entanto, foi atualizado pela última vez em 2009.
Em seu arquivo index.theme, insira uma linha como "
BackgroundImage=/absolute/path/to/image.png" no cabeçalho X-GNOME-Metatheme. Para papéis de parede de temas empacotados deve ser assumido para ser colocado em/usr/share/wallpapers.
Para usar ou não
Se você estiver menos confiante em usar o exemplo fornecido na documentação desatualizada, sugiro copiar o arquivo index.theme do tema existente do GTK + e modificá-lo de acordo. O Ubuntu e os sabores oficiais que usam temas do GTK + incluem o arquivo em /usr/share/themes/[theme]/index.theme .
Outra maneira de usar o arquivo index.theme é não ter que escrever um.
Existe pelo menos um exemplo que demonstra que o tema GTK + personalizado pode fazer referência apenas ao arquivo existente usando o link simbólico . Dessa forma, é possível criar uma versão ligeiramente modificada do tema existente em menos tempo e sem ter que se preocupar com a especificação do arquivo index.theme .
TL; DR A documentação mais recente que você pode encontrar hoje, embora sem explicação, é Formato de Pacote de Tema do Gnome da Xfce. Ou simplesmente esqueça isso e siga o que outros temas fazem.