Adding an entry to the Create New menu/ru: Difference between revisions

From KDE Wiki Sandbox
(Created page with "Добавление пункта в меню «Создать»")
 
(Created page with "В этой папке создайте новый файл с расширением {{Path|.desktop}} Например: {{Path|custom-file.desktop}}.")
 
Line 3: Line 3:
{|class="tablecenter vertical-centered"
{|class="tablecenter vertical-centered"
|[[Image:CustomCreateNewMenuEntry.png|300px]]
|[[Image:CustomCreateNewMenuEntry.png|300px]]
|Tutorial that describes how to add an entry to the <menuchoice>Create New</menuchoice> menu of file browsers such as [[Special:myLanguage/Dolphin|Dolphin]] or [[Special:myLanguage/Konqueror|Konqueror]]
|Руководство, описывающее, как добавить пункт в меню <menuchoice>Создать</menuchoice> диспетчера фалов, подобных [[Special:myLanguage/Dolphin|Dolphin]] или [[Special:myLanguage/Konqueror|Konqueror]]
|}
|}


The entries of the <menuchoice>Create New</menuchoice> menu are called ''templates''. They are defined either system-wide, in {{Path|/usr/share/templates}}, or only for the current user, in {{Path|~/.kde4/share/templates}}. In this tutorial we are going to add a new template to {{Path|~/.kde4/share/templates}}.
Пункты меню <menuchoice>Создать</menuchoice> носят название ''Шаблоны''. Эти шаблоны, влияющие на отображение пунктов меню для всех пользователей можно найти  в {{Path|/usr/share/templates}} , шаблоны только для текущего пользователя располагаются в {{Path|~/.kde4/share/templates}}. В этом руководстве мы собираемся добавить шаблон в {{Path|~/.kde4/share/templates}}.


== Defining the metadata ==
== Метаданные ==


Create a {{Path|templates}} folder in {{Path|~/.kde4/share}} if such a folder does not exist already, and enter the {{Path|templates}} folder.
Создайте {{Path|templates}} папку в {{Path|~/.kde4/share}} если она еще не создана, и перейдите в {{Path|templates}}.


In this folder, create a new file with {{Path|.desktop}} as file extension. For example: {{Path|custom-file.desktop}}.
В этой папке создайте новый файл с расширением {{Path|.desktop}} Например: {{Path|custom-file.desktop}}.


Open this new file and paste the following content inside it:
Откройте созданный файл и вставьте в него следующее содержимое:


<source lang="ini">
<source lang="ini">
Line 25: Line 25:
</source>
</source>


Fill these fields as follows:
Заполните эти поля, как показано ниже:
* '''Name''' is the text that appears in the <menuchoice>Create New</menuchoice> menu.
* '''Name''' текст, появляющийся в меню <menuchoice>Создать</menuchoice> .
*: [[Image:CustomCreateNewMenuEntry.png]]
*: [[Image:CustomCreateNewMenuEntry.png]]
*: "Custom Entry" is the value of the '''Name''' field.
*: "Custom Entry" заполняется значением поля '''Name''' .


* '''Comment''' is the label for the new name of files of this type. When you select your custom entry in the <menuchoice>Create New</menuchoice> menu, a dialog shows up asking you for the name of your new file, and this text is the label of the field where you enter this new name.
* '''Comment''' - текст, появляющийся, когда вы переходите по пункту меню <menuchoice>Создать</menuchoice> , и попадаете в диалог, например, создания нового файла, значение этого поля будет содержаться в поле выбора имени для создаваемого файла.
*: [[Image:CustomCreateNewMenuEntryComment.png]]
*: [[Image:CustomCreateNewMenuEntryComment.png]]
*: "New custom entry:" is the value of the '''Comment''' field.
*: "New custom entry:" содержит значение поля '''Comment''' field.


* '''URL''' is the path to a file containing the initial content that new files of this type have. These files with the initial content are usually located within the hidden {{Path|.source}} folder of the {{Path|templates}} folder, so use a relative path that starts with {{Path|.source/}}, such as {{Path|.source/custom-entry.txt}}.
* '''URL''' - это путь к файлу, с исходными данными, которые обычно содержат новые файлы данного типа. Такие файлы обычно находятся внутри скрытой {{Path|.source}} папки в {{Path|templates}} папке, так, что используйте относительный путь, начинающийся с {{Path|.source/}}, такой, например, как {{Path|.source/custom-entry.txt}}.


* '''Icon''' is the code of the icon that appears in the <menuchoice>Create New</menuchoice> menu for your custom entry. The code is the filename of the icon to use. You can browse MIME type icon files at {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/}}. For example, to use {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/application-vnd.oasis.opendocument.text.png}}, fill '''Icon''' with "application-vnd.oasis.opendocument.text".
* '''Icon''' - это код иконки, появляющейся в меню <menuchoice>Создать</menuchoice> у созданного вами пункта. Код - это имя файла иконки, которую вы собираетесь использовать. Вы можете посмотреть MIME типы файлов иконок в {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/}}. Например, что бы использовать {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/application-vnd.oasis.opendocument.text.png}}, заполните поле '''Icon''' следующим содержимым "application-vnd.oasis.opendocument.text".


This is an example of a filled {{Path|.desktop}} file:
Это пример заполненного файла {{Path|.desktop}} :


<source lang="ini">
<source lang="ini">
Line 49: Line 49:
</source>
</source>


=== Translating the Name and Comment ===
=== Перевод для полей Name и Comment ===


The '''Name''' and '''Comment''' fields can be translated to any language. To provide a translation, include a new field in your {{Path|.desktop}} file with the form "Field[language code]=Value" for each language that you want to support. For example:
Содержимое полей '''Name''' и '''Comment''' может быть переведено на любой язык. Чтобы сделать это, включите в ваш файл {{Path|.desktop}} поле следующего содержания "Field[language code]=Значение" для каждого языка, который хотите использовать. Например:


<source lang="ini">
<source lang="ini">
Line 60: Line 60:
</source>
</source>


== Defining the content ==
== Определение содержимого создаваемого файла ==


Create a {{Path|.source}} folder in {{Path|~/.kde4/share/templates}} if such a folder does not exist already, and enter the hidden {{Path|.source}} folder.
Создайте папку {{Path|.source}} в {{Path|~/.kde4/share/templates}} если она еще не создана, и войдите в скрытую папку {{Path|.source}}.


Create a new file with the same filename that you defined in the '''URL''' field of the metadata of your new entry, and fill the file with the default content that you want for new files created with your new entry.
Создайте новый файл с тем же именем, которое вы указывали в поле '''URL''' файла метаданных для вашего пункта меню. Заполните созданный файл данными, которые бы вы хотели видеть в файлах создаваемых вашим пунктом меню по умолчанию.


[[Category:Tutorials]]
[[Category:Tutorials]]

Latest revision as of 23:01, 23 September 2022

Руководство, описывающее, как добавить пункт в меню Создать диспетчера фалов, подобных Dolphin или Konqueror

Пункты меню Создать носят название Шаблоны. Эти шаблоны, влияющие на отображение пунктов меню для всех пользователей можно найти в /usr/share/templates , шаблоны только для текущего пользователя располагаются в ~/.kde4/share/templates. В этом руководстве мы собираемся добавить шаблон в ~/.kde4/share/templates.

Метаданные

Создайте templates папку в ~/.kde4/share если она еще не создана, и перейдите в templates.

В этой папке создайте новый файл с расширением .desktop Например: custom-file.desktop.

Откройте созданный файл и вставьте в него следующее содержимое:

[Desktop Entry]
Name=
Comment=
Type=Link
URL=
Icon=

Заполните эти поля, как показано ниже:

  • Name текст, появляющийся в меню Создать .
    "Custom Entry" заполняется значением поля Name .
  • Comment - текст, появляющийся, когда вы переходите по пункту меню Создать , и попадаете в диалог, например, создания нового файла, значение этого поля будет содержаться в поле выбора имени для создаваемого файла.
    "New custom entry:" содержит значение поля Comment field.
  • URL - это путь к файлу, с исходными данными, которые обычно содержат новые файлы данного типа. Такие файлы обычно находятся внутри скрытой .source папки в templates папке, так, что используйте относительный путь, начинающийся с .source/, такой, например, как .source/custom-entry.txt.
  • Icon - это код иконки, появляющейся в меню Создать у созданного вами пункта. Код - это имя файла иконки, которую вы собираетесь использовать. Вы можете посмотреть MIME типы файлов иконок в /usr/share/icons/<theme>/<size>/mimetypes/. Например, что бы использовать /usr/share/icons/<theme>/<size>/mimetypes/application-vnd.oasis.opendocument.text.png, заполните поле Icon следующим содержимым "application-vnd.oasis.opendocument.text".

Это пример заполненного файла .desktop :

[Desktop Entry]
Name=Custom Entry
Comment=New custom entry:
Type=Link
URL=.source/custom-entry.txt
Icon=application-vnd.oasis.opendocument.text

Перевод для полей Name и Comment

Содержимое полей Name и Comment может быть переведено на любой язык. Чтобы сделать это, включите в ваш файл .desktop поле следующего содержания "Field[language code]=Значение" для каждого языка, который хотите использовать. Например:

[Desktop Entry]
Name=Custom Entry
Name[ca]=Entrada personalitzada
Name[gl]=Entrada personalizada

Определение содержимого создаваемого файла

Создайте папку .source в ~/.kde4/share/templates если она еще не создана, и войдите в скрытую папку .source.

Создайте новый файл с тем же именем, которое вы указывали в поле URL файла метаданных для вашего пункта меню. Заполните созданный файл данными, которые бы вы хотели видеть в файлах создаваемых вашим пунктом меню по умолчанию.