feat(remote_text shortcode): support line ranges (#399)

This commit is contained in:
welpo 2024-09-22 15:06:38 +02:00
parent 90c1da1ddb
commit 008b976e06
No known key found for this signature in database
GPG key ID: A2F978CF4EC1F5A6
4 changed files with 59 additions and 1 deletions

View file

@ -207,6 +207,14 @@ dist/
Afegeix text des d'una URL remota o un arxiu local.
El shortcode accepta tres paràmetres:
- `src`: L'URL d'origen o ruta del fitxer (obligatori)
- `start`: Primera línia a mostrar (opcional, comença a 1)
- `end`: Número de l'última línia (opcional, per defecte és 0, l'última línia)
{{ admonition(type="info", text="`start` i `end` són inclusius. `start=3, end=3` mostrarà només la tercera línia.") }}
**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.
@ -229,6 +237,12 @@ Mostra el text d'un arxiu local:
{{/* remote_text(src="ruta/a/arxiu.txt") */}}
```
Mostreu només les línies 3 a 5 d'un arxiu local:
```
{{/* remote_text(src="ruta/a/arxiu.txt", start=3, end=5) */}}
```
### Advertències
Destaca informació amb aquests shortcodes. Hi ha cinc tipus (`type`): `note`, `tip`, `info`, `warning`, i `danger`.