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

From KDE UserBase Wiki
(Created page with "== Визначення метаданих ==")
No edit summary
 
(19 intermediate revisions by 2 users not shown)
Line 10: Line 10:
== Визначення метаданих ==
== Визначення метаданих ==


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 '''Create New''' menu.
* '''Name''' — текст пункту, який буде показано у підменю '''Створити'''.
*: [[Image:CustomCreateNewMenuEntry.png]]
*: [[Image:CustomCreateNewMenuEntry_uk.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 '''Create New''' 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''' — мітка для назви нових файлів цього типу. Коли ви вибиратимете нетиповий пункт у меню '''Створити''', ви бачитимете діалогове вікно, у якому середовище проситиме вас вказати назву вашого нового файла. Вказаний вами текст буде написом, на місці якого ви введете цю нову назву.
*: [[Image:CustomCreateNewMenuEntryComment.png]]
*: [[Image:CustomCreateNewMenuEntryComment_uk.png]]
*: "New custom entry:" is the value of the '''Comment''' field.
*: "New custom entry:" — значення поля '''Comment'''.


* '''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 '''Create New''' 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''' — код піктограми, яку буде показано у меню '''Створити''' для вашого нетипового пункту. Код є назвою файла піктограми, яку слід використати. Ви можете знайти потрібну серед піктограм типів MIME у каталозі {{Path|/usr/share/icons/&lt;тема&gt;/&lt;розмір&gt;/mimetypes/}}. Наприклад, щоб скористатися піктограмою {{Path|/usr/share/icons/&lt;тема&gt;/&lt;розмір&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 ===
=== Переклад назви пункту та коментаря ===


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}} у форматі «Поле[код_мови]=Значення» для кожної підтримуваної мови. Приклад:


<source lang="ini">
<source lang="ini">
[Desktop Entry]
[Desktop Entry]
Name=Custom Entry
Name=Custom Entry
Name[ca]=Entrada personalitzada
Name[uk]=Нетиповий пункт
Name[gl]=Entrada personalizada
</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:Підручники/uk]]
[[Category:Підручники/uk]]

Latest revision as of 21:17, 29 February 2016

Other languages:
У цьому підручнику описано процедуру додавання пункту до меню «Створити» програм для керування файлами, зокрема 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.
  • URL — шлях до файла, що містить початкові дані, які записуватимуться до нових файлів відповідного типу. Файли з такими даним зазвичай зберігаються у прихованій підтеці .source теки templates. Отже, скористайтеся відносним шляхом, який починатиметься з .source/, наприклад .source/custom-entry.txt.
  • Icon — код піктограми, яку буде показано у меню Створити для вашого нетипового пункту. Код є назвою файла піктограми, яку слід використати. Ви можете знайти потрібну серед піктограм типів MIME у каталозі /usr/share/icons/<тема>/<розмір>/mimetypes/. Наприклад, щоб скористатися піктограмою /usr/share/icons/<тема>/<розмір>/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 можна перекласти будь-якою мовою. Щоб вказати переклад, додайти нове поле до файла .desktop у форматі «Поле[код_мови]=Значення» для кожної підтримуваної мови. Приклад:

[Desktop Entry]
Name=Custom Entry
Name[uk]=Нетиповий пункт

Визначення вмісту

Створіть підтеку .source у теці ~/.kde4/share/templates, якщо такої під теки ще не існує, і увійдіть до прихованої теки .source.

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