Comment citer une vidéo ?
@revstifeeva , tu m'as posé la question de comment "embed" une vidéo en RST.
Je pars du principe que ce que tu veux, c'est avoir une image cliquable (ie. le thumbnail de la vidéo), qui renvoie vers le site où est hébergé ladite vidéo.
Voilà comment faire, grâce à la directive image:
.. image:: https://img.youtube.com/vi/nZttMg_n_s0/maxresdefault.jpg
:alt: Introduction to Sphinx Python Document Generation
:target: https://www.youtube.com/watch?v=nZttMg_n_s0
Tu as, dans l'ordre : le lien vers le thumbnail, la description alternative (pour les malvoyants, par exemple), et le lien vers la vidéo elle-même.
- Note que les liens peuvent être distants (comme dans cet exemple), ou locaux (si par exemple tu rajoutes la vidéo directement dans le dépôt ArtAtWar, quoique cette pratique soit probablement à éviter).
- Note aussi que tout ce qu'on a fait, c'est afficher une image et la transformer en lien hypertexte. Donc si tu veux citer une page web arbitraire (pas une vidéo) depuis une image, c'est aussi comme ça que ça se fait.
- Note enfin qu'il faut que tu utilise la même indentation que celle que j'ai utilisée.
Si tu veux donner une légende au thumbnail, il faut utiliser la directive figure:
.. figure:: https://img.youtube.com/vi/nZttMg_n_s0/maxresdefault.jpg
:alt: Introduction to Sphinx Python Document Generation
:target: https://www.youtube.com/watch?v=nZttMg_n_s0
Introduction to Sphinx Python Document Generation
Pour en savoir plus sur les directives :
https://docutils.sourceforge.io/docs/ref/rst/directives.html