Diferencia entre revisiones de «Plantilla:YouTube»

De FSF
Sin resumen de edición
Sin resumen de edición
Línea 2: Línea 2:
== Descripción ==
== Descripción ==


La plantilla '''YouTube''' permite insertar un video de YouTube dentro de una página de WikiFSF. Puede mostrar opcionalmente un título y una descripción, además de controlar la alineación y el ancho del video.
La plantilla '''YouTube''' permite insertar un video de YouTube con título y descripción opcionales. También permite controlar su alineación y ancho.


Esta plantilla utiliza la función <code>#ev</code>, proporcionada normalmente por la extensión '''EmbedVideo'''.
Los nombres de los parámetros y los valores de alineación pueden escribirse en español o inglés.


== Uso básico ==
== Uso recomendado en español ==


<pre>
<pre>
Línea 13: Línea 13:
  |titulo=
  |titulo=
  |descripcion=
  |descripcion=
|alineacion=derecha
|ancho=400
}}
</pre>
== Uso en inglés ==
<pre>
{{YouTube
|id=
|title=
|description=
  |align=right
  |align=right
  |ancho=400
  |width=400
}}
}}
</pre>
</pre>


== Parámetros ==
== Parámetros disponibles ==


{| class="wikitable" style="width:100%;"
{| class="wikitable" style="width:100%;"
! Parámetro
! Español
! Requerido
! Inglés o alternativa
! Valor predeterminado
! Predeterminado
! Descripción
! Descripción
|-
|-
| <code>id</code>
| <code>id</code>
|
| <code>video</code>
| —
| —
| Identificador del video de YouTube. Debe colocarse solamente el código del video, no la URL completa.
| Identificador del video de YouTube. Debe colocarse únicamente el código del video, no la URL completa.
|-
|-
| <code>titulo</code>
| <code>titulo</code>
| No
| <code>title</code>
| Vacío
| Vacío
| Título que aparecerá en negritas encima del video.
| Título mostrado en negritas encima del video.
|-
|-
| <code>descripcion</code>
| <code>descripcion</code>
| No
| <code>description</code>
| Vacío
| Vacío
| Texto breve que aparecerá debajo del video con un tamaño de letra reducido.
| Texto breve mostrado debajo del video.
|-
|-
| <code>alineacion</code> o <code>alineación</code>
| <code>align</code>
| <code>align</code>
| No
| <code>right</code>
| <code>right</code>
| Posición del video. Valores permitidos: <code>left</code>, <code>center</code> o <code>right</code>.
| Define la posición del video.
|-
|-
| <code>ancho</code>
| <code>ancho</code>
| No
| <code>width</code>
| <code>400</code>
| <code>400</code>
| Ancho del video expresado en píxeles. Debe escribirse solamente el número, sin agregar <code>px</code>.
| Ancho del video en píxeles. Debe escribirse solamente el número.
|}
|}


== Cómo obtener el identificador del video ==
== Valores de alineación ==


En la siguiente dirección:
{| class="wikitable" style="width:100%;"
 
! Posición
<pre>
! Español
https://youtu.be/COTcjAjR5rc
! Inglés
</pre>
|-
 
| Izquierda
el identificador es:
| <code>izquierda</code>
 
| <code>left</code>
<pre>
|-
COTcjAjR5rc
| Centro
</pre>
| <code>centro</code>, <code>centrado</code> o <code>centrada</code>
 
| <code>center</code> o <code>centre</code>
Por lo tanto, debe utilizarse:
|-
| Derecha
| <code>derecha</code>
| <code>right</code>
|}


<pre>
Los valores también pueden escribirse con mayúsculas, por ejemplo: <code>CENTRO</code>, <code>Derecha</code> o <code>LEFT</code>.
{{YouTube |id=COTcjAjR5rc}}
</pre>


== Casos de uso prácticos ==
== Casos de uso prácticos ==


=== Video sencillo ===
=== Video sencillo ===
Muestra el video alineado a la derecha, con un ancho de 400 píxeles:


<pre>
<pre>
Línea 84: Línea 96:
</pre>
</pre>


=== Video centrado con título ===
=== Video centrado usando parámetros en español ===


<pre>
<pre>
Línea 90: Línea 102:
  |id=COTcjAjR5rc
  |id=COTcjAjR5rc
  |titulo=Clase 1 de Taiji
  |titulo=Clase 1 de Taiji
  |align=center
  |descripcion=Clase impartida por el maestro Elbio Pera.
|alineacion=centro
  |ancho=600
  |ancho=600
}}
}}
</pre>
</pre>


=== Video con título y descripción ===
=== Video usando parámetros en inglés ===


<pre>
<pre>
{{YouTube
{{YouTube
  |id=COTcjAjR5rc
  |id=COTcjAjR5rc
  |titulo=Clase 1 de Taiji
  |title=Clase 1 de Taiji
  |descripcion=Clase impartida por el maestro Elbio Pera como apoyo al maestro Roque.
  |description=Clase impartida por el maestro Elbio Pera.
  |align=center
  |align=center
  |ancho=600
  |width=600
}}
}}
</pre>
</pre>


=== Video alineado a la izquierda ===
=== Usando el parámetro alternativo «video» ===
 
El texto colocado después de la plantilla podrá distribuirse alrededor del video:


<pre>
<pre>
{{YouTube
{{YouTube
  |id=COTcjAjR5rc
  |video=COTcjAjR5rc
|titulo=Ejercicio introductorio
|descripcion=Demostración práctica de los movimientos iniciales.
|align=left
|ancho=400
}}
 
Este texto aparecerá junto al video mientras exista espacio disponible.
</pre>
 
=== Video alineado a la derecha ===
 
<pre>
{{YouTube
|id=COTcjAjR5rc
  |titulo=Práctica guiada
  |titulo=Práctica guiada
  |align=right
  |alineación=izquierda
  |ancho=450
  |ancho=450
}}
}}
</pre>
</pre>


== Recomendaciones ==
== Notas importantes ==
 
* Utilizar solamente el identificador del video y no su URL completa.
* Escribir el ancho como un número: <code>400</code>, no <code>400px</code>.
* Usar títulos breves y descriptivos.
* Mantener la descripción corta para conservar una presentación compacta.
* Utilizar <code>align=center</code> cuando el video sea el contenido principal de una sección.
* Si se omite <code>align</code>, el video aparecerá alineado a la derecha.
* Cualquier valor de alineación no reconocido será tratado como <code>right</code>.
 
== Solución para textos o secciones desplazadas ==
 
Las alineaciones <code>left</code> y <code>right</code> utilizan elementos flotantes. Por ello, en algunos casos el contenido siguiente puede aparecer al lado del video.
 
Si se necesita comenzar una sección completamente debajo del video, puede colocarse después de la plantilla:
 
<pre>
<div style="clear:both;"></div>
</pre>


Ejemplo:
* No es necesario modificar las llamadas anteriores de la plantilla.
 
* Se recomienda usar <code>alineacion</code> sin acento para facilitar su escritura.
<pre>
* Puede utilizarse español o inglés, pero conviene mantener un solo idioma dentro de cada llamada.
{{YouTube
* Si se colocan dos nombres equivalentes, la plantilla dará prioridad al parámetro original. Por ejemplo, <code>align</code> tendrá prioridad sobre <code>alineacion</code>.
|id=COTcjAjR5rc
* Cualquier valor de alineación no reconocido colocará el video a la derecha.
|align=right
* El ancho debe escribirse como <code>400</code>, sin agregar <code>px</code>.
|ancho=400
* Esta plantilla necesita la función <code>#ev</code>, proporcionada por la extensión '''EmbedVideo'''.
}}
 
<div style="clear:both;"></div>
 
== Siguiente sección ==
</pre>
 
== Áreas de oportunidad ==
 
El código actual funciona correctamente. Sin modificarlo, conviene considerar para una futura versión:
 
* Incorporar un ancho adaptable para pantallas pequeñas y teléfonos.
* Evitar que los videos anchos desborden el espacio disponible.
* Agregar una opción para impedir que el texto rodee al video.
* Mostrar un mensaje informativo cuando el parámetro <code>id</code> esté vacío.
* Permitir opcionalmente un enlace directo al video original.
 
Estas mejoras requerirían una nueva versión de la plantilla y no han sido aplicadas al código actual.
</noinclude>
</noinclude>
<div style="
<div style="
{{#switch:{{{align|right}}}
{{#switch:{{lc:{{{align|{{{alineacion|{{{alineación|right}}}}}}}}}}}}
  |left=float:left; margin:0 20px 15px 0;
  |left
  |center=margin:20px auto; text-align:center;
|izquierda=float:left; margin:0 20px 15px 0;
  |center
|centre
|centro
|centrado
|centrada=margin:20px auto; text-align:center;
|right
|derecha=float:right; margin:0 0 15px 20px;
  |#default=float:right; margin:0 0 15px 20px;
  |#default=float:right; margin:0 0 15px 20px;
}}
}}
  width:{{{ancho|400}}}px;
  width:{{{ancho|{{{width|400}}}}}}px;
">
">


{{#if:{{{titulo|}}}|
{{#if:{{{titulo|{{{title|}}}}}}|
'''{{{titulo}}}'''
'''{{{titulo|{{{title|}}}}}}'''
<br>
<br>
}}
}}


{{#ev:youtube|{{{id}}}|{{{ancho|400}}}}}
{{#ev:youtube|{{{id|{{{video|}}}}}}|{{{ancho|{{{width|400}}}}}}}}


{{#if:{{{descripcion|}}}|
{{#if:{{{descripcion|{{{description|}}}}}}|
<br>
<br>
<small>{{{descripcion}}}</small>
<small>{{{descripcion|{{{description|}}}}}}</small>
}}
}}


</div>
</div>

Revisión del 14:58 5 ago 2026

Descripción

La plantilla YouTube permite insertar un video de YouTube con título y descripción opcionales. También permite controlar su alineación y ancho.

Los nombres de los parámetros y los valores de alineación pueden escribirse en español o inglés.

Uso recomendado en español

{{YouTube
 |id=
 |titulo=
 |descripcion=
 |alineacion=derecha
 |ancho=400
}}

Uso en inglés

{{YouTube
 |id=
 |title=
 |description=
 |align=right
 |width=400
}}

Parámetros disponibles

Español Inglés o alternativa Predeterminado Descripción
id video Identificador del video de YouTube. Debe colocarse únicamente el código del video, no la URL completa.
titulo title Vacío Título mostrado en negritas encima del video.
descripcion description Vacío Texto breve mostrado debajo del video.
alineacion o alineación align right Define la posición del video.
ancho width 400 Ancho del video en píxeles. Debe escribirse solamente el número.

Valores de alineación

Posición Español Inglés
Izquierda izquierda left
Centro centro, centrado o centrada center o centre
Derecha derecha right

Los valores también pueden escribirse con mayúsculas, por ejemplo: CENTRO, Derecha o LEFT.

Casos de uso prácticos

Video sencillo

{{YouTube
 |id=COTcjAjR5rc
}}

Video centrado usando parámetros en español

{{YouTube
 |id=COTcjAjR5rc
 |titulo=Clase 1 de Taiji
 |descripcion=Clase impartida por el maestro Elbio Pera.
 |alineacion=centro
 |ancho=600
}}

Video usando parámetros en inglés

{{YouTube
 |id=COTcjAjR5rc
 |title=Clase 1 de Taiji
 |description=Clase impartida por el maestro Elbio Pera.
 |align=center
 |width=600
}}

Usando el parámetro alternativo «video»

{{YouTube
 |video=COTcjAjR5rc
 |titulo=Práctica guiada
 |alineación=izquierda
 |ancho=450
}}

Notas importantes

  • No es necesario modificar las llamadas anteriores de la plantilla.
  • Se recomienda usar alineacion sin acento para facilitar su escritura.
  • Puede utilizarse español o inglés, pero conviene mantener un solo idioma dentro de cada llamada.
  • Si se colocan dos nombres equivalentes, la plantilla dará prioridad al parámetro original. Por ejemplo, align tendrá prioridad sobre alineacion.
  • Cualquier valor de alineación no reconocido colocará el video a la derecha.
  • El ancho debe escribirse como 400, sin agregar px.
  • Esta plantilla necesita la función #ev, proporcionada por la extensión EmbedVideo.


EmbedVideo; falta un parámetro requerido.