mirror of
https://github.com/welpo/tabi.git
synced 2025-10-11 07:46:15 +02:00
✨ feat(shortcodes): add remote_text shortcode (#305)
This commit is contained in:
parent
be9458cfad
commit
5bc593b676
4 changed files with 88 additions and 3 deletions
|
@ -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`.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue