diff options
Diffstat (limited to 'content/overview-rich-content')
| -rw-r--r-- | content/overview-rich-content/index.es.md | 182 | ||||
| -rw-r--r-- | content/overview-rich-content/index.fr.md | 116 | ||||
| -rw-r--r-- | content/overview-rich-content/index.md | 30 |
3 files changed, 282 insertions, 46 deletions
diff --git a/content/overview-rich-content/index.es.md b/content/overview-rich-content/index.es.md new file mode 100644 index 0000000..fdafd67 --- /dev/null +++ b/content/overview-rich-content/index.es.md @@ -0,0 +1,182 @@ ++++ +date = 2021-05-15T15:00:00Z +description = "Una breve descripción de Shortcodes personalizados para Zola que implementan elementos html modernos: video, imagen, gif, audio." +draft = false +title = "Contenido enriquecido" + +[extra] +keywords = "Images, Videos, Audio, Gif, Rich Content, Shortcodes" +series = "Features" +toc = true + +[taxonomies] +tags = [ + "Features", + "Video", + "Audio", + "Images", + "Shortcodes", +] ++++ +Se incluyen varios shortcodes personalizados para aumentar CommonMark. `video` los shortcodes `image`, `gif` y `audio` se crearon para ayudarle a aprovechar los elementos HTML modernos en sus escritos. + +<!-- more --> + +## Vídeo + +- `sources` es una matriz de rutas de archivos de vídeo. (obligatorio) +- `class` establece una clase para el vídeo. +- `caption` establece el texto del pie de foto debajo del vídeo. +- `w` define la anchura del vídeo. +- `h` define la altura del vídeo. +- `autoplay` si está activado, el vídeo se reproduce automáticamente al cargarse. +- `loop` si está activado, reproduce el vídeo en bucle. +- `muted` cuando está activado, silencia el audio inicialmente. +- `playsinline` si está configurado, reproduce el vídeo incrustado en lugar de a pantalla completa en navegadores móviles. + +*Las fuentes pueden ser la misma ruta, la ruta relativa o la ruta raíz, como el [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* + +**Clases opcionales:** + +- `ci` se puede utilizar para centrar la imagen. +- `fr` se puede utilizar para flotar la imagen a la derecha. +- `fl` se puede utilizar para flotar la imagen a la izquierda. +- `b1` se puede utilizar para añadir un borde de 1px. + +### Uso + +```rs +{{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} +``` + +### Salida + +```html +{{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} +``` + +{{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} + +### Uso + +```rs +{{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="¡Son más de 9000!") */}} +``` + +### Salida + +```html +{{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="¡Son más de 9000!") }} +``` + +{{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") }} + +## Imagen + +El shortcode `image` devuelve una etiqueta `<picture>` con múltiples fuentes. + +Cada cadena en la matriz `sources` debe ser una ruta a un archivo de imagen de un tipo diferente (`avif`, `webp`, `png`, `jpg`, etc). +La última imagen en la matriz `sources` se utiliza para crear una etiqueta `<img>` para que el navegador recurra a ella si los otros formatos aún no son compatibles. + +- `sources` es una matriz de rutas de archivos de imagen. (obligatorio) +- `class` establece una clase para la imagen. +- `caption` establece el texto del pie de foto debajo de la imagen. +- `w` establece el ancho de la imagen. +- `h` establece la altura de la imagen. + +*Las fuentes pueden ser la misma ruta, la ruta relativa o la ruta raíz, como el [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* + +**Clases opcionales:** + +- `ci` se puede utilizar para centrar la imagen. +- `fr` se puede utilizar para flotar la imagen a la derecha. +- `fl` se puede utilizar para flotar la imagen a la izquierda. +- `b1` se puede utilizar para añadir un borde de 1px. + +### Uso + +```rs +{{/* image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="¡ES MÁS DE 9000!") */}} +``` + +### Salida + +```html +{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="¡ES MÁS DE 9000!") }} +``` + +{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") }} + +## GIF + +El shortcode `gif` es exactamente igual que el [shortcode video](#video). +La única diferencia es que automáticamente tiene las propiedades adicionales: `autoplay`, `loop`, `muted`, `playsinline`. + +El uso de la etiqueta `<video>` en lugar de gifs permite reducir el tamaño de los archivos, +lo cual es especialmente importante en regiones donde Internet es más lento o +menos fiable. + +### Utilización + +```rs +{{/* gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} +``` + +### Salida + +```html +{{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} +``` + +{{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} + +## Audio + +El shortcode `audio` toma una matriz `sources` de cadenas y devuelve una etiqueta +`<audio>`. Cada cadena de la matriz `sources` debe ser una ruta a un archivo de audio +de un tipo diferente (`ogg`, `mp3`, `flac`, `wav`, etc). +El navegador reproducirá el primer tipo que admita, por lo que colocarlos en orden de menor a mayor tamaño utilizará el menor ancho de banda si ese es su objetivo. + +- `sources` es un array de rutas de archivos. (obligatorio) +- `class` establece una clase para el audio. +- `caption` establece el texto del título debajo del audio. +- `autoplay` cuando se establece, reproduce automáticamente el audio al cargar. +- `loop` cuando se establece, reproduce el audio en bucle. +- `muted` cuando se establece, establece el audio silenciado inicialmente. + +*Las fuentes pueden ser la misma ruta, la ruta relativa o la ruta raíz, como el [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* + +**Clases opcionales:** + +- `ci` se puede utilizar para centrar la imagen. +- `fr` se puede utilizar para flotar la imagen a la derecha. +- `fl` se puede utilizar para flotar la imagen a la izquierda. +- `b1` se puede utilizar para añadir un borde de 1px. + +### Uso + +```rs +{{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) */}} +``` + +### Salida + +```html +{{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) }} +``` + +{{ audio(sources=["over9000.ogg", "over9000.mp3"]) }} + +### Uso + +```rs +{{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="¡Son más de 9000!!") */}} +``` + +### Salida + +```html +{{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="¡Son más de 9000!") }} +``` + +{{ audio(sources=["over9000.ogg", "over9000.mp3"] class="ci b1" caption="It's Over 9000!!") }} diff --git a/content/overview-rich-content/index.fr.md b/content/overview-rich-content/index.fr.md index 77cc21c..acd9374 100644 --- a/content/overview-rich-content/index.fr.md +++ b/content/overview-rich-content/index.fr.md @@ -1,8 +1,8 @@ +++ date = 2021-05-15T15:00:00Z -description = "Une brève description des Shortcodes personnalisés pour Zola qui implémentent des éléments html modernes : vidéo, image, gif, audio." +description = "Une brève description des shortcodes personnalisés pour Zola qui mettent en œuvre des éléments html modernes : vidéo, image, gif, audio." draft = false -title = "Contenu riche" +title = "Un contenu riche" [extra] keywords = "Images, Videos, Audio, Gif, Rich Content, Shortcodes" @@ -18,135 +18,165 @@ tags = [ "Shortcodes", ] +++ -Plusieurs codes abrégés personnalisés sont inclus pour augmenter CommonMark. `video`, `image`, `gif`, et `audio` ont été créés pour vous aider à tirer parti des éléments HTML modernes dans votre écriture. +Plusieurs shortcodes personnalisés sont inclus pour améliorer CommonMark. `video` les shortcodes `image`, `gif` et `audio` ont été créés pour vous aider à tirer parti des éléments HTML modernes dans vos écrits. <!-- more --> ## Vidéo -- `sources` sont un tableau de chemins de fichiers vidéo. (obligatoire) +- `sources` est un tableau de chemins d'accès aux fichiers vidéo. (obligatoire) - `class` définit une classe pour la vidéo. - `caption` définit le texte de la légende sous la vidéo. - `w` définit la largeur de la vidéo. - `h` définit la hauteur de la vidéo. -- `autoplay` lorsqu'il est défini sur "true", lit automatiquement la vidéo au chargement. -- `loop` lorsqu'il est défini sur "true", lit la vidéo en boucle. -- `muted` lorsqu'il est défini sur "true", règle le son initialement coupé. +- `autoplay` lorsque cette option est activée, la vidéo s'affiche automatiquement au chargement. +- `loop` lorsque cette option est activée, la vidéo est lue en boucle. +- `muted` lorsque cette option est activée, le son est initialement coupé. +- `playsinline` lorsque cette option est activée, la vidéo est lue en mode intégré plutôt qu'en mode plein écran sur les navigateurs mobiles. -** les sources peuvent être le même chemin, un chemin relatif ou un chemin racine, comme le [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*les sources peuvent être le même chemin, le chemin relatif ou le chemin racine, comme le [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* -**Cours optionnels:** +**Classes optionnelles :** - `ci` peut être utilisé pour centrer l'image. - `fr` peut être utilisé pour faire flotter l'image à droite. -- `fl` peut être utilisé pour faire flotter l'image vers la gauche. +- `fl` peut être utilisé pour faire flotter l'image à gauche. - `b1` peut être utilisé pour ajouter une bordure de 1px. -### Usage +### Utilisation + ```rs {{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} ``` -### Sortir + +### Sortie + ```html {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ``` + {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} -### Usage +### Utilisation + ```rs {{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") */}} ``` -### Sortir + +### Sortie + ```html {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") }} ``` + {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") }} ## Image Le shortcode `image` renvoie une balise `<picture>` avec plusieurs sources. -Chaque chaîne du tableau `sources` doit être un chemin vers un fichier image d'un type différent (`avif`, `webp`, `png`, `jpg`, etc.). - La dernière image du tableau `sources` est utilisée pour créer une balise `<img>` sur laquelle le navigateur pourra s'appuyer si les autres formats ne sont pas encore pris en charge. +Chaque chaîne du tableau `sources` doit être un chemin vers un fichier image d'un type différent (`avif`, `webp`, `png`, `jpg`, etc). +La dernière image du tableau `sources` est utilisée pour créer une balise `<img>` sur laquelle le navigateur peut se rabattre si les autres formats ne sont pas encore pris en charge. -- `sources` sont un tableau de chemins de fichiers image. (obligatoire) +- `sources` est un tableau de chemins d'accès aux fichiers d'images. (obligatoire) - `class` définit une classe pour l'image. - `caption` définit le texte de la légende sous l'image. - `w` définit la largeur de l'image. - `h` définit la hauteur de l'image. -** les sources peuvent être le même chemin, un chemin relatif ou un chemin racine, comme le [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*les sources peuvent être le même chemin, le chemin relatif ou le chemin racine, comme le [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* -**Cours optionnels:** +**Classes optionnelles :** - `ci` peut être utilisé pour centrer l'image. - `fr` peut être utilisé pour faire flotter l'image à droite. -- `fl` peut être utilisé pour faire flotter l'image vers la gauche. +- `fl` peut être utilisé pour faire flotter l'image à gauche. - `b1` peut être utilisé pour ajouter une bordure de 1px. -### Usage +### Utilisation + ```rs -{{/* image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"], w=640, h=480, alt="ITS OVER 9000!") */}} +{{/* image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") */}} ``` -### Sortir + +### Sortie + ```html -{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"], w=640, h=480, alt="ITS OVER 9000!") }} +{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") }} ``` -{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"], w=640, h=480, alt="ITS OVER 9000!") }} + +{{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") }} ## GIF -Le `gif` shortcode est exactement le même que le [shortcode vidéo][#video]. - La seule différence est qu'il possède automatiquement les propriétés supplémentaires: `autoplay`, `loop`, `muted`, `playsinline`. +Le shortcode `gif` est exactement le même que le [shortcode vidéo](#video). +La seule différence est qu'il possède automatiquement les propriétés supplémentaires : `autoplay`, `loop`, `muted`, `playsinline`. -L'utilisation de la `<video>` balise à la place des gifs permet de réduire la taille des fichiers, ce qui est particulièrement important dans les régions où Internet est plus lent ou moins fiable. +L'utilisation de la balise `<video>` à la place des gifs permet de réduire la taille des fichiers, +, ce qui est particulièrement important dans les régions où l'internet est plus lent ou +moins fiable. + +### Utilisation -### Usage ```rs {{/* gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} ``` -### Sortir + +### Sortie + ```html {{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ``` + {{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} -## l'audio +## Audio -Le `audio` shortcode prend un `sources` tableau de chaînes et renvoie une `<audio>` balise. Chaque chaîne du `sources` tableau doit être un chemin vers un fichier audio d'un type différent (`ogg`, `mp3`, `flac`, `wav`, etc). Le navigateur jouera le premier type qu'il prend en charge, donc les placer dans l'ordre de la taille la plus petite à la plus grande utilisera le moins de bande passante si tel est votre objectif. +Le shortcode `audio` prend un tableau de chaînes `sources` et renvoie une balise +`<audio>`. Chaque chaîne du tableau `sources` doit être un chemin vers un fichier audio +d'un type différent (`ogg`, `mp3`, `flac`, `wav`, etc). +Le navigateur lira le premier type qu'il prend en charge, donc les placer dans l'ordre de la taille la plus petite à la plus grande utilisera le moins de bande passante si c'est votre objectif. -- `sources` est un tableau de chemins de fichiers. (obligatoire) +- `sources` est un tableau de chemins d'accès aux fichiers. (obligatoire) - `class` définit une classe pour l'audio. - `caption` définit le texte de la légende sous l'audio. -- `autoplay` lorsqu'il est défini, lit automatiquement l'audio au chargement. -- `loop` lorsqu'il est défini, lit l'audio en boucle. -- `muted` lorsqu'il est défini, définit le son initialement coupé. +- `autoplay` lorsque cette option est activée, l'audio s'affiche automatiquement au chargement. +- `loop` lorsque cette option est activée, l'audio est lu en boucle. +- `muted` lorsqu'il est défini, met l'audio en sourdine au départ. -** les sources peuvent être le même chemin, un chemin relatif ou un chemin racine, comme le [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*les sources peuvent être le même chemin, un chemin relatif ou le chemin de la racine, comme le [shortcode img](https://abridge.pages.dev/overview-images/#img-shortcode)* -**Cours optionnels:** +**Classes optionnelles :** - `ci` peut être utilisé pour centrer l'image. - `fr` peut être utilisé pour faire flotter l'image à droite. -- `fl` peut être utilisé pour faire flotter l'image vers la gauche. +- `fl` peut être utilisé pour faire flotter l'image à gauche. - `b1` peut être utilisé pour ajouter une bordure de 1px. -### Usage +### Utilisation + ```rs {{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) */}} ``` -### Sortir + +### Sortie + ```html {{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) }} ``` + {{ audio(sources=["over9000.ogg", "over9000.mp3"]) }} -### Usage +### Utilisation + ```rs {{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="It's Over 9000!!") */}} ``` -### Sortir + +### Sortie + ```html {{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="It's Over 9000!!") }} ``` + {{ audio(sources=["over9000.ogg", "over9000.mp3"] class="ci b1" caption="It's Over 9000!!") }} diff --git a/content/overview-rich-content/index.md b/content/overview-rich-content/index.md index c33b7cd..6049768 100644 --- a/content/overview-rich-content/index.md +++ b/content/overview-rich-content/index.md @@ -34,7 +34,7 @@ Several custom shortcodes are included to augment CommonMark. `video`, `image`, - `muted` when set, sets the audio muted initially. - `playsinline` when set, plays the video embeded instead of fullscreen on mobile browsers. -** sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode)* **Optional Classes:** @@ -44,23 +44,31 @@ Several custom shortcodes are included to augment CommonMark. `video`, `image`, - `b1` can be used to add a 1px border. ### Usage + ```rs {{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} ``` + ### Output + ```html {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ``` + {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ### Usage + ```rs {{/* video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") */}} ``` + ### Output + ```html {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") }} ``` + {{ video(sources=["over9000_av1.mp4", "over9000_vp9.webm"] muted="true" class="ci b1" caption="It's Over 9000!!") }} ## Image @@ -76,7 +84,7 @@ Each string in the `sources` array should be a path to an image file of a differ - `w` sets the width of the image. - `h` sets the height of the image. -** sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode)* **Optional Classes:** @@ -86,13 +94,17 @@ Each string in the `sources` array should be a path to an image file of a differ - `b1` can be used to add a 1px border. ### Usage + ```rs {{/* image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") */}} ``` + ### Output + ```html {{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") }} ``` + {{ image(sources=["over9000-960.avif", "over9000-640.avif", "over9000-400.avif", "over9000-640.webp"] w=640 h=480 alt="ITS OVER 9000!") }} ## GIF @@ -105,13 +117,17 @@ which is especially important in regions where internet is slower or less reliable. ### Usage + ```rs {{/* gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) */}} ``` + ### Output + ```html {{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ``` + {{ gif(sources=["over9000_av1.mp4", "over9000_vp9.webm"]) }} ## Audio @@ -128,7 +144,7 @@ The browser will play the first type it supports, so placing them in order of si - `loop` when set, plays the audio on a loop. - `muted` when set, sets the audio muted initially. -** sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode) ** +*sources can be same path, relative path, or root path, like the [img shortcode](https://abridge.pages.dev/overview-images/#img-shortcode)* **Optional Classes:** @@ -138,21 +154,29 @@ The browser will play the first type it supports, so placing them in order of si - `b1` can be used to add a 1px border. ### Usage + ```rs {{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) */}} ``` + ### Output + ```html {{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"]) }} ``` + {{ audio(sources=["over9000.ogg", "over9000.mp3"]) }} ### Usage + ```rs {{/* audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="It's Over 9000!!") */}} ``` + ### Output + ```html {{ audio(sources=["over9000.ogg", "over9000.mp3", "over9000.flac", "over9000.wav"] class="ci b1" caption="It's Over 9000!!") }} ``` + {{ audio(sources=["over9000.ogg", "over9000.mp3"] class="ci b1" caption="It's Over 9000!!") }} |