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 el archivo es de Wikipedia o de Wikimedia Commons . Se recomienda a los nuevos editores que consulten también el tutorial de 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 typesignifica que siempre escribes exactamente lo que ves. Bold italicsrepresenta una variable, que reemplazas con su valor real.
De los parámetros que se muestran, solo el nombre es esencial. La mayoría de las imágenes deben usar un tamaño y no especificarlo.[[File:Name|thumb|alt=Alt|Caption]]
Los demás detalles:
thumb(o thumbnail; cualquiera de los dos puede ir seguido de ), (o ), o . Muestra la imagen con un formato específico (ver a continuación).=filenameframeframedframelessborder. Coloque un pequeño borde alrededor de la imagen.right, o . Determina la ubicación horizontal de la imagen en la página. Esta opción es predeterminada para leftminiaturas e imágenes enmarcadas.centernonerightbaseline, middle, sub, super, text-top, text-bottom, top, o bottom. Alinea verticalmente la imagen con respecto al texto adyacente. El valor predeterminado es middle.uprighto . Escala una miniatura a partir de su tamaño predeterminado por 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 solo 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: o o . Escala la imagen para que no sea mayor que el ancho o alto dados, manteniendo su relación de aspecto. La ampliación (es decir, estirar la imagen a un tamaño mayor) está deshabilitada cuando la imagen está enmarcada.upright=factoruprightthumbframelessWidth pxx Height pxWidth x Height pxswitch (gráficos vectoriales escalables) traducidos . Algunos archivos SVG son multilingües; este parámetro especifica qué idioma utilizar. La etiqueta de idioma debe estar 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. Consulte .zh-hanszh-Hansen{{Translate}}thumbo frame, pero puede aparecer al pasar el mouse por encima en otros casos.La sintaxis de la imagen comienza con [[, contiene componentes separados por |, y termina con ]]. El [[y el primero |(o, si no hay |, el de terminación ]]) deben estar en la misma línea; otros espacios y saltos de línea <br>(o <br />) se ignoran si están junto a |caracteres o justo dentro de los corchetes. No se permiten espacios o saltos de línea justo antes de =en las siguientes opciones, y pueden tener efectos secundarios indeseables 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 se escala o no la imagen y/o se le asigna un borde. Para las opciones que escalan automáticamente la imagen, normalmente es de 220 px; los usuarios que hayan iniciado sesión pueden modificar esto (en "Tamaño de la miniatura" en Preferencias → Apariencia → Archivos ). Esto es importante para los usuarios con visión limitada (por ejemplo). 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 adecuado para los usuarios que necesitan una imagen más grande.
thumb(o thumbnail)thumb=Example.png, el operando nombra una imagen que se usa como miniatura, ignorando cualquier especificación de tamaño.frameframelessborder|thumby |frame), ya que las imágenes con marco 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ámetros de ubicación.
rightthumbo .frameleftcenternonethumbtampocoframe
como esto.Se puede especificar opcionalmente 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 únicamente a imágenes simples, que no causan cortes ni están flotando (es decir, no funcionan con imágenes que necesitan que el texto fluya alrededor de ellas. Para que el texto fluya alrededor de una imagen, coloque la imagen antes del texto y use el thumbparámetro).
En la siguiente lista, la explicación de cada opción está precedida por el aspecto que tiene el archivo:Flag of Hungary vertical.svg cuando se alinea utilizando la opción indicada, utilizando 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 esté 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 alta 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 un poco más abajo que la línea base, debido a los trazos 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, esta parte es ligeramente más alta 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, esta parte se encuentra ligeramente por debajo de 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 subtítulos, si la imagen ya es más pequeña que el tamaño solicitado, la imagen conserva su tamaño original (no se amplía). En el caso de imágenes sin subtítulos, la imagen se ampliará o reducirá para que coincida con el tamaño solicitado. El cambio de tamaño se desactiva cuando se utiliza 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 configurar en las preferencias, por lo que no se recomienda especificarlo en píxeles para respetar las preferencias de los usuarios, que pueden ser importantes para la accesibilidad. Por supuesto, se pueden hacer excepciones, pero intente utilizar uprightel valor predeterminado si es posible.
upright o upright=factorupright=1.5hace que la imagen sea más grande, lo que resulta útil para mapas o esquemas que deben ser más grandes para ser legibles. El parámetro upright=1devuelve el mismo tamaño que el ancho de la miniatura y upright=0.75es funcionalmente idéntico a uprightsolo. Si establece Factor igual a la relación de aspecto de la imagen (ancho dividido por alto), el resultado es equivalente a escalar el alto para que sea igual al ancho normal de la miniatura.uprightopción sólo funciona con el parámetro thumbo frameless(ver Tipo).px100px ) 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.xAlturapxx150px) Escalar la imagen para que tenga la cantidad especificada de píxeles de alto y escalar el ancho para conservar la relación de aspecto original.xAltopx100x150px ) Escala la imagen para que no sea más ancha ni más alta que la cantidad de píxeles especificada. La imagen mantendrá su relación de aspecto original.|link=Page|link=(solo)|link=Afecta únicamente a lo que ocurre cuando se hace clic en la imagen ; |thumblas imágenes tienen un pequeño icono rectangular 
en el área del 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 utilizarse únicamente con |thumbimágenes.
|link=no se puede utilizar con |frame.
Para deshabilitar todos los enlaces y descripciones de una imagen puramente decorativa (de modo que los lectores de pantalla la ignoren), utilice " |link=|alt=" sin argumentos para ninguno de los parámetros.
Se puede 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 títulos pueden contener marcado wiki incrustado, como enlaces o formato. Consulte Wikipedia:Subtítulos para obtener información sobre el texto de título adecuado. Consulte Wikipedia:Texto alternativo para imágenes para obtener información sobre el texto alternativo adecuado. Internet Explorer muestra el título del enlace como una información sobre herramientas, pero es posible que otros navegadores no lo hagan. [ necesita actualización ]
Consejo: para que el título se escriba (debajo de la imagen) y no aparezca simplemente como "texto flotante" incluso cuando desee cambiar el tamaño de la imagen, especifique " thumb". Si especifica " frame", el título aparece, pero se ignora cualquier cambio de tamaño (como " 125px").
alt=Altthumbnail", " thumb", " frame" o " framed"), este texto aparece como título debajo de la imagen. De lo contrario (si el tipo de imagen no se especifica 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 un alt=Alt explícito.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 más 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 video deben usar texto cronometrado .
class=class=notpageimageexcluirá la imagen de la selección del algoritmo Imágenes de página. (phab:T301588)class=skin-inverthará que los colores de la imagen se inviertan en el modo oscuro. class=skin-invert-imagesolo invertirá la imagen y no el título.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. Esto normalmente no es apropiado en un artículo.[[File:Westminstpalace.jpg|Alt text]]
Esto se muestra 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 title (texto complementario, que a menudo se muestra como información sobre herramientas cuando el mouse se encuentra sobre la imagen). Consulte Wikipedia:Subtítulos para obtener información sobre el texto de subtítulo adecuado. Consulte Wikipedia:Texto alternativo para imágenes para obtener información sobre el texto alt adecuado.
Arriba, la imagen del Támesis se colocó en un párrafo propio. Esto no es obligatorio; las imágenes pueden aparecer en línea dentro del 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. ]]texto texto texto textoda
texto texto texto texto texto texto
texto texto texto texto texto texto texto texto texto
Para mostrar una imagen tal como fue cargada con un título, utilice [[File:Westminstpalace.jpg|frame|none|alt=Alt text|Caption text]].
Este es el estilo más conocido por los lectores. Como se muestra en la imagen de ejemplo, la imagen está enmarcada, tiene un tamaño adecuado y tiene texto que se puede ajustar a su alrededor. El título está integrado correctamente.
La parte importante de esto es el thumbpará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]]Existe un problema de flotación en HTML/CSS que impide que ciertas imágenes (u otros objetos flotantes) floten sobre otras. Esto ocurre solo 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 muestra); establecer en "ninguno" la alineación del que no flotará sobre 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 manera 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 | miniatura | 70px | derecha | Figura 1.1 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | miniatura | 70px | derecha | Figura 1.2 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | miniatura | 70px | derecha | Figura 1.3 ( '''derecha''' ) ]] [[ Archivo : Westminstpalace.jpg | miniatura | 70px | 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 | miniatura | 70px | 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 galería, consulte Ayuda:Etiqueta de galería .
uprightopción " " representa aproximadamente el 75% del ancho de la miniatura.upright=1.5opción " "La uprightopción funciona en combinación con la opción thumbnailo thumbpara cambiar el tamaño de una imagen a aproximadamente el 75% del ancho de una imagen simple thumbnail. Esto es útil para mostrar imágenes en orientación "vertical" , ya que las imágenes altas y estrechas tienden a verse demasiado grandes cuando se escalan al mismo ancho que las imágenes orientadas "horizontales". La uprightopción aumenta o disminuye el tamaño de acuerdo con 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 el ancho estándar de miniatura. Por ejemplo , <lang="wikitext" inline>upright=x
uprightopción " " representa aproximadamente el 75% del ancho de la miniatura.</syntaxhighlight> (mostrado 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]](mostrado a la derecha).
Con esta opción, la imagen incrustada se muestra con su tamaño real dentro de un marco, independientemente del atributo "thumb" o "size", y el título, si lo hay, es visible en el marco. Sin las opciones left, center, y none, la imagen normalmente se encuentra 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 de las opciones excepto sizepxy alternate (caption) text, se representa una imagen incrustada en línea.
La opción nonese puede utilizar para tener miniaturas sin alineación a la izquierda o a la derecha. Esto probablemente sea más útil para las tablas . Este es un ejemplo:
Puedes poner 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. | Este es el [[ Palacio de Westminster ]] en Londres ]]Solo asegúrate de que la cantidad de corchetes de apertura y cierre sea la correcta. Si faltara uno o más, toda la línea de sintaxis de la imagen no funcionaría.
Son posibles opciones de formato de subtítulos adicionales; 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: red" > Londres </ span > ''' </ div >]] Las viñetas y los números de las listas a veces pueden superponerse a las imágenes flotantes a la izquierda, y las líneas sangradas pueden no aparecer correctamente cuando están junto a 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 pueda 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 utilizar para recortar una imagen de modo que se centre en una parte concreta de la misma o, alternativamente, para ampliar el área blanca que rodea una imagen para colocar mejor el wikitexto.
También existe la plantilla {{ Overlay }} :
Aquí sólo se enlaza el artículo 7.
Las imágenes se pueden superponer o superponer usando {{ Superimpose }} , {{ Superimpose2 }} o {{ Overlaid images }} .
Las imágenes se pueden recortar utilizando {{ CSS image crop }} o {{ Annotated image }} .
Después de haber colocado una imagen junto a un texto, se puede colocar más texto debajo y nuevamente utilizar todo el ancho con el siguiente marcado. Esto evita que aparezca una imagen junto al material que sigue a este marcado, posiblemente por razones estéticas o un cambio de temas.
Esto se puede emitir utilizando la plantilla {{ clear }} o {{ Clr }} o {{ - }} en ciertos espacios de nombres ( en , meta ).
Para mostrar fotografías de realidad virtual ( también conocidas como panoramas de 360 grados o fotosferas), utilice {{ PanoViewer }} .
Si no desea mostrar ni exhibir la imagen, sino solo hacer un enlace a la página de descripción de una imagen, utilice dos puntos iniciales antes de "Archivo:" en un enlace intra-wiki, como este: [[:File:STS-32 crew.jpg|STS-32 crew]]que da como resultado: Tripulación del 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 incluir archivos de audio o video en las páginas.
Tenga en cuenta que ninguno de estos ejemplos proporciona enlaces a Wikipedia:Media help 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 en sí. 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 que el reproductor se inicie a una hora distinta a las 0:00.
Desde junio de 2019, los archivos MIDI se pueden reproducir como cualquier otro archivo de sonido. Ver: Ayuda:Partitura .
[[ Archivo : Beethoven op. 33 núm. 1.medio | pulgar |[[ Bagatelas, op. 33 (Beethoven) | ''Bagatelas'' , op. 33 ]] , núm. 1 ]]Para mostrar un video tal como fue cargado con un subtítulo, utilice [[File:First flights in aviation history.ogg|frame|none|Caption text]].
" ". Utiliza el fotograma del vídeo en el momento dado como imagen fija inicial. El tiempo puede ser una cantidad de segundos, o horas, minutos y segundos separados por dos puntos. Sin un parámetro de tiempo en miniatura, se utiliza un fotograma del punto medio del vídeo de forma predeterminada. Por ejemplo, si se utiliza 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 que la hora de inicio aparece como 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 video más grande que su tamaño cargado, use " |thumb" y " ". Esto puede ser útil si el video original es muy pequeño pero muestra algunos detalles pequeños pero importantes, pero tenga en cuenta que el aumento de escala 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 utilizar dentro de una galería (ya sea con etiquetas <gallery> o con 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>
lossyparámetro para archivos tiff