LinuxMint.com.ru

Summary
-------

* Do not edit the CSS directly, edit the source SCSS files
* To be able to use the latest/adequate version of sass, install sassc
* The configure script will detect whether or not you have sassc installed;
if you do, it will regenerate the CSS every time you modify the SCSS files.

How to tweak the theme
----------------------

Adwaita is a complex theme, so to keep it maintainable it's written and
processed in SASS. The generated CSS is then transformed into a gresource file
during gtk build and used at runtime in a non-legible or editable form.

It is very likely your change will happen in the _common.scss file. That's where
all the widget selectors are defined. Here's a rundown of the "supporting"
stylesheets, that are unlikely to be the right place for a drive by stylesheet
fix:

_colors.scss - global color definitions. We keep the number of defined
colors to a necessary minimum, most colors are derived
from a handful of basics. It covers both the light variant
and the dark variant.

_colors-public.scss - SCSS colors exported through gtk to allow for 3rd party
apps color mixing.

_drawing.scss - drawing helper mixings/functions to allow easier
definition of widget drawing under specific context. This
is why Adwaita isn't 15000 LOC.

_common.scss - actual definitions of style for each widget. This is
where you are likely to add/remove your changes.

You can read about SASS at http://sass-lang.com/documentation/. Once you make
your changes to the _common.scss file, GTK+ will rebuild the CSS files.

Резюме
-------

* Не редактируйте CSS напрямую, отредактируйте исходные файлы SCSS
* Чтобы использовать последнюю / адекватную версию sass, установите sassc
* Сценарий configure определит, установлен ли ваш sassc или нет;
если вы это сделаете, он будет восстанавливать CSS каждый раз, когда вы модифицируете файлы SCSS.

Как настроить тему
----------------------

Adwaita - сложная тема, поэтому, чтобы поддерживать ее, она написана и
обрабатывается в SASS. Сгенерированный CSS затем преобразуется в файл gresource
во время сборки gtk и используется во время выполнения в неразборчивой или редактируемой форме.

Скорее всего, ваши изменения произойдут в файле _common.scss. Вот где
все селекторы виджета определены. Вот краткое изложение «поддержки»,
таблицы стилей, которые вряд ли будут подходящим местом для диска по таблице стилей
исправить:

_colors.scss - глобальные определения цвета. Мы сохраняем число определенных
цвета до необходимого минимума, большинство цветов выводятся
из горстки основ. Он охватывает как легкий вариант
и темный вариант.

_colors-public.scss - цвета SCSS, экспортируемые через gtk, чтобы разрешить сторонние
смешивание цветов приложений.

_drawing.scss - вспомогательные смешения / функции рисования для упрощения
определение чертежа виджета в определенном контексте. Эта
почему Adwaita не является 15000 LOC.

_common.scss - фактические определения стиля для каждого виджета. Это
где вы, вероятно, будете добавлять / удалять свои изменения.

Вы можете прочитать о SASS по адресу http://sass-lang.com/documentation/. Как только вы сделаете
ваши изменения в файле _common.scss, GTK + перестроит файлы CSS.

General information

GTK+ is a multi-platform toolkit for creating graphical user interfaces. Offering a complete set of widgets, GTK+ is suitable for projects ranging from small one-off projects to complete application suites.

GTK+ is free software and part of the GNU Project. However, the licensing terms for GTK+, the GNU LGPL, allow it to be used by all developers, including those developing proprietary software, without any license fees or royalties.

The official download location

https://download.gnome.org/sources/gtk+

The official web site

https://www.gtk.org

The official developers blog

https://blog.gtk.org

Information about mailing lists can be found at

http://www.gtk.org/mailing-lists.php

Nightly documentation can be found at

Gtk: https://gnome.pages.gitlab.gnome.org/gtk/gtk/
Gdk: https://gnome.pages.gitlab.gnome.org/gtk/gdk/
Gsk: https://gnome.pages.gitlab.gnome.org/gtk/gsk/

Building and installing

In order to build GTK+ you will need:

a C99 compatible compiler
Python 3
Meson
Ninja

You will also need various dependencies, based on the platform you are building for:

GLib
GdkPixbuf
GObject-Introspection
Cairo
Pango
Epoxy
Graphene
ATK
Xkb-common

If you are building the X11 backend, you will also need:

Xlib, and the following X extensions:
xrandr
xrender
xi
xext
xfixes
xcursor
xdamage
xcomposite
atk-bridge-2.0

If you are building the Wayland backend, you will also need:

Wayland-client
Wayland-protocols
Wayland-cursor
Wayland-EGL

Once you have all the necessary dependencies, you can build GTK+ by using Meson:

$ meson _build .
$ cd _build
$ ninja

You can run the test suite using:

$ meson test

And, finally, you can install GTK+ using:

$ sudo ninja install

Complete information about installing GTK+ and related libraries can be found in the file:

docs/reference/gtk/html/gtk-building.html

Or online
How to report bugs

Bugs should be reported on the issues page.

In the bug report please include:

Information about your system. For instance:
which version of GTK+ you are using
what operating system and version
for Linux, which distribution
if you built GTK+, the list of options used to configure the build

And anything else you think is relevant.

How to reproduce the bug.

If you can reproduce it with one of the demo applications that are built in the demos/ subdirectory, on one of the test programs that are built in the tests/ subdirectory, that will be most convenient. Otherwise, please include a short test program that exhibits the behavior. As a last resort, you can also provide a pointer to a larger piece of software that can be downloaded.

If the bug was a crash, the exact text that was printed out when the crash occurred.

Further information such as stack traces may be useful, but is not necessary.

Release notes

The release notes for GTK+ are part of the migration guide in the API reference. See:

3.x release notes
4.x release notes

Licensing terms

GTK+ is released under the terms of the GNU Lesser General Public License, version 2.1 or, at your option, any later version, as published by the Free Software Foundation.

Please, see the COPYING file for further information.

Главная Информация

GTK + - это многоплатформенный инструментарий для создания графических пользовательских интерфейсов. Предлагая полный набор виджетов, GTK + подходит для проектов от небольших одноразовых проектов до комплектов приложений.

GTK + - бесплатное программное обеспечение и часть проекта GNU. Тем не менее, лицензионные условия для GTK +, GNU LGPL, позволяют использовать его всеми разработчиками, в том числе разрабатывающими проприетарное программное обеспечение, без каких-либо лицензионных сборов или роялти.

Официальное место загрузки

https://download.gnome.org/sources/gtk+

Официальный сайт

https://www.gtk.org

Официальный блог разработчиков

https://blog.gtk.org

Информацию о списках рассылки можно найти по адресу

http://www.gtk.org/mailing-lists.php

Ночную документацию можно найти по адресу

Gtk: https://gnome.pages.gitlab.gnome.org/gtk/gtk/
Gdk: https://gnome.pages.gitlab.gnome.org/gtk/gdk/
Gsk: https://gnome.pages.gitlab.gnome.org/gtk/gsk/

Строительство и монтаж

Для создания GTK + вам понадобятся:

совместимый с C99 компилятор
Python 3
мезон
Ниндзя

Вам также понадобятся различные зависимости, основанные на платформе, для которой вы строите:

GLib
GdkPixbuf
GObject-Самоанализ
Каир
Панго
эпоксидная смола
Графен
ATK
Xkb-общий

Если вы создаете сервер X11, вам также понадобятся:

Xlib и следующих расширений X:
XRandR
XRender
XI
Xext
xfixes
xcursor
xdamage
xcomposite
атк-мост-2,0

Если вы создаете бэкэнд Wayland, вам также понадобятся:

Wayland-клиент
Wayland-протоколы
Wayland-курсор
Wayland-EGL

Когда у вас есть все необходимые зависимости, вы можете построить GTK + с помощью Meson:

$ meson _build.
$ cd _build
$ ninja

Вы можете запустить тестовый пакет, используя:

$ meson test

И, наконец, вы можете установить GTK +, используя:

$ sudo ninja install

Полную информацию об установке GTK + и связанных с ней библиотек можно найти в файле:

документы / ссылка / GTK / HTML / GTK-building.html

Или онлайн
Как сообщить об ошибках

Об ошибках следует сообщать на странице проблем.

В отчете об ошибке укажите:

Информация о вашей системе. Например:
какая версия GTK + вы используете
какая операционная система и версия
для Linux, распределение
если вы построили GTK +, список параметров, используемых для настройки сборки

И все, что вы считаете актуальным.

Как воспроизвести ошибку.

Если вы можете воспроизвести его с помощью одного из демонстрационных приложений, встроенных в демо / подкаталог, в одной из тестовых программ, встроенных в подкаталог tests /, это будет наиболее удобно. В противном случае, пожалуйста, укажите короткую тестовую программу, которая демонстрирует поведение. В качестве последнего средства вы также можете указать указатель на большую часть программного обеспечения, которое можно загрузить.

Если ошибка была катастрофа, точный текст, который был распечатан, когда произошел сбой.

Дополнительная информация, такая как трассировка стека, может быть полезна, но не нужна.

Примечания к выпуску

Замечания по выпуску для GTK + являются частью руководства по миграции в ссылке API. Видеть:

Примечания к выпуску 3.x
Примечания к выпуску 4.x

Условия лицензирования

GTK + выпускается на условиях лицензии GNU Lesser General Public License версии 2.1 или, по вашему выбору, любой более поздней версии, опубликованной Free Software Foundation.

Пожалуйста, просмотрите файл COPYING для получения дополнительной информации.

Migrating from GTK+ 3.x to GTK+ 4

Preparation in GTK+ 3.x

Do not use deprecated symbols
Enable diagnostic warnings
Do not use widget style properties
Review your window creation flags
Stop using non-RGBA visuals
Stop using GtkBox:padding, GtkBox:fill and GtkBox:expand
Stop using the state argument of GtkStyleContext getters
Stop using gdk_pixbuf_get_from_window() and gdk_cairo_set_source_surface()
Stop using GtkButton's image-related API

Changes that need to be done at the time of the switch

Stop using GdkScreen
Stop using the root window
Stop using GdkVisual
Stop using GdkDeviceManager
Adapt to GdkWindow API changes
Stop accessing GdkEvent fields
Stop using gdk_surface_set_event_compression
Adapt to GdkKeymap API changes
Adapt to GtkHeaderBar API changes
Adapt to GtkStyleContext API changes
Adapt to GtkCssProvider API changes
Stop using GtkContainer::border-width
Adapt to GtkWidget's size request changes
Switch to GtkWidget's children APIs
Don't use -gtk-gradient in your CSS
Don't use -gtk-icon-effect in your CSS
Use gtk_widget_measure
Adapt to drawing model changes
Stop using APIs to query GdkSurfaces
Widgets are now visible by default
Adapt to changes in animated hiding and showing of widgets
Stop passing commandline arguments to gtk_init
GdkPixbuf is deemphasized
GtkWidget event signals are removed
Invalidation handling has changed
Stop using GtkWidget::draw
Window content observation has changed
The gtk_window_fullscreen_on_monitor API has changed
Adapt to cursor API changes
Adapt to icon size API changes

GTK+ 4 is a major new version of GTK+ that breaks both API and ABI compared to GTK+ 3.x. Thankfully, most of the changes are not hard to adapt to and there are a number of steps that you can take to prepare your GTK+ 3.x application for the switch to GTK+ 4. After that, there's a small number of adjustments that you may have to do when you actually switch your application to build against GTK+ 4.
Preparation in GTK+ 3.x

The steps outlined in the following sections assume that your application is working with GTK+ 3.22, which is the final stable release of GTK+ 3.x. It includes all the necessary APIs and tools to help you port your application to GTK+ 4. If you are still using an older version of GTK+ 3.x, you should first get your application to build and work with the latest minor release in the 3.22 series.
Do not use deprecated symbols

Over the years, a number of functions, and in some cases, entire widgets have been deprecated. These deprecations are clearly spelled out in the API reference, with hints about the recommended replacements. The API reference for GTK+ 3 also includes an index of all deprecated symbols.

To verify that your program does not use any deprecated symbols, you can use defines to remove deprecated symbols from the header files, as follows:

make CFLAGS+="-DGDK_DISABLE_DEPRECATED -DGTK_DISABLE_DEPRECATED"


Note that some parts of our API, such as enumeration values, are not well covered by the deprecation warnings. In most cases, using them will require you to also use deprecated functions, which will trigger warnings.
Enable diagnostic warnings

Deprecations of properties and signals cannot be caught at compile time, as both properties and signals are installed and used after types have been instantiated. In order to catch deprecations and changes in the run time components, you should use the G_ENABLE_DIAGNOSTIC environment variable when running your application, e.g.:

G_ENABLE_DIAGNOSTIC=1 ./your-app


Do not use widget style properties

Style properties do not exist in GTK+ 4. You should stop using them in your custom CSS and in your code.
Review your window creation flags

GTK+ 4 removes the GDK_WA_CURSOR flag. Instead, just use gdk_surface_set_cursor() to set a cursor on the window after creating it.

GTK+ 4 also removes the GDK_WA_VISUAL flag, and always uses an RGBA visual for windows. To prepare your code for this, use gdk_surface_set_visual (gdk_screen_get_rgba_visual()) after creating your window.

GTK+ 4 also removes the GDK_WA_WMCLASS flag. If you need this X11-specific functionality, use XSetClassHint() directly.
Stop using non-RGBA visuals

GTK+ 4 always uses RGBA visuals for its windows; you should make sure that your code works with that.

At the same time, you should stop using GdkVisual APIs, this object not longer exist in GTK+ 4. Most of its APIs are deprecated already and not useful when dealing with RGBA visuals.
Stop using GtkBox:padding, GtkBox:fill and GtkBox:expand

GTK+4 removes these GtkBox child properties, so you should not use them. You can replace GtkBox:padding using the “margin” properties on your GtkBox child widgets.

The fill child property can be replaced by setting appropriate values for the “halign” and “valign” properties of the child widg

Миграция с GTK + 3.x на GTK + 4

Подготовка в GTK + 3.x

Не использовать устаревшие символы
Включить диагностические предупреждения
Не используйте свойства стиля виджетов
Просмотрите флаги создания окна
Прекратить использование визуальных изображений без RGBA
Прекратить использование GtkBox: padding, GtkBox: fill и GtkBox: expand
Прекратить использование аргумента состояния GtkStyleContext getters
Прекратите использование gdk_pixbuf_get_from_window () и gdk_cairo_set_source_surface ()
Прекратите использование API-интерфейса GtkButton

Изменения, которые необходимо выполнить во время переключения

Прекратить использование GdkScreen
Прекратить использование корневого окна
Прекратить использование GdkVisual
Прекратить использование GdkDeviceManager
Адаптация к изменениям API GdkWindow
Остановить доступ к полям GdkEvent
Прекратить использование gdk_surface_set_event_compression
Адаптация к изменениям API GdkKeymap
Адаптироваться к изменениям API GtkHeaderBar
Адаптация к изменениям API GtkStyleContext
Адаптироваться к изменениям API GtkCssProvider
Прекратить использование GtkContainer :: border-width
Адаптация к изменениям запроса размера GtkWidget
Переключиться на дочерние API-интерфейсы GtkWidget
Не используйте -gtk-gradient в своем CSS
Не используйте -gtk-icon-эффект в вашем CSS
Использовать gtk_widget_measure
Адаптация к изменениям модели чертежа
Прекратить использование API для запроса GdkSurfaces
Виджеты теперь видны по умолчанию
Адаптация к изменениям в анимированном скрытии и показе виджетов
Остановить передачу аргументов командной строки gtk_init
GdkPixbuf дефокусирован
Удаляются сигналы событий GtkWidget
Изменена обработка недействительности
Прекратить использование GtkWidget :: draw
Наблюдение за окном изменилось
API gtk_window_fullscreen_on_monitor изменился
Адаптация к API-интерфейсу курсора
Адаптировать к изменениям API размера значка

GTK + 4 - это новая новая версия GTK +, которая ломает API и ABI по сравнению с GTK + 3.x. К счастью, большинство изменений не сложно адаптировать и есть несколько шагов, которые вы можете предпринять, чтобы подготовить ваше приложение GTK + 3.x для перехода на GTK + 4. После этого есть небольшое количество настроек, которые вы можете должны делать, когда вы действительно переключаете свое приложение на GTK + 4.
Подготовка в GTK + 3.x

Шаги, описанные в следующих разделах, предполагают, что ваше приложение работает с GTK + 3.22, который является окончательной стабильной версией GTK + 3.x. Он включает в себя все необходимые API и инструменты, которые помогут вам портировать ваше приложение на GTK + 4. Если вы все еще используете более старую версию GTK + 3.x, сначала вы должны получить приложение для создания и работы с последней версией в 3.22 серии.
Не использовать устаревшие символы

На протяжении многих лет ряд функций, а в некоторых случаях, все виджеты устарели. Эти отклонения четко изложены в справочной системе API, с подсказками о рекомендуемых заменах. Ссылка API для GTK + 3 также включает индекс всех устаревших символов.

Чтобы убедиться, что ваша программа не использует устаревшие символы, вы можете использовать define для удаления устаревших символов из файлов заголовков следующим образом:

make CFLAGS + = "- DGDK_DISABLE_DEPRECATED -DGTK_DISABLE_DEPRECATED"


Обратите внимание, что некоторые части нашего API, такие как значения перечисления, недостаточно хорошо описаны предупреждениями об устаревании. В большинстве случаев использование их потребует от вас также использовать устаревшие функции, которые будут вызывать предупреждения.
Включить диагностические предупреждения

Устаревшие свойства и сигналы не могут быть пойманы во время компиляции, поскольку как свойства, так и сигналы установлены и используются после создания экземпляров типов. Чтобы уловить устаревания и изменения компонентов времени выполнения, вы должны использовать переменную среды G_ENABLE_DIAGNOSTIC при запуске приложения, например:

G_ENABLE_DIAGNOSTIC = 1 ./your-app


Не используйте свойства стиля виджетов

Свойства стиля не существуют в GTK + 4. Вы должны прекратить использовать их в своем пользовательском CSS и в своем коде.
Просмотрите флаги создания окна

GTK + 4 удаляет флаг GDK_WA_CURSOR. Вместо этого просто используйте gdk_surface_set_cursor (), чтобы установить курсор в окне после его создания.

GTK + 4 также удаляет флаг GDK_WA_VISUAL и всегда использует визуализацию RGBA для окон. Чтобы подготовить код для этого, используйте gdk_surface_set_visual (gdk_screen_get_rgba_visual ()) после создания вашего окна.

GTK + 4 также удаляет флаг GDK_WA_WMCLASS. Если вам нужна эта X11-специфическая функциональность, используйте XSetClassHint () напрямую.
Прекратить использование визуальных изображений без RGBA

GTK + 4 всегда использует RGBA-визуальные эффекты для своих окон; вы должны убедиться, что ваш код работает с этим.

В то же время вам следует прекратить использование API-интерфейсов GdkVisual, этот объект больше не существует в GTK + 4. Большинство его API уже устарели и не полезны при работе с визуальными изображениями RGBA.
Прекратить использование GtkBox: padding, GtkBox: fill и GtkBox: expand

GTK + 4 удаляет эти дочерние свойства GtkBox, поэтому вы не должны их использовать. Вы можете заменить GtkBox: padding, используя свойства «margin» на дочерних виджетах GtkBox.

Заполнение дочернего свойства может быть заменено установкой соответствующих значений для свойств «halign» и «valign» дочернего объекта