calibre - en to fr translation catalogue (36 entries)

en: Snippets
fr: Fragments

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
fr: L'éditeur de livre numérique de calibre supporte les *fragments*. Un fragment est un morceau de texte qui est soit souvent réutilisé soit contient beaucoup de texte redondant. L'éditeur vous permet d'insérer un fragment avec seulement quelques séquences de touches. Par exemple, supposons que vous devez souvent trouver par vous même les balises link insérées lors de l'édition des fichiers HTML, alors vous pouvez simplement taper ``<a`` dans l'éditeur et presser |ct|. L'éditeur développera cela en ::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
fr: Pas seulement ça, le mot ``filename`` sera sélectionné, avec le curseur placé sur lui, ainsi vous pouvez facilement taper le vrai nom de fichier, en utilisant la petite fonctionnalité de l'éditeur :ref:`editor_auto_complete`. Et une fois que vous avez fini de taper le nom de fichier, pressez |ct| à nouveau et le curseur sautera vers la position entre les balises  ``<a>`` comme cela vous pouvez facilement y taper le texte pour le lien.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
fr: Le système des fragments dans l'éditeur est très sophistiqué, il y a quelques fragments intégrés et vous pouvez créer les vôtres pour convenir à votre style d'édition.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
fr: L'exposé qui suit sur les fragments intégrés devrait aider à illustrer la puissance du système des fragments.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
fr: Vous pouvez aussi utiliser les fragments dans les champs d'entrée de texte dans le panneau :guilabel:`Rechercher & Remplacer`, cependant, les espaces réservés (en utilisant |ct| pour s'y déplacer) ne fonctionneront pas.

en: The built-in snippets
fr: Les fragments intégrés

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
fr: Les fragments intégrés sont décrits ci-dessous . Notez que vous pouvez les remplacer en créant vos propres fragments avec le même texte déclencheur.

en: Inserting filler text [Lorem]
fr: Insertion du texte de remplissage [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
fr: Le premier fragment intégré, et le plus simple, est utilisé pour insérer du texte de remplissage dans un document. Le texte de remplissage est est issu de `De finibus bonorum et malorum <https://fr.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ une oeuvre philosophique de Cicéron (Traduite en anglais). Pour l'utiliser, taper simplement ``Lorem`` dans un fichier HTML et pressez |ct|. Il sera remplacé par quelques paragraphes de remplissage.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
fr: La définition de ce fragment est très simple, le texte déclencheur est défini comme étant ``Lorem`` et le modèle est défini simplement comme le texte  littéral à intégrer. Vous pouvez facilement le personnaliser pour utiliser votre texte de remplissage favori.

en: Inserting a self-closing HTML tag [<>]
fr: Insérer une balise HTML auto-fermante [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
fr: Maintenant jetons un oeil à un exemple simple du puissant concept de *placeholders*. Disons que vous voulez insérer une balise auto-fermante ``<hr/>``. Tapez juste ``<>`` et pressez |ct|, l'éditeur développera le fragment en ::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
fr: Ici, le symbole ``|`` représente la position actuelle du curseur. Vous pouvez alors taper ``hr`` et presser |ct| pour déplacer le curseur après la fin de la balise. Ce fragment est défini comme ::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
fr: Les espaces réservés sont simplement le signe dollar ($) suivi par un nombre. Lorsque le fragment est développé en appuyant sur |ct| le curseur est positionné au premier espace réservé (l'espace réservé avec le nombre le plus bas). Quand vous pressez |ct| à nouveau le curseur saute vers l'espace réservé suivant (l'espace réservé suivant avec le nombre plus élevé).

en: Inserting an HTML link tag [<a]
fr: Insérer une balise lien HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
fr: Les balises lien HTML partagent toutes une structure commune. Elles ont un attribut ``href`` et un certain texte entre les balises ouvrantes et fermantes. Un fragment pour rendre la frappe plus efficiente nous introduira certaines fonctionnalités supplémentaires des espaces réservés. Pour utiliser ce fragment, tapez simplement ``<a`` et appuyez |ct|. L'éditeur développera ceci en ::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
fr: Pas seulement ça, le mot ``filename`` sera sélectionné, avec le curseur placé sur lui, ainsi vous pouvez facilement taper le vrai nom de fichier, en utilisant la petite fonctionnalité de l'éditeur :ref:`editor_auto_complete`. Et une fois que vous avez fini de taper le nom de fichier, pressez |ct| à nouveau et le curseur sautera vers la position entre les balises  ``<a>`` comme cela vous pouvez facilement y taper le texte pour le lien. Après que vous ayez fini de taper le texte, appuyez |ct| encore une fois pour sauter au point après la balise fermante. Le fragment est défini comme ::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
fr: Il y a ici deux nouvelles fonctionnalités. Premièrement l'espace réservé ``$1`` est devenu plus complexe. Il inclut maintenant un certain *texte par défaut* (le mot ``filename``). Si un espace réservé contient du texte par défaut , le texte par défaut est substitué pour l'espace réservé quand le fragment est développé. Aussi quand vous sautez vers un espace réservé avec du texte par défaut en utilisant |ct|, le texte par défaut est sélectionné. De cette manière, vous pouvez utiliser le texte par défaut comme un rappel pour vous pour remplir d'importantes parties du modèle. Vous pouvez définir le texte par défaut pour un espace réservé en utilisant la syntaxe : ``${<number>:texte par défaut}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
fr: L'autre nouvelle fonctionnalité est que le second espace réservé a un astérisque qui le suit (``${2*}``). Cela signifie que tout texte qui est sélectionné avant de développer le modèle est substitué pour l'espace réservé. Pour voir ceci en action, sélectionner un certain texte dans l'éditeur, appuyer |ct|, tapez  ``<a`` et pressez |ct| à nouveau, le modèle sera développé en ::

en: Inserting a HTML image tag [<i]
fr: Insérer une balise image HTML [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
fr: C'est très similaire à insérer un lien HTML, comme nous avons vu ci-dessus. Cela vous permet d'entrer rapidement une balise ``<img src="filename" alt="description" />`` et sauter entre les attributs ``src`` et ``alt``

en: Insert an arbitrary HTML tag [<<]
fr: Insérer une balise HTML quelconque[<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. The editor will expand it to::
fr: Ceci vous permet d'insérer une balise HTML quelconque (ou d'envelopper le texte précédemment sélectionné dans la balise). Pour l'utiliser, tapez simplement ``<<`` et pressez |ct|. L'éditeur développera cela en::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
fr: Tapez le nom de la balise, par exemple : ``span`` et pressez |ct|, ce qui résultera en ::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
fr: Vous noterez que la balise fermante a été automatiquement remplie avec ``span``. Ceci est accompli avec encore une autre fonctionnalité des espaces réservés, *mirroring*. Mirroring signifie simplement que si vous spécifiez plus d'une fois l'échantillon d'espace réservé dans le modèle, le second et et toutes les positions futures seront automatiquement remplies avec ce que vous avez tapé en première position, quand vous appuyez sur |ct|. La définition pour ce fragment est ::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
fr: Comme vous pouvez voir, le premier espace réservé ($1) a été spécifié deux fois, la deuxième fois dans la balise fermante, ce qui copiera simplement ce que vous aurez tapé dans la balise ouvrante.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
fr: Insérer une balise HTML quelconque avec un attribut de classe [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
fr: Ceci est très similaire à l'exemple d'insertion d'une balise quelconque ci-dessus, exceptez qu'il assume que vous voulez spécifier une classe pour la balise ::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
fr: Ceci vous permettra de taper d'abord le nom de la balise, presser |ct|, taper le nom de la classe, presser |ct| tapez le contenu de la balise et pressez |ct| une dernière fois pour sortir de la balise. La balise de fermeture sera remplie automatiquement.

en: Creating your own snippets
fr: Créer vos propres fragments

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
fr: Les fragments sont vraiment brillants car vous pouvez créer les vôtres pour suivre votre style d'édition. Pour créer vos propres fragments allez à :guilabel:`Éditer->Préférences->Propriétés de l'éditeur->Gérer les fragments` dans l'éditeur. Cela fera apparaître une boîte de dialogue facile à utiliser pour vous aider à créer vos propres fragments. Cliquez simplement le bouton :guilabel:`Ajouter un fragment`et vous verrez une boîte de dialogue qui ressemble à :

en: The create your own snippets tool
fr: L'outil de création de vos propres fragments

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
fr: Tout d'abord donnez un nom à votre fragment, quelque chose de descriptif, pour aider à identifier le fragment par après. Spécifiez alors le *déclencheur*. Un déclencheur est simplement le texte que vous avez à taper avant de presser |ct| en vue de développer le fragment.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
fr: Spécifiez alors le modèle de fragment. Vous devriez commencer avec l'un des exemples ci-dessus et le modifier pour correspondre à vos besoins. Finalement, spécifier quels types de fichiers pour lesquels vous voulez que le fragment soit actif. De cette manière vous pouvez avoir de multiples fragments avec le même texte déclencheur qui fonctionne différemment dans différents types de fichiers.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
fr: L'étape suivante est de tester votre fragment nouvellement créé. Utilisez la boîte :guilabel:`Test` en bas. Entrez-y le texte déclencheur et appuyez sur |ct| pour développer le fragment et sauter entre les espaces réservés.
