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

This commit is contained in:
Óscar 2024-05-02 22:57:56 +02:00 committed by GitHub
parent be9458cfad
commit 5bc593b676
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 88 additions and 3 deletions

View file

@ -1,7 +1,7 @@
+++
title = "Shortcodes personalitzats"
date = 2023-02-19
updated = 2024-03-20
updated = 2024-05-02
description = "Aquest tema inclou alguns shortcodes personalitzats útils que pots utilitzar per millorar les teves publicacions. Ja sigui per mostrar imatges que s'adapten als temes clar i fosc, o per donar format a una secció de referències amb un aspecte professional, aquests shortcodes personalitzats t'ajudaran."
[taxonomies]
@ -97,6 +97,32 @@ Tots els altres shortcodes d'imatges poden utilizar l'amplada completa assignant
## Shortcodes de text
### Text remot
Afegeix text des d'una URL remota o un arxiu local.
**Important**:
- **Arxius remots VS arxius locals**: Si `src` comença amb "http", es tractarà com un arxiu remot. D'altra banda, s'assumeix que és una ruta d'arxiu local.
- **Accés a arxius**: Atès que utilitza la funció [`load_data`](https://www.getzola.org/documentation/templates/overview/#load-data) de Zola, els arxius locals han d'estar dins del directori de Zola —vegeu la [lògica de cerca d'arxius](https://www.getzola.org/documentation/templates/overview/#file-searching-logic).
- **Formateig de blocs de codi**: Per mostrar el text com un bloc de codi, has d'afegir manualment les tanques de codi Markdown (cometes inverses) i, opcionalment, especificar el llenguatge de programació per al ressaltat sintàctic.
#### Ús
Afegeix un script de Python remot dins d'un bloc de codi amb ressaltat sintàctic:
````
```python
{{/* remote_text(src="https://example.com/script.py") */}}
```
````
Mostra el text d'un arxiu local:
```
{{/* remote_text(src="ruta/a/arxiu.txt") */}}
```
### Advertències
Destaca informació amb aquests shortcodes. Hi ha cinc tipus (`type`): `note`, `tip`, `info`, `warning`, i `danger`.