✨ feat(shortcodes): add remote_text shortcode (#305)

content/blog/shortcodes/index.es.md

@@ -1,7 +1,7 @@
 +++
 title = "Shortcodes personalizados"
 date = 2023-02-19
-updated = 2024-03-20
+updated = 2024-05-02
 description = "Este tema incluye algunos shortcodes personalizados útiles que puedes utilizar para mejorar tus publicaciones. Puedes mostrar imágenes que se adapten a los temas claro y oscuro, dar formato a una sección de referencias con un aspecto profesional, y más."
 
 [taxonomies]
@@ -98,6 +98,32 @@ Todos los otros shortcodes de imágenes pueden usar el ancho completo asignando
 
 ## Shortcodes de texto
 
+### Texto remoto
+
+Añade texto desde una URL remota o un archivo local.
+
+**Importante**:
+
+- **Archivos remotos VS archivos locales**: Si `src` empieza con "http", se tratará como un archivo remoto. De lo contrario, se asume que es una ruta de archivo local.
+- **Acceso a archivos**: Dado que utiliza la función [`load_data`](https://www.getzola.org/documentation/templates/overview/#load-data) de Zola, los archivos locales deben estar dentro del directorio de Zola —ver la [lógica de búsqueda de archivos](https://www.getzola.org/documentation/templates/overview/#file-searching-logic).
+- **Formateo de bloques de código**: Para mostrar el texto como un bloque de código, debes añadir manualmente las cercas de código Markdown (comillas invertidas) y, opcionalmente, especificar el lenguaje de programación para el resaltado sintáctico.
+
+#### Uso
+
+Añade un script de Python remoto dentro de un bloque de código con resaltado sintáctico:
+
+````
+```python
+{{/* remote_text(src="https://example.com/script.py") */}}
+```
+````
+
+Visualización de texto de un archivo local:
+
+```
+{{/* remote_text(src="ruta/a/archivo.txt") */}}
+```
+
 ### Advertencias
 
 Destaca información con estos shortcodes. Hay cinco tipos (`type`): `note`, `tip`, `info`, `warning`, y `danger`.