en to fr translation catalogue (60 entries)

en: Mkdocs Markdown includer plugin.
fr: Plugin d'inclusion de Markdown pour Mkdocs.

en: Read this document in other languages:
fr: Lire ce document dans d'autres langues:

en: Setup
fr: Préparation

en: Enable the plugin in your `mkdocs.yml`:
fr: Activer le plugin dans votre fichier `mkdocs.yml`:

en: Reference
fr: Référence

en: This plugin provides two directives, one to include Markdown files and another to include files of any type.
fr: Ce plugin fournit deux directives, une pour inclure des fichiers Markdown et une autre pour inclure des fichiers de tout type.

en: Includes Markdown files content, optionally using two delimiters to filter the content to include.
fr: Inclut contenu des Markdown fichiers, en utilisant éventuellement deux délimiteurs pour filtrer le contenu à inclure.

en: Includes the content of a file or a group of files.
fr: Inclus le contenu d'un fichier ou d'un groupe de fichiers.

en: Acknowledgment
fr: Reconnaissance

en: [Joe Rickerby] and [contributors] for [giving me the permissions][cibuildwheel-470] to [separate this plugin][cibuildwheel-475] from the documentation of [cibuildwheel][cibuildwheel-repo-link].
fr: [Joe Rickerby] et [des contributeurs] pour [m'avoir donné les autorisations][cibuildwheel-470] pour [séparer ce plugin][cibuildwheel-475] de la documentation de [cibuildwheel][cibuildwheel-repo-link].

en: <a name="include-markdown_rewrite-relative-urls" href="#include-markdown_rewrite-relative-urls">#</a> **rewrite-relative-urls** (*true*): When this option is enabled (default), Markdown links and images in the content that are specified by a relative URL are rewritten to work correctly in their new location. Possible values are `true` and `false`.
fr: <a name="include-markdown_rewrite-relative-urls" href="#include-markdown_rewrite-relative-urls">#</a> **rewrite-relative-urls** (*true*): Lorsque cette option est activée (par défaut), liens et images Markdown dans le contenu qui sont spécifiés par une URL relative sont réécrits pour fonctionner correctement dans leur nouvel emplacement. Les valeurs possibles sont `true` et `false`.

en: <a name="include-markdown_comments" href="#include-markdown_comments">#</a> **comments** (*false*): When this option is enabled, the content to include is wrapped by `<!-- BEGIN INCLUDE -->` and `<!-- END INCLUDE -->` comments which help to identify that the content has been included. Possible values are `true` and `false`.
fr: <a name="include-markdown_comments" href="#include-markdown_comments">#</a> **comments** (*false*): Lorsque cette option est activée, le contenu à inclure est entouré de `<!-- BEGIN INCLUDE -->` et `<!-- END INCLUDE -->` commentaires qui aident à identifier que le contenu a été inclus. Les valeurs possibles sont `true` et `false`.

en: <a name="include-markdown_heading-offset" href="#include-markdown_heading-offset">#</a> **heading-offset** (0): Increases or decreases the Markdown headings depth by this number. Only supports number sign (`#`) heading syntax. Accepts negative values to drop leading `#` characters.
fr: <a name="include-markdown_heading-offset" href="#include-markdown_heading-offset">#</a> **heading-offset** (0): Augmente ou diminue la profondeur des en-têtes Markdown de ce nombre. Ne prend en charge que la syntaxe d'en-tête du signe dièse (`#`). Cet argument accepte les valeurs négatives pour supprimer les caractères `#` de tête.

en: <a name="include_start" href="#include_start">#</a> **start**: Delimiter that marks the beginning of the content to include.
fr: <a name="include_start" href="#include_start">#</a> **start**: Délimiteur qui marque le début du contenu à inclure.

en: <a name="include_end" href="#include_end">#</a> **end**: Delimiter that marks the end of the content to include.
fr: <a name="include_end" href="#include_end">#</a> **end**: Délimiteur qui marque la fin du contenu à inclure.

en: <a name="include_preserve-includer-indent" href="#include_preserve-includer-indent">#</a> **preserve-includer-indent** (*true*): When this option is enabled (default), every line of the content to include is indented with the same number of spaces used to indent the includer `{% %}` template. Possible values are `true` and `false`.
fr: <a name="include_preserve-includer-indent" href="#include_preserve-includer-indent">#</a> **preserve-includer-indent** (*true*): Lorsque cette option est activée (par défaut), chaque ligne du contenu à inclure est indentée avec le même nombre d'espaces utilisé pour indenter l'incluseur modèle `{% %}`. Les valeurs possibles sont `true` et `false`.

en: <a name="include_dedent" href="#include_dedent">#</a> **dedent** (*false*): If enabled, the included content will be dedented.
fr: <a name="include_dedent" href="#include_dedent">#</a> **dedent** (*false*): Lorsque est activée, le contenu inclus sera déchiqueté.

en: <a name="include_exclude" href="#include_exclude">#</a> **exclude**: Specify with a glob which files should be ignored. Only useful when passing globs to include multiple files.
fr: <a name="include_exclude" href="#include_exclude">#</a> **exclude**: Spécifiez avec un glob quels fichiers doivent être ignorés. Uniquement utile lors du passage de globs pour inclure plusieurs fichiers.

en: <a name="include_trailing-newlines" href="#include_trailing-newlines">#</a> **trailing-newlines** (*true*): When this option is disabled, the trailing newlines found in the content to include are stripped. Possible values are `true` and `false`.
fr: <a name="include_trailing-newlines" href="#include_trailing-newlines">#</a> **trailing-newlines** (*true*): Lorsque cette option est désactivée, les nouvelles lignes de fin trouvées dans le contenu à inclure sont supprimées. Les valeurs possibles sont `true` et `false`.

en: The arguments **start** and **end** may contain usual (Python-style) escape sequences like `\n` to match against newlines.
fr: Les chaînes **start** et **end** peuvent contenir des séquences d'échappement habituelles (de style Python) telles que `\n` pour correspondre aux nouvelles lignes.

en: File paths to include and string arguments can be wrapped by double `"` or single `'` quotes, which can be escaped prepending them a `\` character as `\"` and `\'`.
fr: Les chemins d'accès aux fichiers à inclure et les arguments de chaîne peuvent être entourés de guillemets doubles `"` ou simples `'`, qui peuvent être échappés en leur ajoutant un caractère `\` comme `\"` et `\'`.

en: <a name="include_encoding" href="#include_encoding">#</a> **encoding** (*'utf-8'*): Specify the encoding of the included file. If not defined `'utf-8'` will be used.
fr: <a name="include_encoding" href="#include_encoding">#</a> **encoding** (*'utf-8'*): Spécifiez l'encodage du fichier inclus. S'il n'est pas défini, `'utf-8'` sera utilisé.

en: The global behaviour of the plugin can be customized in the configuration.
fr: Le comportement global du plugin peut être personnalisé dans la configuration.

en: Most of the settings will define the default values passed to arguments of directives and are documented in the [reference](#reference).
fr: La plupart des paramètres définissent les valeurs par défaut transmises aux arguments des directives et sont documentés dans la [référence](#référence).

en: Paths of included files can be either:
fr: Les chemins des fichiers inclus peuvent être soit:

en: URLs to include remote content.
fr: URL pour inclure du contenu distant.

en: Local files:
fr: Fichiers locaux:

en: Absolute paths (starting with a path separator).
fr: Chemins de fichier absolus (commençant par un séparateur de chemin).

en: [Bash wildcard globs] matching multiple local files.
fr: [Globs génériques Bash] correspondant à plusieurs fichiers locaux.

en: Relative from the file that includes them (starting with `./` or `../`).
fr: Relatifs du fichiers qui les inclut (commençant par `./` ou `../`).

en: `opening_tag` and `closing_tag`
fr: `opening_tag` et `closing_tag`

en: Default opening and closing tags. When not specified they are `{%` and `%}`.
fr: Balises d'ouverture et de fermeture par défaut. Lorsqu'elles ne sont pas spécifiées, elles sont `{%` et `%}`.

en: Global exclusion wildcard patterns. Relative paths defined here will be relative to the [`docs_dir`] directory.
fr: Modèles de globes d'exclusion globaux. Les chemins relatifs définis ici seront relatifs au répertoire [`docs_dir`].

en: Expiration time in seconds for cached HTTP requests when including from URLs.
fr: Délai d'expiration en secondes pour les requêtes HTTP mises en cache lors de l'inclusion d'URL.

en: Examples
fr: Exemples

en: Relative to the [`docs_dir`] directory. For instance if your `docs_dir` is *./docs/*, then `includes/header.md` will match the file *./docs/includes/header.md*.
fr: Relatif au répertoire [`docs_dir`]. Par exemple, si votre `docs_dir` est _./docs/_, alors `includes/header.md` va correspondre au fichier *_./docs/includes/header.md_*.

en: [Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
fr: [Globs génériques Bash]: https://facelessuser.github.io/wcmatch/glob/#syntax

en: <a name="include_recursive" href="#include_recursive">#</a> **recursive** (*true*): When this option is disabled, included files are not processed for recursive includes. Possible values are `true` and `false`.
fr: <a name="include_recursive" href="#include_recursive">#</a> **recursive** (*true*): Lorsque cette option est désactivée, les fichiers inclus ne sont pas traités pour des inclusions récursives. Les valeurs possibles sont `true` et `false`.

en: [contributors]: https://github.com/mondeja/mkdocs-include-markdown-plugin/graphs/contributors
fr: [des contributeurs]: https://github.com/mondeja/mkdocs-include-markdown-plugin/graphs/contributors

en: Customize the names of the directives.
fr: Personnaliser les noms des directives.

en: In order to use this feature, the dependency [platformdirs] must be installed or the setting [`cache_dir`](#cache_dir) must be defined. You can include [platformdirs] in the installation of the plugin adding the `cache` extra:
fr: Pour utiliser cette fonctionnalité, la dépendance [platformdirs] doit être installée ou le paramètre [`cache_dir`](#cache_dir) doit être défini. Vous pouvez inclure [platformdirs] dans l'installation du plugin en ajoutant le supplément `cache` :

en: Directory where cached HTTP requests will be stored. If set, [platformdirs] is not needed to be installed to use [`cache`](#cache).
fr: Répertoire dans lequel les requêtes HTTP mises en cache seront stockées. Si défini, [platformdirs] n'a pas besoin d'être installé pour utiliser [`cache`](#cache).

en: A *.gitignore* file will be added to the cache directory if not exists to avoid committing the cache files.
fr: Un fichier *.gitignore* sera ajouté au répertoire de cache s'il n'existe pas pour éviter de valider les fichiers de cache.

en: **Order type**:
fr: **Type d'ordre**:

en: `'alpha'` (default): Alphabetical order.
fr: `'alpha'` (par défaut): Ordre alphabétique.

en: `'natural'`: Natural order, so that e.g. `file2.md` comes before `file10.md`.
fr: `'natural'`: Ordre naturel, de sorte que par exemple `file2.md` vient avant `file10.md`.

en: **Order by**:
fr: **Sujet de l'ordre**:

en: `'path'` (default): Order by full file path.
fr: `'path'` (par défaut): Ordre par chemin de fichier complet.

en: `'name'`: Order by file name only.
fr: `'name'`: Ordre par nom de fichier uniquement.

en: A combination of an optional prefix hyphen to denote ascending order and one of the following values in the form `[-]<value>` where `<value>` is one of:
fr: Une combinaison d'un trait d'union préfixe optionnel pour indiquer l'ordre ascendant et l'une des valeurs suivantes sous la forme `[-]<value>` où `<value>` est l'une de:

en: `'size'`: Order by file size.
fr: `'size'`: Ordre par taille de fichier.

en: `'mtime'`: Order by file modification time.
fr: `'mtime'`: Ordre par heure de modification du fichier.

en: `'ctime'`: Order by file creation time (or the last metadata change time on Unix systems).
fr: `'ctime'`: Ordre par heure de création du fichier (ou la dernière heure de changement de métadonnées sur les systèmes Unix).

en: `'atime'`: Order by file last access time.
fr: `'atime'`: Ordre par dernière heure d'accès au fichier.

en: `'random'`: Random order.
fr: `'random'`: Ordre aléatoire.

en: `'system'`: Order provided by the operating system. This is the same as not specifying any order and relying on the default order of the filesystem. This may be different between operating systems, so use it with care.
fr: `'system'`: Ordre fourni par le système d'exploitation. C'est la même chose que de ne spécifier aucun ordre et de se fier à l'ordre par défaut du système de fichiers. Cela peut être différent entre les systèmes d'exploitation, alors utilisez-le avec précaution.

en: <a name="include_order" href="#include_order">#</a> **order** (*'alpha-path'*): Define the order in which multiple files are included when using globs. Possible values are:
fr: <a name="include_order" href="#include_order">#</a> **order** (*'alpha-path'*): Définit l'ordre dans lequel plusieurs fichiers sont inclus lors de l'utilisation de globs. Les possibles valeurs sont:

en: `'extension'`: Order by file extension.
fr: `'extension'`: Ordre par extension de fichier.

en: A combination of an optional order type and an optional order by separated by a hyphen (`-`), and optionally prefixed by a hyphen (`-`) to indicate ascending order. If an order type or an order by is not specified, the defaults are used. It follows the form: `[-]<order_type>-<order_by>` where:
fr: Une combinaison d'un type de commande optionnel et d'un sujet de commande optionnel séparés par un trait d'union (`-`), et éventuellement précédés par un trait d'union (`-`) pour indiquer l'ordre ascendant. Si un type d'ordre ou un sujet d'ordre n'est pas spécifié, les valeurs par défaut sont utilisées. Il suit la forme: `[-]<type_d'ordre>-<sujet_d'ordre>` où:

en: Common arguments
fr: Arguments communs
