/usr/share/help/ru/hig/header-bar-menus.page is in gnome-devel-docs 3.28.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | <?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="header-bar-menus" xml:lang="ru">
<info>
<link type="guide" xref="patterns#primary"/>
<desc>Common menus shown on the right side of a header bar</desc>
<credit type="author">
<name>Алан Дэй (Allan Day)</name>
<email>aday@gnome.org</email>
</credit>
<include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
</info>
<title>Меню заголовочной панели</title>
<media type="image" mime="image/svg" src="figures/patterns/header-bar-menu.svg"/>
<p><link xref="header-bars">Заголовочные панели</link> могут включать меню с действиями и параметрами для текущего вида. Эти меню находятся с краю с правой стороны в панели заголовка.</p>
<p>Поскольку наиболее часто используемые действия для текущего вида должны помещаться непосредственно в панель заголовка, меню этой панели предоставляет доступ к менее используемым действиям. Это позволяет разгрузить заголовочную панель от второстепенных элементов управления.</p>
<p>Таким образом, с помощью меню заголовочной панели обеспечивается центр внимания и предоставляется доступ к наиболее интересным и полезным функциям.</p>
<section id="when-to-use">
<title>Когда использовать</title>
<p>Размещайте в меню заголовочной панели дополнительные действия или параметры для текущего вида. В этом меню должны размещаться действия или параметры, которые не востребованы в большинстве случаев, если среди них имеются действия, которые важнее прочих для текущего вида, попробуйте вынести их в <link xref="action-bars">панель действий</link>.</p>
<p>Не используйте меню заголовочной панели для выполнения действий над выделенным содержимым: когда содержимое не выделено, меню будет содержать бесполезные неактивные элементы меню, когда содержимое выделено, возможные действия не будут афишироваться. В таких случаях лучше использовать <link xref="selection-mode">режим выделения</link> или <link xref="popovers">всплывающие виджеты</link>.</p>
</section>
<section id="guidance">
<title>Рекомендации</title>
<list>
<item><p>В меню заголовочной панели должны находиться действия только для текущего вида или окна, это отличает его содержимое от меню приложения.</p></item>
<item><p>Следуйте <link xref="menus">стандартным рекомендациям для меню</link>.</p></item>
<item><p>Меню заголовочной панели реализовано через <link xref="popovers">всплывающий виджет</link>, поэтому меню оно может содержать различные управляющие элементы, например различные группы кнопок.</p></item>
<item><p>В меню заголовочной панели не должно быть элемента для закрытия меню, поскольку это действие уже реализовано в заголовочной панели, и если бы оно было включено в меню, было бы неясно, что именно закрывает этот элемент.</p></item>
</list>
</section>
<section id="api-reference">
<title>API reference</title>
<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuButton.html">GtkMenuButton</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>
</section>
</page>
|