Diferencia entre revisiones de «Plantilla:YouTube»

De FSF
Sin resumen de edición
Sin resumen de edición
 
(No se muestran 7 ediciones intermedias del mismo usuario)
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.
|-
| <code>tipo</code>
| —
| <code>video</code>
| Parámetro conservado por compatibilidad. No modifica el funcionamiento.
|}
|}


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


En la siguiente dirección:
{| class="wikitable" style="width:100%;"
! Posición
! Español
! Inglés
|-
| Izquierda
| <code>izquierda</code>
| <code>left</code>
|-
| Centro
| <code>centro</code>, <code>centrado</code> o <code>centrada</code>
| <code>center</code> o <code>centre</code>
|-
| Derecha
| <code>derecha</code>
| <code>right</code>
|}


<pre>
Los valores pueden escribirse con mayúsculas o minúsculas.
https://youtu.be/COTcjAjR5rc
</pre>
 
el identificador es:
 
<pre>
COTcjAjR5rc
</pre>
 
Por lo tanto, debe utilizarse:
 
<pre>
{{YouTube |id=COTcjAjR5rc}}
</pre>
 
== Casos de uso prácticos ==


=== Video sencillo ===
== Ejemplos ==


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


<pre>
<pre>
{{YouTube
{{YouTube
  |id=COTcjAjR5rc
  |id=Tn0gnS5-pqM
}}
  |align=left
</pre>
  |width=640
 
=== Video centrado con título ===
 
<pre>
{{YouTube
|id=COTcjAjR5rc
|titulo=Clase 1 de Taiji
  |align=center
  |ancho=600
}}
}}
</pre>
</pre>


=== Video con título y descripción ===
=== Centro ===


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


=== Video alineado a la izquierda ===
=== Derecha ===
 
El texto colocado después de la plantilla podrá distribuirse alrededor del video:


<pre>
<pre>
{{YouTube
{{YouTube
  |id=COTcjAjR5rc
  |id=Tn0gnS5-pqM
|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
  |align=right
  |align=right
  |ancho=450
  |width=640
}}
}}
</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:
 
<pre>
{{YouTube
|id=COTcjAjR5rc
|align=right
|ancho=400
}}
 
<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.
* No es necesario modificar las llamadas existentes de la plantilla.
</noinclude>
* Se recomienda usar <code>alineacion</code> sin acento.
* También se acepta <code>alineación</code>.
* También se acepta <code>align</code>.
* Se acepta español o inglés para los valores de alineación.
* Los valores de alineación no distinguen entre mayúsculas y minúsculas.
* Si no se especifica alineación, se utiliza <code>right</code>.
* El ancho debe escribirse como número, sin <code>px</code>.
* El parámetro <code>tipo</code> se conserva por compatibilidad.
* La plantilla utiliza la función <code>#ev</code> de '''EmbedVideo'''.


<div style="
</noinclude><div style="
{{#switch:{{{align|right}}}
{{#switch:{{lc:{{{align|right}}}}}
  |left=float:left; margin:0 20px 15px 0;
  |left=float:left; margin:0 20px 15px 0;
  |center=margin:20px auto; text-align:center;
|right=float:right; margin:0 0 15px 20px;
  |center=margin:20px auto;
  |#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 actual - 12:01 11 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.
tipo video Parámetro conservado por compatibilidad. No modifica el funcionamiento.

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 pueden escribirse con mayúsculas o minúsculas.

Ejemplos

Izquierda

{{YouTube
 |id=Tn0gnS5-pqM
 |align=left
 |width=640
}}

Centro

{{YouTube
 |id=Tn0gnS5-pqM
 |align=center
 |width=640
}}

Derecha

{{YouTube
 |id=Tn0gnS5-pqM
 |align=right
 |width=640
}}

Notas importantes

  • No es necesario modificar las llamadas existentes de la plantilla.
  • Se recomienda usar alineacion sin acento.
  • También se acepta alineación.
  • También se acepta align.
  • Se acepta español o inglés para los valores de alineación.
  • Los valores de alineación no distinguen entre mayúsculas y minúsculas.
  • Si no se especifica alineación, se utiliza right.
  • El ancho debe escribirse como número, sin px.
  • El parámetro tipo se conserva por compatibilidad.
  • La plantilla utiliza la función #ev de EmbedVideo.


EmbedVideo; falta un parámetro requerido.