Pour intégrer une vidéo il est nécessaire qu'elle soit préalablement en ligne sur une plateforme spécialisée : YouTube, Viméo, PeerTube, etc.
Vous pouvez alors utiliser l'action {{video}} disponible dans les composants.
Par défaut, ce composant vous propose deux paramètres.
Serveur de la vidéo – Vous pouvez choisir le serveur sur lequel se trouve la vidéo parmi PeerTube, Vimeo et Youtube.
Identifiant de la vidéo – Il ne sʼagit pas de lʼURL complète de la vidéo. Le plus souvent, c'est la série de chiffres et lettres placée en fin d'URL. Par exemple, dans https://www.youtube.com/watch?v=TNPnia5UCKk, lʼidentifiant de la vidéo est TNPnia5UCKk.
En cochant la case « paramètres avancés », vous pouvez faire afficher plus de paramètres.
Instance du serveur PeerTube – Ce paramètre nʼest présent que si vous avez choisi PeerTube en tant que serveur de la vidéo.
Ratio de la vidéo – Vous pouvez préciser le ratio qui vous convient pour afficher la vidéo.
Largeur maximale – Par défaut, la vidéo sera affichée sur toute la largeur disponible. Si vous le souhaitez, ce paramètre vous permet de préciser la largeur maximale sur laquelle la vidéo sera affichée. Attention, cette largeur doit être saisie en nombre de pixels (par exemple : 500). Vous ne pouvez utiliser de pourcentage pour exprimer cette largeur maximale.
Hauteur maximale – Par défaut, la hauteur dʼaffichage de la vidéo sera calculée automatiquement en fonction de la largeur disponible (de manière à conserver les proportions, ou ratio, initiales de la vidéo). Ce paramètre vous permet, si vous le souhaitez, de fixer la hauteur maximale dʼaffichage de la vidéo. Attention, cette hauteur doit être saisie en nombre de pixels (par exemple : 500). Vous ne pouvez utiliser de pourcentage pour exprimer cette hauteur maximale.
Position de la vidéo – Ce paramètre ne prend effet que si vous avez précisé une largeur maximale inférieure à la largeur dʼaffichage disponible. Si vous spécifiez que la position de la vidéo doit être à droite, et qu'il reste de la place à gauche de celle-ci, alors YesWiki commencera à afficher le texte suivant la vidéo à gauche de celle-ci. Et réciproquement pour un choix dʼaffichage de la vidéo à gauche, le texte viendra à droite, sʼil reste de la place.
Une autre méthode consiste à intégrer la vidéo en utilisant un iframe. Cependant l'action {{video}} vous permet un affichage responsive (c'est à dire qui sʼadapte à la taille de la fenêtre).
