en to es translation catalogue (63 entries)

en: Mkdocs Markdown includer plugin.
es: Plugin de inclusiones Markdown para Mkdocs.

en: Installation
es: Instalación

en: Documentation
es: Documentación

en: Setup
es: Preparación

en: Enable the plugin in your `mkdocs.yml`:
es: Habilita el plugin en tu `mkdocs.yml`:

en: Reference
es: Referencia

en: Includes Markdown files content, optionally using two delimiters to filter the content to include.
es: Incluye contenido de archivos Markdown, opcionalmente usando dos delimitadores para filtrar el contenido a incluir.

en: Acknowledgment
es: Agradecimiento

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].
es: [Joe Rickerby] y [contribuidores] por [darme los permisos][cibuildwheel-470] para [separar este plugin][cibuildwheel-475] de la documentación de [cibuildwheel][cibuildwheel-repo-link].

en: Read this document in other languages:
es: Lee este documento en otros idiomas:

en: This plugin provides two directives, one to include Markdown files and another to include files of any type.
es: Este plugin provee dos directivas, una para incluir archivos Markdown y otra para incluir archivos de cualquier tipo.

en: Includes the content of a file or a group of files.
es: Incluye el contenido de un archivo o un grupo de archivos.

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`.
es: <a name="include-markdown_rewrite-relative-urls" href="#include-markdown_rewrite-relative-urls">#</a> **rewrite-relative-urls** (*true*): Cuando esta opción está habilitada (por defecto), los enlaces e imágenes Markdown en el contenido que están definidas mediante una URL relativa son rescritos para funcionar correctamente en su nueva localización. Los valores posibles son `true` y `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`.
es: <a name="include-markdown_comments" href="#include-markdown_comments">#</a> **comments** (*false*): Cuando esta opción está habilitada, el contenido a incluir es envuelto por comentarios `<!-- BEGIN INCLUDE -->` y `<!-- END INCLUDE -->` que ayudan a identificar que el contenido ha sido incluido. Los valores posibles son `true` y `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.
es: <a name="include-markdown_heading-offset" href="#include-markdown_heading-offset">#</a> **heading-offset** (0): Incrementa o disminuye la profundidad de encabezados Markdown por el número especificado. Sólo soporta la sintaxis de encabezado de caracteres de hash (`#`). Acepta valores negativos para eliminar caracteres `#` a la izquierda.

en: <a name="include_start" href="#include_start">#</a> **start**: Delimiter that marks the beginning of the content to include.
es: <a name="include_start" href="#include_start">#</a> **start**: Delimitador que marca el comienzo del contenido a incluir.

en: <a name="include_end" href="#include_end">#</a> **end**: Delimiter that marks the end of the content to include.
es: <a name="include_end" href="#include_end">#</a> **end**: Delimitador que marca el final del contenido a incluir.

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`.
es: <a name="include_preserve-includer-indent" href="#include_preserve-includer-indent">#</a> **preserve-includer-indent** (*true*): Cuando esta opción está habilitada (por defecto), cada línea del contenido a incluir es indentada con el mismo número de espacios usados para indentar la plantilla `{% %}` incluidora. Los valores posibles son `true` y `false`.

en: <a name="include_dedent" href="#include_dedent">#</a> **dedent** (*false*): If enabled, the included content will be dedented.
es: <a name="include_dedent" href="#include_dedent">#</a> **dedent** (*false*): Si se habilita, el contenido incluido será dedentado.

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.
es: <a name="include_exclude" href="#include_exclude">#</a> **exclude**: Especifica mediante un glob los archivos que deben ser ignorados. Sólo es útil pasando globs para incluir múltiples archivos.

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`.
es: <a name="include_trailing-newlines" href="#include_trailing-newlines">#</a> **trailing-newlines** (*true*): Cuando esta opción está deshabilitada, los saltos de línea finales que se encuentran en el contenido a incluir se eliminan. Los valores posibles son `true` y `false`.

en: The arguments **start** and **end** may contain usual (Python-style) escape sequences like `\n` to match against newlines.
es: Las cadenas **start** y **end** pueden contener caracteres usuales de secuencias de escape (al estilo Python) como `\n` para hacer coincidir contra caracteres de salto de línea.

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 `\'`.
es: Las rutas de archivo para incluir y los argumentos de cadena se pueden envolver con comillas dobles `"` o simples `'`, que se pueden escapar anteponiendo un carácter `\` como `\"` y `\'`.

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.
es: <a name="include_encoding" href="#include_encoding">#</a> **encoding** (*'utf-8'*): Especifica la codificación del archivo incluído. Si no se define, se usará `'utf-8'`.

en: Configuration
es: Configuración

en: The global behaviour of the plugin can be customized in the configuration.
es: El comportamiento global del plugin puede ser personalizado en la configuración.

en: Most of the settings will define the default values passed to arguments of directives and are documented in the [reference](#reference).
es: La mayoría de los parámetros de configuración definirán los valores por defecto pasados a los argumentos de las directivas y están documentados en la [referencia](#referencia).

en: Paths of included files can be either:
es: Las rutas de los archivos a incluir pueden ser:

en: URLs to include remote content.
es: URLs para incluir contenido remoto.

en: Local files:
es: Archivos locales:

en: Absolute paths (starting with a path separator).
es: Rutas absolutas (comenzando con un separador de rutas).

en: [Bash wildcard globs] matching multiple local files.
es: [Patrones glob de Bash] que coincidan con múltiples archivos locales.

en: Relative from the file that includes them (starting with `./` or `../`).
es: Relativas desde el archivo que las incluye (empezando por `./` o `../`).

en: `opening_tag` and `closing_tag`
es: `opening_tag` y `closing_tag`

en: Default opening and closing tags. When not specified they are `{%` and `%}`.
es: Etiquetas de apertura y cierre por defecto. Cuando no se especifican son `{%` y `%}`.

en: Global exclusion wildcard patterns. Relative paths defined here will be relative to the [`docs_dir`] directory.
es: Patrones de comodín de exclusión globales. Las rutas relativas definidas aquí serán relativas al directorio [`docs_dir`].

en: Expiration time in seconds for cached HTTP requests when including from URLs.
es: Tiempo de caducidad en segundos para las solicitudes HTTP almacenadas en caché al incluir desde URL.

en: Examples
es: Ejemplos

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*.
es: Relativo al directorio [`docs_dir`]. Por ejemplo, si tu `docs_dir` es _./docs/_, entonces `includes/header.md` coincidirá con el archivo *_./docs/includes/header.md_*.

en: [Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
es: [Patrones glob de 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`.
es: <a name="include_recursive" href="#include_recursive">#</a> **recursive** (*true*): Cuando esta opción está deshabilitada, los archivos incluidos no son procesados para incluir de forma recursiva. Los valores posibles son `true` y `false`.

en: [contributors]: https://github.com/mondeja/mkdocs-include-markdown-plugin/graphs/contributors
es: [contribuidores]: https://github.com/mondeja/mkdocs-include-markdown-plugin/graphs/contributors

en: Customize the names of the directives.
es: Personaliza los nombres de las directivas.

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:
es: Para poder utilizar esta función, se debe instalar la dependencia [platformdirs] o definir la configuración [`cache_dir`](#cache_dir). Puedes incluir [platformdirs] en la instalación del plugin agregando el extra `cache`:

en: Directory where cached HTTP requests will be stored. If set, [platformdirs] is not needed to be installed to use [`cache`](#cache).
es: Directorio donde se almacenarán las solicitudes HTTP en caché. Si se configura, no es necesario instalar [platformdirs] para usar [`cache`](#cache).

en: A *.gitignore* file will be added to the cache directory if not exists to avoid committing the cache files.
es: Se agregará un archivo *.gitignore* al directorio de caché si no existe para evitar confirmar los archivos de caché.

en: **Order type**:
es: **Tipo de orden**:

en: `'alpha'` (default): Alphabetical order.
es: `'alpha'` (por defecto): Orden alfabético.

en: `'natural'`: Natural order, so that e.g. `file2.md` comes before `file10.md`.
es: `'natural'`: Orden natural, de modo que por ejemplo `file2.md` va antes `file10.md`.

en: **Order by**:
es: **Sujeto de ordenación**:

en: `'path'` (default): Order by full file path.
es: `'path'` (por defecto): Ordena por la ruta completa del archivo.

en: `'name'`: Order by file name only.
es: `'name'`: Ordena sólo por el nombre del archivo.

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:
es: Una combinación de un guion opcional al principio para denotar orden ascendente y uno de los siguientes valores en la forma `[-]<valor>` donde `<valor>` es uno de los siguientes:

en: `'size'`: Order by file size.
es: `'size'`: Ordena por el tamaño del archivo.

en: `'mtime'`: Order by file modification time.
es: `'mtime'`: Ordena por la hora de modificación del archivo.

en: `'ctime'`: Order by file creation time (or the last metadata change time on Unix systems).
es: `'ctime'`: Ordena por la hora de creación del archivo (o la última hora de cambio de metadatos en sistemas Unix).

en: `'atime'`: Order by file last access time.
es: `'atime'`: Ordena por la última hora de acceso al archivo.

en: `'random'`: Random order.
es: `'random'`: Orden aleatorio.

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.
es: `'system'`: Orden proporcionado por el sistema operativo. Esto es lo mismo que no especificar ningún orden y confiar en el orden por defecto del sistema de archivos. Esto puede ser diferente entre sistemas operativos, así que úsalo con precaución.

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:
es: <a name="include_order" href="#include_order">#</a> **order** (*'alpha-path'*): Define el orden en el que múltiples archivos son incluidos al usar globs. Los posibles valores son:

en: `'extension'`: Order by file extension.
es: `'extension'`: Ordena por la extensión del archivo.

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:
es: Una combinación de un tipo de orden opcional y un sujeto de ordenación opcional separados por un guion (`-`), y opcionalmente precedidos por un guion (`-`) para indicar orden ascendente. Si no se especifica un tipo de orden o un sujeto de ordenación, se usan los valores por defecto. Sigue la forma: `[-]<tipo_de_orden>-<sujeto_de_ordenación>` donde:

en: Common arguments
es: Argumentos comunes
