Esta guía de edición documenta la sintaxis utilizada para insertar imágenes y otros archivos multimedia en las páginas de Wikipedia. Se utiliza la misma sintaxis independientemente de si un archivo es de Wikipedia o Wikimedia Commons . Se anima a los nuevos editores a ver también el tutorial en imágenes y la guía sencilla para principiantes .
En resumen, la sintaxis para mostrar una imagen es:[[File:Name|Type|Border|Location|Alignment|Size|link=Link|alt=Alt|page=Page|lang=Langtag|Caption]]
Plain type
significa que siempre escribes exactamente lo que ves. Bolded italics
significa una variable.Sólo se requiere Nombre . La mayoría de las imágenes deben usar " " y no deben especificar un tamaño.[[File:Name|thumb|alt=Alt|Caption]]
Los otros detalles:
thumb
" (o " thumbnail
"; cualquiera de los dos puede ir seguido de " "), " " (o " ") o " ". Muestra la imagen con un formato específico (ver más abajo).=filename
frame
framed
frameless
border
". Pon un pequeño borde alrededor de la imagen.right
", " left
", " center
" o " none
". Determine la ubicación horizontal de la imagen en la página. El valor predeterminado es " right
" para miniaturas e imágenes enmarcadas.baseline
", " middle
", sub
" super
", " " text-top
, " " text-bottom
, " ", " top
", o " bottom
". Alinea verticalmente la imagen con respecto al texto adyacente. El valor predeterminado es " middle
".upright
" o " ". Escale una miniatura desde su tamaño predeterminado según el factor dado (predeterminado 0,75), redondeando el resultado al múltiplo de 10 píxeles más cercano. La opción " " debe usarse junto con el parámetro " " o " ". Alternativamente, y sólo cuando sea absolutamente necesario, se pueden ignorar las preferencias de los usuarios y fijar el tamaño de la imagen especificando un tamaño en píxeles: " Ancho " o " Alto " o " Ancho Alto ". Escale la imagen para que no sea mayor que el ancho o alto dado, manteniendo su relación de aspecto. La ampliación (es decir, ampliar la imagen a un tamaño mayor) está desactivada cuando la imagen está enmarcada.upright=factor
upright
thumb
frameless
px
x
px
x
px
switch
traducidos . Algunos archivos SVG son multilingües; este parámetro especifica qué idioma usar. La etiqueta de idioma debe estar toda en minúsculas (por ejemplo, en lugar de ). El valor predeterminado es el idioma actual de Wikipedia en el espacio de nombres del artículo o en otros espacios de nombres. Ver .zh-hans
zh-Hans
en
{{Translate}}
thumb
se utiliza el atributo " ", pero puede mostrarse al pasar el mouse en otros casos.La sintaxis de la imagen comienza con " [[
", contiene componentes separados por " |
" y termina con " ]]
". El " [[
" y el primer " |
" (o, si no hay " |
", el " ]]
" final) deben estar en la misma línea; otros espacios y saltos de línea " <br>
" (o " <br />
") se ignoran si están al lado de los |
caracteres " " o justo dentro de los corchetes. No se permiten espacios ni saltos de línea justo antes de " =
" en las siguientes opciones y pueden tener efectos secundarios no deseados si aparecen justo después de " =
".
No termine con el código " |]]
"; esto se tomará como un título vacío y anulará cualquier título real anterior.
Se puede especificar una de estas opciones para controlar si la imagen se escala o no y/o se le asigna un borde. Para las opciones que escalan automáticamente la imagen, generalmente es a 220 px; Los usuarios que hayan iniciado sesión pueden modificar esto (en "Tamaño de miniatura" en Preferencias → Apariencia → Archivos ). Esto es importante para usuarios con (por ejemplo) visión limitada. Si es demasiado grande o pequeño, se puede utilizar el atributo vertical. Especificar un tamaño fijo en píxeles anula todo esto, pero no es amigable para los usuarios que necesitan una imagen más grande.
thumb
(o thumbnail
)thumb=Example.png
", el operando nombra una imagen que se utiliza como miniatura, ignorando cualquier especificación de tamaño.frame
frameless
border
|thumb
y |frame
), ya que las imágenes enmarcadas siempre tienen bordes.Se puede especificar una de estas opciones para controlar la posición de la imagen. Para ver ejemplos de cómo funciona todo esto, consulte Ejemplos de parámetro de ubicación.
right
thumb
o .frame
left
center
none
thumb
niframe
Opcionalmente, se puede especificar una de estas opciones para controlar la alineación vertical de la imagen con respecto al texto adyacente.
Estas opciones de alineación vertical se aplican solo a imágenes simples, que no causan interrupciones y no flotan (es decir, no funcionan con imágenes que necesitan que el texto fluya alrededor de ellas. Para hacer que el texto fluya alrededor de una imagen, coloque la imagen antes de la texto y utilizar el thumb
parámetro).
En la siguiente lista, la explicación de cada opción está precedida por el aspecto de Archivo: Bandera de Hungría vertical.svg cuando se alinea usando la opción enumerada, usando el marcado
de [[File:Flag of Hungary vertical.svg|option|frameless|upright=0.1|link=|alt=]]
middle
:
(Este es el valor predeterminado). Alinee el centro vertical de la imagen con la línea base del texto más la mitad de la altura x del texto, de modo que la imagen quede centrada verticalmente alrededor de una "x" minúscula en el texto.
baseline
:
Alinea la parte inferior de la imagen con la línea base del texto.
sub
:
Alinee la parte inferior de la imagen al mismo nivel que estaría la parte inferior de un subíndice, como la parte inferior del "2" en "X 2 ".
super
:
Alinee la parte inferior de la imagen al mismo nivel que estaría la parte inferior de un superíndice, como la parte inferior del "2" en "X 2 ".
text-top
:
Alinea la parte superior de la imagen con la parte superior del texto. Suele ser un poco más alto que la parte superior de una letra mayúscula, debido a los ascendentes en letras como la "h" minúscula.
text-bottom
:
Alinea la parte inferior de la imagen con la parte inferior del texto. Esto es algo más bajo que la línea base, debido a los descendentes en letras como la "y" minúscula.
top
:
Alinea la parte superior de la imagen con la parte superior de la línea que contiene el texto. Normalmente, esto es ligeramente más alto que la parte superior del texto, para dejar espacio entre las líneas de texto.
bottom
:
Alinea la parte inferior de la imagen con la parte inferior de la línea que contiene el texto. Normalmente es ligeramente más bajo que la parte inferior del texto.
Se puede especificar cualquiera o ninguna de estas opciones para controlar el tamaño de la imagen. En el caso de imágenes con pies de foto, si la imagen ya es más pequeña que el tamaño solicitado, entonces la imagen conserva su tamaño original (no se amplía). En el caso de imágenes sin pies de foto, la imagen se ampliará o reducirá hasta alcanzar el tamaño solicitado. El tamaño está deshabilitado cuando se usa el tipo 'marco', y las opciones de tamaño se marcan como una opción de archivo falsa en Special:LintErrors .
El ancho de miniatura predeterminado se puede establecer en las preferencias, por lo que no se recomienda especificarlo en px para respetar las preferencias de los usuarios, lo que puede ser importante para la accesibilidad. Por supuesto, se pueden hacer excepciones, pero intente utilizar upright
o el valor predeterminado si es posible.
upright
o upright=
factorupright=1.5
" hace que la imagen sea más grande, lo cual es útil para mapas o esquemas que necesitan ser más grandes para ser legibles. El parámetro " upright=1
" devuelve el mismo tamaño que el ancho de la miniatura y " upright=0.75
" es funcionalmente idéntico a " upright
" solo. Si establece Factor igual a la relación de aspecto de la imagen (ancho dividido por alto), el resultado es equivalente a escalar la altura para que sea igual al ancho normal de la miniatura.upright
opción solo funciona con el parámetro thumb
o frameless
(ver Tipo).px
100px
,) Escale la imagen para que tenga el número especificado de píxeles de ancho y escale la altura para conservar la relación de aspecto original.x
Alturapx
x150px
) Escale la imagen para que tenga el número especificado de píxeles de alto y escale el ancho para conservar la relación de aspecto original.x
Altopx
100x150px
) Escale la imagen para que no sea más ancha ni más alta que el número de píxeles especificado. La imagen mantendrá su relación de aspecto original.|link=Page
|link=
(solo)|link=
afecta sólo lo que sucede cuando se hace clic en la imagen ; |thumb
las imágenes llevan un pequeño icono de rectángulo-rectángulo en el área de título, y al hacer clic en él siempre se accede a la página de descripción de la imagen. A excepción de las imágenes de dominio público, el lector siempre debe poder acceder a la página de descripción de la imagen, por lo que
|link=
debe usarse solo con |thumb
imágenes.
|link=
no se puede utilizar con |frame
.
Para desactivar todos los enlaces y descripciones de una imagen puramente decorativa (para que los lectores de pantalla la ignoren), utilice " |link=
|alt=
" sin argumentos para ninguno de los parámetros.
Se pueden especificar cero o más de estas opciones para controlar el texto alternativo , el título del enlace y el título de la imagen. Los subtítulos pueden contener marcas wiki incrustadas, como enlaces o formato. Consulte Wikipedia: Subtítulos para conocer el texto de subtítulo apropiado. Consulte Wikipedia: texto alternativo para imágenes para una discusión sobre el texto alternativo apropiado. Internet Explorer muestra el título del enlace como información sobre herramientas, pero es posible que otros navegadores no lo hagan.
Sugerencia: para forzar que se escriba el título (debajo de la imagen) y que no aparezca simplemente como "texto flotante" incluso cuando desee cambiar el tamaño de la imagen, especifique " thumb
". Si especifica " ", el título aparece pero se ignora frame
cualquier cambio de tamaño (como " ").125px
alt=
Alt.thumbnail
", " thumb
", " frame
" o " framed
"), este texto aparece como un título debajo de la imagen. De lo contrario (si el tipo de imagen no está especificado o es " frameless
"), este texto se utiliza para el título del enlace siempre que el enlace no se haya suprimido con " |link=
", y también para el texto alternativo siempre que no se haya proporcionado una alt=
Alt explícita .El texto alternativo real de la imagen mostrada será uno de los siguientes, en orden de preferencia:
Es posible especificar el texto del título del enlace solo para imágenes sin título visible (como se describe arriba). Sin embargo, como no todos los navegadores muestran este texto y los lectores de pantalla lo ignoran, no tiene mucho sentido.
Nota: alt
solo se admite para imágenes. Los archivos de audio y vídeo deben utilizar texto cronometrado .
class=
class=notpageimage
excluirá la imagen de la selección del algoritmo de Imágenes de página. (phab:T301588)Normalmente se utiliza la página 1 de un archivo PDF o DjVu para generar la miniatura. Se puede utilizar una página diferente con el parámetro |page=
: :[[File:IMSLP01578-Ravel - Bolero Full Score Durand 1929.pdf|thumb|page=2|''Boléro'': page 2 from the score]]
El ejemplo más básico utiliza la sintaxis . Esto no escala la imagen ni permite que el texto se ajuste a su alrededor. Normalmente esto no es apropiado en un artículo.[[File:Westminstpalace.jpg|Alt text]]
Esto se representa en línea y el texto especificado se utiliza como atributo alt de la imagen (texto alternativo para programas que no pueden mostrar imágenes, como lectores de pantalla ) y como atributo de título (texto complementario, que a menudo se muestra como información sobre herramientas cuando se coloca el mouse sobre la imagen). Consulte Wikipedia: Subtítulos para conocer el texto de subtítulo apropiado. Consulte Wikipedia: texto alternativo para imágenes para una discusión sobre el texto alternativo apropiado.
Arriba, la imagen del Támesis ocupaba su propio párrafo. Esto no es obligatorio; Las imágenes pueden ubicarse en línea en el texto, como se muestra a continuación.
texto texto texto texto texto texto [[ Archivo : Westminstpalace.jpg | 150px | alt = Una gran torre de reloj y otros edificios bordean un gran río. | El Palacio de Westminster ]]texto texto texto texto texto[[ Archivo : tst.png | 100px | alt = Globo pequeño | Este es un globo terráqueo. ]]texto texto texto texto
da
texto texto texto texto texto textotexto texto texto texto texto texto texto texto texto
Para mostrar una imagen cargada con un título, utilice [[File:Westminstpalace.jpg|frame|none|alt=Alt text|Caption text]]
.
Este es el estilo más familiar para los lectores. Como se muestra en la imagen de ejemplo, la imagen está enmarcada, tiene un tamaño apropiado y tiene texto que se puede ajustar a su alrededor. Un título está correctamente integrado.
La parte importante de esto es el thumb
parámetro: (como se muestra a la izquierda). Para obtener detalles sobre estas opciones, consulte las secciones anteriores.[[File:Westminstpalace.jpg|thumb|upright=0.4|left|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]
A continuación se muestran ejemplos del parámetro de ubicación:
[[File:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|right|upright=0.35]]
[[File:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|left|upright=0.35]]
Hay un problema de flotación en HTML/CSS que impide que ciertas imágenes (u otros objetos flotantes) floten sobre otras. Ocurre sólo si:
El primer objeto flotante en el último lado de la página no flotará sobre el último objeto flotante en el primero (ver ejemplos a continuación). Las soluciones incluyen alternar entre izquierda y derecha al alinear imágenes u otros objetos flotantes (no se muestran); estableciendo en "ninguno" la alineación del que no flotará por encima de los demás (como se demuestra "en vivo" en la tabla de población aquí ); y usar una etiqueta de galería para una gran cantidad de imágenes en una sola sección. Según MOS:ACCESS#FLOAT , las imágenes deben insertarse de modo que su marcado esté en la sección correcta, incluso si eso puede hacer que floten en la siguiente sección.
Código problemático:
==Sección 1== [[ Archivo : Westminstpalace.jpg | pulgar | 70 píxeles | derecha | Figura 1.1 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | pulgar | 70 píxeles | derecha | Figura 1.2 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | pulgar | 70 píxeles | derecha | Figura 1.3 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | pulgar | 70 píxeles | derecha | Figura 1.4 ( '''derecha''' ) ]]Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.==Sección 2== [[ Archivo : Westminstpalace.jpg | pulgar | 70 píxeles | izquierda | Figura 2.1 ( '''izquierda''' ) ]]Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Para obtener más información sobre la etiqueta de la galería, consulte Ayuda:Etiqueta de la galería .
upright
opción " " ocupa aproximadamente el 75% del ancho de la miniatura.upright=1.5
opciónLa upright
opción funciona en combinación con la opción thumbnail
o thumb
para cambiar el tamaño de una imagen a aproximadamente el 75% del ancho de un plano thumbnail
. Esto es útil para mostrar imágenes en orientación "vertical" , ya que imágenes tan altas y estrechas tienden a parecer demasiado grandes cuando se escalan al mismo ancho que las imágenes orientadas en "paisaje". La upright
opción aumenta o disminuye según la resolución de la pantalla del usuario. El tamaño relativo se puede determinar con un multiplicador como . Si x =1 entonces la imagen tiene un ancho de miniatura estándar. Por ejemplo , <lang="wikitext" inline>upright=x
upright
opción " " ocupa aproximadamente el 75% del ancho de la miniatura.</syntaxhighlight> (se muestra a la izquierda) y [[File:Westminstpalace.jpg|thumb|upright=1.5|right|alt=A large clock tower and other buildings line a great river.|The "<code>upright=1.5</code>" option]]
(se muestra a la derecha).
Con esta opción, la imagen incrustada se muestra con su tamaño real encerrado por un marco, independientemente del atributo "pulgar" o "tamaño", y el título, si lo hay, es visible en el marco. Sin las opciones left
, center
y none
, la imagen normalmente está a la derecha: [[File:Westminstpalace.jpg|frame|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]
.
Sin ninguna otra opción que no sea sizepx
y alternate (caption) text
, una imagen incrustada se representa en línea.
La opción none
se puede utilizar para tener miniaturas sin alineación hacia la izquierda o hacia la derecha. Probablemente esto sea más útil para tablas . Esto es un ejemplo:
Puede colocar enlaces en el texto del título, como se muestra en esta imagen:
[[ Archivo : Westminstpalace.jpg | derecha | miniatura | alt = Una gran torre de reloj y otros edificios bordean un gran río. | Así es el [[ Palacio de Westminster ]] en Londres ]]
Solo asegúrese de que el número de corchetes de apertura y cierre sea el correcto. Uno extra o faltante significaría que toda la línea de sintaxis de la imagen no funcionaría.
Son posibles opciones adicionales de formato de subtítulos; todo el formato normal debería funcionar.
[[ Archivo : Westminstpalace.jpg | derecha | miniatura | alt = Una gran torre de reloj y otros edificios bordean un gran río. | <div style = "text-align: center">Este es < span style = "color: green" > el </ span >< br /> [[ Palacio de Westminster ]]< br /> '''en < span style = "color: rojo" > Londres </ span > ''' </ div >]]
Las viñetas y los números de la lista a veces pueden superponerse a imágenes flotantes a la izquierda y es posible que las líneas sangradas no aparezcan correctamente al lado de imágenes flotantes a la izquierda. Por ejemplo:
La plantilla {{ flowlist }} permite que las listas se mantengan alejadas de estos objetos flotantes a la izquierda:
[[ Archivo : Westminstpalace.jpg | izquierda | pulgar | 100px ]] {{ flowlist }} < ol > < li > elemento de lista A1 < ol > < li > elemento de lista B1 </ li > < li > elemento de lista B2 </ li > </ ol > elemento de lista continua A1 </ li > < li > elemento de lista A2 </ li > </ ol > {{ endflowlist }}{{ lista de flujo }}Primera linea: Segunda línea :: Tercera línea ::: Cuarta línea {{ endflowlist }}
Se representa como:
Primera linea
Este método no funcionará dentro de una tabla, y si su lista es más larga que el elemento flotante, entonces la lista no fluirá alrededor de la imagen como de costumbre, sino que será un bloque, dejando un espacio en blanco debajo del elemento flotante.
En algunos casos, puede ser conveniente agregar anotaciones en las que se puede hacer clic a una imagen. Las plantillas Plantilla:Imagen anotada y Plantilla:Imagen anotada 4 existen para este propósito.
Estas plantillas permiten incluir wikitexto (por ejemplo, texto normal, enlaces wiki, código HTML permitido, referencias y otras plantillas) en la propia imagen. También se pueden usar para recortar una imagen y enfocarla en una parte particular de ella o, alternativamente, expandir el área blanca alrededor de una imagen para una mejor ubicación del wikitexto.
También está la plantilla {{ Overlay }}:
Sólo el artículo 7 está vinculado aquí.
Después de haber tenido una imagen flotando junto al texto, se puede colocar más texto debajo y nuevamente usar todo el ancho con el siguiente marcado. Esto impide que aparezca una imagen junto al material siguiendo este marcado, posiblemente debido a razones estéticas o un cambio de tema.
<br style="clear:both" />
Para align="right"
la flotación heredada (etc.), esto no es suficiente; Los navegadores heredados ignorarían el CSS en línea. Para cancelar la flotación en todas las condiciones, funciona el siguiente marcado (transicional XHTML 1.0 válido):
<br clear="all" />
El mismo código se puede emitir usando la plantilla {{ clear }} o {{ Clr }} o {{ - }} en ciertos espacios de nombres ( en , meta ).
Para mostrar fotografías de realidad virtual ( también conocidas como panorámicas de 360 grados o fotosferas), utilice {{ PanoViewer }}.
Si no desea mostrar o mostrar la imagen, sino que simplemente desea crear un enlace a la página de descripción de una imagen, use dos puntos iniciales antes de "Archivo:" en un enlace intra-wiki, como este: [[:File:STS-32 crew.jpg|STS-32 crew]]
que produce: Tripulación STS-32 .
A menudo, los archivos de sonido se presentan en las páginas de Wikipedia utilizando {{ Listen }} o sus plantillas relacionadas. Sin embargo, también es posible presentar un archivo de audio sin utilizar ninguna plantilla. Se puede utilizar una sintaxis similar a la de las imágenes para convertir archivos de audio o vídeo en páginas.
Tenga en cuenta que ninguno de estos ejemplos proporciona enlaces a Wikipedia: Ayuda para los medios , y el ejemplo 2 no proporciona enlaces navegables al archivo en sí. En consecuencia, siempre que se utilice este método, la plantilla {{ Inline audio }} debe mostrarse en esa página y la presentación de los botones de reproducción debe ir acompañada de enlaces en los que se pueda hacer clic al archivo de sonido. Ejemplos:
Tenga en cuenta que la alineación vertical del botón de reproducción no funciona ni es posible presentar el botón de reproducción en línea con el texto; en consecuencia, la disposición más agradable se logra con los ejemplos 1 o 3.
También hay un parámetro para preestablecer el reproductor para que comience a una hora distinta a las 0:00.
Desde junio de 2019, los archivos MIDI se pueden reproducir como otros archivos de sonido. Ver: Ayuda:Puntuación .
[[ Archivo : Beethoven op. 33 núm. 1.medio | pulgar |[[ Bagatelas, op. 33 (Beethoven) | ''Bagatelas'' , op. 33 ]] , núm. 1 ]]
Para mostrar un vídeo cargado con un título, utilice [[File:First flights in aviation history.ogg|frame|none|Caption text]]
.
" ". Utilice el fotograma del vídeo en el momento dado como imagen fija inicial. El tiempo es una cantidad de segundos u horas, minutos y segundos separados por dos puntos. Sin un parámetro de tiempo de pulgar, se utiliza de forma predeterminada un fotograma desde el punto medio del vídeo. Por ejemplo, usando el mismo archivo de vídeo que antes:|thumbtime=Time
Esta sintaxis le permite reproducir un segmento de la transmisión de video o establecer una hora de inicio. Pase el cursor sobre el reproductor para ver la hora de inicio en 5 segundos, presione reproducir y observe que la reproducción se detiene a los 7 segundos.
[[File:Weeding.ogv|thumb|upright=1.3|start=5|end=7|Starts at 5 seconds and ends playback at 7 seconds]]
Nota: Esto aún no es compatible con Safari e Internet Explorer.
Para mostrar un vídeo más grande que el tamaño subido, utilice " |thumb
" y " ". Esto puede resultar útil si el vídeo original es muy pequeño pero muestra algunos detalles importantes pero pequeños, pero tenga en cuenta que la ampliación puede crear artefactos de escala inesperados. Por ejemplo, el código|numberpx
[[File:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|inline|left]] [[File:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|right|thumb|128px]]
El parámetro thumbtime también se puede usar dentro de una galería (ya sea con etiquetas <gallery> o la plantilla {{ Gallery }}):
Aquí está el código wiki que lo creó:
<galería>Archivo:Primeros vuelos en la historia de la aviación.ogg|thumbtime=21|Hombre con traje, corbata y sombrero a los 21 segundos.Archivo:Primeros vuelos en la historia de la aviación.ogg|thumbtime=0:23|Monoplano visto a los 23 segundos.</galería>
lossy
parámetro para archivos tiff