22
33Plugin de inclusiones Markdown para Mkdocs.
44
5- [ ![ PyPI] [ pypi-version-badge-link ]] [ pypi-link ]
6- [ ![ Tests] [ tests-image ]] [ tests-link ] [ ![ Coverage
7- status] [ coverage-image ]] [ coverage-link ]
5+ [ ![ PyPI] [ pypi-version-badge-link ]] [ pypi-link ] [ ![ Tests] [ tests-image ]] [ tests-link ]
6+ [ ![ Coverage status] [ coverage-image ]] [ coverage-link ]
87
98> Lee este documento en otros idiomas:
109>
@@ -35,8 +34,9 @@ entrar en conflicto, como [`mkdocs-macros-plugin`][mkdocs-macros-plugin-link].
3534
3635El comportamiento global del plugin puede ser personalizado en la configuración.
3736
38- - <a name="config_tags" href="#config_tags">#</a> **opening_tag** and **closing_tag**:
39- Las etiquetas de apertura y cierre. Por defecto son `{%` y `%}`.
37+ - <a name="config_tags" href="#config_tags">#</a> **opening_tag** and
38+ **closing_tag**: Las etiquetas de apertura y cierre. Por defecto son `{%` y
39+ ` %}` .
4040
4141El resto de las opciones definirán los valores por defecto pasados a los
4242argumentos de las directivas y están documentados en la [referencia](#reference).
@@ -55,8 +55,8 @@ plugins:
5555
5656# ## Referencia
5757
58- Este plugin provee dos directivas, una para incluir archivos Markdown y otra
59- para incluir archivos de cualquier tipo.
58+ Este plugin provee dos directivas, una para incluir archivos Markdown y otra para
59+ incluir archivos de cualquier tipo.
6060
6161Las rutas de los archivos incluidos pueden ser absolutas o relativas a la ruta
6262del archivo que las incluye. Este argumento también acepta globs, en cuyo caso
@@ -75,45 +75,45 @@ salto de línea
7575Incluye contenido de archivos Markdown, opcionalmente usando dos delimitadores
7676para filtrar el contenido a incluir.
7777
78- - <a name="include-markdown_start" href="#include-markdown_start">#</a> **start**:
79- Delimitador que marca el comienzo del contenido a incluir.
78+ - <a name="include-markdown_start" href="#include-markdown_start">#</a>
79+ **start**: Delimitador que marca el comienzo del contenido a incluir.
8080- <a name="include-markdown_end" href="#include-markdown_end">#</a> **end**:
8181Delimitador que marca el final del contenido a incluir.
8282- <a name="include-markdown_preserve-includer-indent"
83- href="#include-markdown_preserve-includer-indent">#</a> **preserve-includer-indent**
84- (*true*) : Cuando esta opción está habilitada (por defecto), cada línea del
85- contenido a incluir es indentada con el mismo número de espacios usados para
86- indentar la plantilla `{% %}` incluidora. Los valores posibles son `true` y
87- ` false` .
88- - <a name="include-markdown_dedent" href="#include-markdown_dedent">#</a> **dedent**
89- (*false*) : Si se habilita, el contenido incluido será dedentado.
90- - <a name="include-markdown_exclude" href="#include-markdown_exclude">#</a> **exclude**:
91- Expecifica mediante un glob los archivos que deben ser ignorados. Sólo es útil
92- pasando globs para incluir múltiples archivos.
83+ href="#include-markdown_preserve-includer-indent">#</a>
84+ **preserve-includer-indent** (*true*): Cuando esta opción está habilitada (por
85+ defecto), cada línea del contenido a incluir es indentada con el mismo número de
86+ espacios usados para indentar la plantilla `{% %}` incluidora. Los valores
87+ posibles son `true` y `false`.
88+ - <a name="include-markdown_dedent" href="#include-markdown_dedent">#</a>
89+ **dedent** (*false*): Si se habilita, el contenido incluido será dedentado.
90+ - <a name="include-markdown_exclude" href="#include-markdown_exclude">#</a>
91+ **exclude**: Expecifica mediante un glob los archivos que deben ser ignorados.
92+ Sólo es útil pasando globs para incluir múltiples archivos.
9393- <a name="include-markdown_trailing-newlines"
94- href="#include-markdown_trailing-newlines">#</a> **trailing-newlines** (*true*):
95- Cuando esta opción está deshabilitada, los saltos de línea finales que se
96- encuentran en el contenido a incluir se eliminan. Los valores posibles son
94+ href="#include-markdown_trailing-newlines">#</a> **trailing-newlines**
95+ (*true*) : Cuando esta opción está deshabilitada, los saltos de línea finales que
96+ se encuentran en el contenido a incluir se eliminan. Los valores posibles son
9797` true` y `false`.
98- - <a name="include-markdown_encoding" href="#include-markdown_encoding">#</a> **encoding**
99- (*utf-8*) : Especifica la codificación del archivo incluído. Si no se define, se
100- usará `utf-8`.
98+ - <a name="include-markdown_encoding" href="#include-markdown_encoding">#</a>
99+ **encoding** (*utf-8*): Especifica la codificación del archivo incluído. Si no
100+ se define, se usará `utf-8`.
101101- <a name="include-markdown_rewrite-relative-urls"
102- href="#include-markdown_rewrite-relative-urls">#</a> **rewrite-relative-urls** (*true*):
103- Cuando esta opción está habilitada (por defecto), los enlaces e imágenes
104- Markdown en el contenido que están definidas mediante una URL relativa son
105- rescritos para funcionar correctamente en su nueva localización. Los valores
102+ href="#include-markdown_rewrite-relative-urls">#</a> **rewrite-relative-urls**
103+ (*true*) : Cuando esta opción está habilitada (por defecto), los enlaces e
104+ imágenes Markdown en el contenido que están definidas mediante una URL relativa
105+ son rescritos para funcionar correctamente en su nueva localización. Los valores
106106posibles son `true` y `false`.
107- - <a name="include-markdown_comments" href="#include-markdown_comments">#</a> **comments**
108- (*true*) : Cuando esta opción está habilitada (por defecto), el contenido a
109- incluir es envuelto por comentarios `<!-- BEGIN INCLUDE -->` y
107+ - <a name="include-markdown_comments" href="#include-markdown_comments">#</a>
108+ **comments** (*true*): Cuando esta opción está habilitada (por defecto), el
109+ contenido a incluir es envuelto por comentarios `<!-- BEGIN INCLUDE -->` y
110110` <!-- END INCLUDE -->` que ayudan a identificar que el contenido ha sido
111111incluido. Los valores posibles son `true` y `false`.
112112- <a name="include-markdown_heading-offset"
113- href="#include-markdown_heading-offset">#</a> **heading-offset** (0): Incrementa
114- o disminuye la profundidad de encabezados Markdown por el número especificado.
115- Sólo soporta la sintaxis de encabezado de caracteres de hash (`#`). Acepta
116- valores negativos para eliminar caracteres `#` a la izquierda.
113+ href="#include-markdown_heading-offset">#</a> **heading-offset** (0):
114+ Incrementa o disminuye la profundidad de encabezados Markdown por el número
115+ especificado. Sólo soporta la sintaxis de encabezado de caracteres de hash
116+ (`#`). Acepta valores negativos para eliminar caracteres `#` a la izquierda.
117117
118118# #### Ejemplos
119119
@@ -164,22 +164,23 @@ marca el comienzo del contenido a incluir.
164164- <a name="include_end" href="#include_end">#</a> **end**: Delimitador que marca
165165el final del contenido a incluir.
166166- <a name="include_preserve-includer-indent"
167- href="#include_preserve-includer-indent">#</a> **preserve-includer-indent** (*true*):
168- Cuando esta opción está habilitada (por defecto), cada línea del contenido a
169- incluir es indentada con el mismo número de espacios usados para indentar la
170- plantilla `{% %}` incluidora. Los valores posibles son `true` y `false`.
167+ href="#include_preserve-includer-indent">#</a> **preserve-includer-indent**
168+ (*true*) : Cuando esta opción está habilitada (por defecto), cada línea del
169+ contenido a incluir es indentada con el mismo número de espacios usados para
170+ indentar la plantilla `{% %}` incluidora. Los valores posibles son `true` y
171+ ` false` .
171172- <a name="include_dedent" href="#include_dedent">#</a> **dedent** (*false*): Si
172173se habilita, el contenido incluido será dedentado.
173- - <a name="include_exclude" href="#include_exclude">#</a> **exclude**:
174- Especifica mediante un glob los archivos que deben ser ignorados. Sólo es útil
175- pasando globs para incluir múltiples archivos.
176- - <a name="include_trailing-newlines" href="#include_trailing-newlines">#</a> **trailing-newlines**
177- (*true*) : Cuando esta opción está deshabilitada, los saltos de línea finales que
178- se encuentran en el contenido a incluir se eliminan. Los valores posibles son
179- ` true` y `false`.
180- - <a name="include_encoding" href="#include_encoding">#</a> **encoding** (*utf-8*):
181- Especifica la codificación del archivo incluído. Si no se define, se usará
182- ` utf-8` .
174+ - <a name="include_exclude" href="#include_exclude">#</a> **exclude**: Especifica
175+ mediante un glob los archivos que deben ser ignorados. Sólo es útil pasando
176+ globs para incluir múltiples archivos.
177+ - <a name="include_trailing-newlines" href="#include_trailing-newlines">#</a>
178+ **trailing-newlines** (*true*): Cuando esta opción está deshabilitada, los
179+ saltos de línea finales que se encuentran en el contenido a incluir se eliminan.
180+ Los valores posibles son `true` y `false`.
181+ - <a name="include_encoding" href="#include_encoding">#</a> **encoding**
182+ (*utf-8*) : Especifica la codificación del archivo incluído. Si no se define,
183+ se usará `utf-8`.
183184
184185# #### Ejemplos
185186
0 commit comments