Gui Command/ru: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<div class="mw-translate-fuzzy">
GuiCommand - одна из наиболее важных функций FreeCAD
GuiCommand - одна из наиболее важных функций FreeCAD
при взаимодействии с пользователем. Каждый раз, когда пользователь
при взаимодействии с пользователем. Каждый раз, когда пользователь
Line 9: Line 11:
* Записывается в макрос
* Записывается в макрос
* и.т.д...
* и.т.д...
</div>


<div class="mw-translate-fuzzy">
=== Назначение имен ===
=== Назначение имен ===
GuiCommand именуются определенным образом: ''ИмяМодуля_ИмяКоманды''
GuiCommand именуются определенным образом: ''ИмяМодуля_ИмяКоманды''
т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base (базовой системе).
т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base (базовой системе).
GuiCommand в определенном модуле получает имя имя модуля впереди, например "Part_Cylinder".
GuiCommand в определенном модуле получает имя имя модуля впереди, например "Part_Cylinder".
</div>


<div class="mw-translate-fuzzy">
Если документ не закончен(в смысле wiki статья) используйте шаблон [[Template:UnfinishedDocu]]
Если документ не закончен (в смысле wiki статья) используйте шаблон [[Template:UnfinishedDocu]]
</div>


<div class="mw-translate-fuzzy">
=== Страница справки ===
=== Страница справки ===
Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. В статье со схожим с именем GuiCommand, т.т. [[Std ViewScreenShot]].
Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. Статья имеет то же имя, что и GuiCommand, например, [[Draft ShapeString]].
</div>


<div class="mw-translate-fuzzy">
Чтобы создать ваши собственные справочные страницы используйте шаблон:
Чтобы создать ваши собственные справочные страницы используйте шаблон:
[[GuiCommand model]]
[[GuiCommand model]]
</div>


<div class="mw-translate-fuzzy">
Примеры:
Примеры:
* [[Draft ShapeString]]
* [[Draft ShapeString]]
* [[Draft Line]]
* [[Draft Line]]
</div>


<div class="mw-translate-fuzzy">
=== Иконки ===
=== Иконки ===
[[Image:Tango-Palette.png|400px|right]]
[[Image:Tango-Palette.png|400px|right]]
</div>


<div class="mw-translate-fuzzy">
Каждая GuiCommand-а должна иметь иконку. Мы используем [http://tango.freedesktop.org/Tango_Desktop_Project| Tango набор иконок] и его принципы. Справа вы можете видеть палитру цветов tango.
Каждая GuiCommand-а должна иметь иконку. Мы используем [http://tango.freedesktop.org/Tango_Desktop_Project| Tango набор иконок] и его принципы. Справа вы можете видеть палитру цветов tango.
</div>


<div class="mw-translate-fuzzy">
Предпочтительней всех, иконки нарисованные в SVG , например с помощью [http://inkscape.org Inkscape].
Предпочтительней всех, иконки нарисованные в SVG , например с помощью [http://inkscape.org Inkscape].
Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения.
Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения.
</div>


<div class="mw-translate-fuzzy">
'''icons color coding chart'''
'''диаграмма цветового кодирования иконок'''
</div>


[[Image:Colorchart.png|200px]]
[[Image:Colorchart.png|200px]]


Мы стараемся насколько возможно следовать этой диаграмме, так что цвета иконок имеют прямое значение.
We try as much as possible to respect this chart, so the color of the icons has a direct meaning.


<div class="mw-translate-fuzzy">
=== Требования к качеству ===
=== Требования к качеству ===
Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являются экспериментальными или используются недолгое время для реализации целей. Эти GuiCommands в основном помещаются в инструментарии, такие как Part, Mesh или Cam.
Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являются экспериментальными или используются недолгое время для реализации целей. Эти GuiCommands в основном помещаются в инструментарии, такие как Part, Mesh или Cam.
Для обеспечения хорошей работы пользователя, был создан''Полный(Complete)'' инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие '''Требованиям к качеству''' ,описанным здесь:
Для обеспечения хорошей работы пользователя, был создан''Полный(Complete)'' инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие '''Требованиям к качеству''' ,описанным здесь:
</div>


<s>There are a lot of GuiCommands (tools) in FreeCAD which are experimental
or used for a short time to test implementation of new features. These GuiCommands are mostly in
the dedicated workbenches like Part, Mesh or Cam.
To ensure a good user experience the workbench ''Complete'' was created. This
workbench incorporates all GuiCommands
which meet certain quality requirements which are described here:

<div class="mw-translate-fuzzy">
* Команда/Функция должна быть '''законченой'''. Никаких незавершенных работ!
* Команда/Функция должна быть '''законченой'''. Никаких незавершенных работ!
* Должен иметь '''справочную страницу''' как [[Std ViewScreenShot|эта]]
* Должен иметь '''справочную страницу''' как [[Std ViewScreenShot|эта]]
Line 52: Line 83:
** Описание связанных python интерфесов и классов с примерами кода
** Описание связанных python интерфесов и классов с примерами кода
* Настройка надлежащей иконки и позиции в меню
* Настройка надлежащей иконки и позиции в меню
</div>


<div class="mw-translate-fuzzy">
Надеюсь, что так будет со всеми GuiCommands из [[List of Commands|Списка команд]].
Надеюсь, что так будет со всеми GuiCommands из [[List of Commands/ru|Списка команд]].
</div>



{{Userdocnavi}}

<div class="mw-translate-fuzzy">
[[Category:User Documentation/ru]]
[[Category:User Documentation/ru]]
[[Category:Command_Reference/ru]]
[[Category:Command_Reference/ru]]
</div>


{{clear}}
{{clear}}
<languages/>

Revision as of 16:09, 4 March 2019

GuiCommand - одна из наиболее важных функций FreeCAD при взаимодействии с пользователем. Каждый раз, когда пользователь выбирает опцию в меню или нажимает на кнопку панели инструментов, активируется GuiCommand. Некоторые из атрибутов GuiCommand:

  • Задано имя
  • Содержит иконку
  • Определена возможности для отмены/повтора
  • Есть страница справки
  • Открывает и управляет диалогами
  • Записывается в макрос
  • и.т.д...

Назначение имен

GuiCommand именуются определенным образом: ИмяМодуля_ИмяКоманды т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base (базовой системе). GuiCommand в определенном модуле получает имя имя модуля впереди, например "Part_Cylinder".

Если документ не закончен (в смысле wiki статья) используйте шаблон Template:UnfinishedDocu

Страница справки

Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. Статья имеет то же имя, что и GuiCommand, например, Draft ShapeString.

Чтобы создать ваши собственные справочные страницы используйте шаблон: GuiCommand model

Примеры:

Иконки

Каждая GuiCommand-а должна иметь иконку. Мы используем Tango набор иконок и его принципы. Справа вы можете видеть палитру цветов tango.

Предпочтительней всех, иконки нарисованные в SVG , например с помощью Inkscape. Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения.

диаграмма цветового кодирования иконок

Мы стараемся насколько возможно следовать этой диаграмме, так что цвета иконок имеют прямое значение.

Требования к качеству

Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являются экспериментальными или используются недолгое время для реализации целей. Эти GuiCommands в основном помещаются в инструментарии, такие как Part, Mesh или Cam. Для обеспечения хорошей работы пользователя, был созданПолный(Complete) инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие Требованиям к качеству ,описанным здесь:

There are a lot of GuiCommands (tools) in FreeCAD which are experimental or used for a short time to test implementation of new features. These GuiCommands are mostly in the dedicated workbenches like Part, Mesh or Cam. To ensure a good user experience the workbench Complete was created. This workbench incorporates all GuiCommands which meet certain quality requirements which are described here:

  • Команда/Функция должна быть законченой. Никаких незавершенных работ!
  • Должен иметь справочную страницу как эта
    • Все поля Template:GuiCommand должны быть заполнены
    • Картинки с изображением диологов команды и конечный вывод
    • детальное описание команды и всех её параметров и настроек
    • Описание связанных python интерфесов и классов с примерами кода
  • Настройка надлежащей иконки и позиции в меню

Надеюсь, что так будет со всеми GuiCommands из Списка команд.