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

From KDE UserBase Wiki
(Created page with "Ajouter une entrée dans le menu Créer un nouveau")
 
(Created page with "Category:Tutoriels/fr")
 
(16 intermediate revisions by the same user not shown)
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]]
|Tutoriel qui décrit comment ajouter une entrée au menu <menuchoice>Créer un nouveau</menuchoice> des navigateurs de fichiers tels que [[Special:myLanguage/Dolphin|Dolphin]] ou [[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}}.
Les entrées du menu <menuchoice>Créer un nouveau</menuchoice> sont appelés des ''templates''. Ils sont définis au niveau du système, dans {{Path|/usr/share/templates}}, ou seulement pour l'utilisateur courant, dans {{Path|~/.kde4/share/templates}}. Dans ce tutoriel, nous allons ajouter un nouveau template dans {{Path|~/.kde4/share/templates}}.


== Defining the metadata ==
== Définir les métadonnées ==


Create a {{Path|templates}} folder in {{Path|~/.kde4/share}} if such a folder does not exist already, and enter the {{Path|templates}} folder.
Créez un dossier {{Path|templates}} dans {{Path|~/.kde4/share}} si un tel dossier n’existe pas , et entrez dans le dossier {{Path|templates}}.


In this folder, create a new file with {{Path|.desktop}} as file extension. For example: {{Path|custom-file.desktop}}.
Dans ce dossier, créez un nouveau fichier avec l’extension {{Path|.desktop}}. Par exemple : {{Path|custom-file.desktop}}.


Open this new file and paste the following content inside it:
Ouvrez ce nouveau fichier et coller le contenu suivant à l’intérieur :


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


Fill these fields as follows:
Remplissez les champs de la manière suivante :
* '''Name''' is the text that appears in the <menuchoice>Create New</menuchoice> menu.
* '''Name''' est le texte qui apparaîtra dans le menu <menuchoice>Create New</menuchoice>.
*: [[Image:CustomCreateNewMenuEntry.png]]
*: [[Image:CustomCreateNewMenuEntry.png]]
*: "Custom Entry" is the value of the '''Name''' field.
*: "Custom Entry" est la valeur du champ '''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''' est l’étiquette pour les nouveaux noms de fichiers de ce type. Quand vous sélectionnez votre entrée dans le menu <menuchoice>Create New</menuchoice>, une boîte de dialogue apparaît vous demandant le nom de votre nouveau fichier, et ce texte est l’étiquette du champ où vous entrez ce nouveau nom.
*: [[Image:CustomCreateNewMenuEntryComment.png]]
*: [[Image:CustomCreateNewMenuEntryComment.png]]
*: "New custom entry:" is the value of the '''Comment''' field.
*: "New custom entry:" est la valeur du champ '''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''' est le chemin vers un fichier contenant le contenu initial que les nouveaux fichiers de ce type auront. Ces fichiers avec le contenu initial sont habituellement situés dans le dossier caché {{Path|.source}} du dossier {{Path|templates}}, donc utilisez un chemin relatif qui commence par {{Path|.source/}}, tel que {{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''' est le code pour l’icône qui apparaît dans le menu <menuchoice>Create New</menuchoice> pour votre entrée. Le code est le nom du fichier à utiliser. Vous pouvez naviguer parmi les fichiers icônes dans {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/}}. Par exemple, pour utiliser {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/application-vnd.oasis.opendocument.text.png}}, remplicez '''Icon''' avec "application-vnd.oasis.opendocument.text".


This is an example of a filled {{Path|.desktop}} file:
Ceci est un exemple de fichier {{Path|.desktop}} rempli :


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


=== Translating the Name and Comment ===
=== Traduire le nom et les commentaires ===


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:
Les champs '''Name''' et '''Comment''' peuvent être traduits dans n’importe quelle langue. Pour fournir une traduction, incluez un nouveau champ dans votre fichier {{Path|.desktop}} avec la ligne "Field[language code]=Value" pour chaque langue que vous voulez supportez. Par exemple :


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


== Defining the content ==
== Définir le contenu ==


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.
Créer un dossier {{Path|.source}} dans {{Path|~/.kde4/share/templates}} si un tel dossier n’existe pas, et entrez dans le dossier caché {{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.
Créer un nouveau fichier avec le même nom que celui défini dans le champ '''URL''' des métadonnées de votre nouvel entrée, et remplissez le fichier avec le contenu par défaut que vous souhaitez pour votre nouvelle entrée.


[[Category:Tutorials]]
[[Category:Tutoriels/fr]]

Latest revision as of 17:10, 8 May 2016

Tutoriel qui décrit comment ajouter une entrée au menu Créer un nouveau des navigateurs de fichiers tels que Dolphin ou Konqueror

Les entrées du menu Créer un nouveau sont appelés des templates. Ils sont définis au niveau du système, dans /usr/share/templates, ou seulement pour l'utilisateur courant, dans ~/.kde4/share/templates. Dans ce tutoriel, nous allons ajouter un nouveau template dans ~/.kde4/share/templates.

Définir les métadonnées

Créez un dossier templates dans ~/.kde4/share si un tel dossier n’existe pas , et entrez dans le dossier templates.

Dans ce dossier, créez un nouveau fichier avec l’extension .desktop. Par exemple : custom-file.desktop.

Ouvrez ce nouveau fichier et coller le contenu suivant à l’intérieur :

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

Remplissez les champs de la manière suivante :

  • Name est le texte qui apparaîtra dans le menu Create New.
    "Custom Entry" est la valeur du champ Name.
  • Comment est l’étiquette pour les nouveaux noms de fichiers de ce type. Quand vous sélectionnez votre entrée dans le menu Create New, une boîte de dialogue apparaît vous demandant le nom de votre nouveau fichier, et ce texte est l’étiquette du champ où vous entrez ce nouveau nom.
    "New custom entry:" est la valeur du champ Comment.
  • URL est le chemin vers un fichier contenant le contenu initial que les nouveaux fichiers de ce type auront. Ces fichiers avec le contenu initial sont habituellement situés dans le dossier caché .source du dossier templates, donc utilisez un chemin relatif qui commence par .source/, tel que .source/custom-entry.txt.
  • Icon est le code pour l’icône qui apparaît dans le menu Create New pour votre entrée. Le code est le nom du fichier à utiliser. Vous pouvez naviguer parmi les fichiers icônes dans /usr/share/icons/<theme>/<size>/mimetypes/. Par exemple, pour utiliser /usr/share/icons/<theme>/<size>/mimetypes/application-vnd.oasis.opendocument.text.png, remplicez Icon avec "application-vnd.oasis.opendocument.text".

Ceci est un exemple de fichier .desktop rempli :

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

Traduire le nom et les commentaires

Les champs Name et Comment peuvent être traduits dans n’importe quelle langue. Pour fournir une traduction, incluez un nouveau champ dans votre fichier .desktop avec la ligne "Field[language code]=Value" pour chaque langue que vous voulez supportez. Par exemple :

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

Définir le contenu

Créer un dossier .source dans ~/.kde4/share/templates si un tel dossier n’existe pas, et entrez dans le dossier caché .source.

Créer un nouveau fichier avec le même nom que celui défini dans le champ URL des métadonnées de votre nouvel entrée, et remplissez le fichier avec le contenu par défaut que vous souhaitez pour votre nouvelle entrée.