Modelo:Imaxe anotada/uso

Este modelo permite a adición de notas de texto explicativas a imaxes (o texto pode conter ligazóns), que xeralmente é máis lexible que se o texto forma parte da propia imaxe, especialmente se esta é reducida en tamaño.

Outros usos inclúen recortar (cropping) unha imaxe para excluír partes menos importantes e agrandar partes importantes, e a internacionalización, xa que as anotacións poden cambiarse a oiutro idioma sen ter que cambiar a imaxe.

Este modelo utiliza {{annotation}} para superpoñer wikitexto sobre as imaxes.

Sintaxe

{{Imaxe anotada
| image = 
| image-width = 
| image-left = 
| image-top = 
| width = 
| height = 
| float = 
| annotations = 
| caption = 
| icon = 
}}

Parámetros

Todos os parámetros teñen nomes; non hai parámetros "numerados" sen nomear.

Dous dos parámetros, image e imagemap, son mutuamente excluíntes: use un deles, non ambos.

Na seguinte lista, os parámetros requiridos polo modelo móstranse en letra grosa.

Parámetro	Valores permitidos	Valores por defecto	Función e notas
caption	wikitexto		Lenda que acompaña a imaxe.
alt	texto	baleiro	Alt text para persoas con problemas de visión.
Either  image or  imagemap	nome do arquivo de imaxe válido<sup<a ou un imagemap X/HTML válido		Especifican image ou imagemap, pero non ambos.
width	número enteiro positivo	–	Ancho total en píxeles docadro que contén a imaxe e as anotacións. Debe ser polo menos tan grande como a imaxe mostrada (o que se pode indicar en image-width).
height	número enteiro positivo	–	Altura total en píxeles do mcadro que contén a imaxe e as anotacións. Debe ser tan grande como a altura da imaxe mostrada. Se a anchura mostrada da imaxe se cambia especificándoo en image-width, terá que calcularse a altura da imaxe mostrada e calquera "marxe" adicional para as anotacións.
image-left	integer	(zero)	Coordenada X da esquina superior esquerda da imaxe en píxeles, en relación coa esquina superior esquerda do cadro que contén as imaxes e anotacións. Os valores negativos recortan a imaxe.
image-top	número enteiro	(cero)	Coordenada Y da esquina superior esquerda da imaxe en píxeles, en relación coa esquina superior esquerda do cadro que contén a imaxe e as anotacións. Os valores negativos recortan a imaxe.
image-width	número enteiro positivo		Anchura da imaxe en píxeles.
annotations			Anotacións da imaxe. Pode deixarse baleiro (é dicir, |... |annotations= |...) para só recortar a imaxe.
float	right left none	right (dereita)	Para especificar se o modelo flotará ou non á dereita ou esquerda dos contidos adxacentes.
outer-css	calquera CSS válido	–	CSS adicionais aplicados á parte máis externa do cadro. Non sobrescribe ningún outro parámetro especificado para o cadro externo (é dicir, é mellor usalo só como un "último recurso").
image-bg-color	calquera cor CSS válido	branco	Fondo do cadro no cal se mostra a imaxe. Por exemplo, un fondo escuro para unha imaxe relativamente escura na cal se sitúan anoltacións de cores relativamente claras.
image-css	calquera CSS válido	–	CSS adicional aplicado á (cadro interno que contén) imaxe. Non sobreescribe ningún outro parámetro especificado para este cadro (é dicir, é mellor usalo só como un "último recurso").
annot-text-align	left right center	left (esquerda)	Establece o aliñamento de texto para todas as anotacións contidas. Pode ser sobrescrito por annotation.
annot-background-color	calquera cor CSS válida	transparente	Establece nha cor de fondo por defecto parsa todas as anotacións contidas. Pode seer sobreescrito por annotation.
annot-font-family	calquera CSS válido de familia de fontes	–	Establece unha familia de fontes por defecto para todas as anotaciñosn contidas. Pode ser sobrescrito por anotación.
annot-font-size	número eneiro positivo	–	Establece un tamaño de fonte por defecto en píxeles para todas as anotacións contidas. Pode ser sobescrito por annotation.
annot-font-weight	calquera CSS válido para font-weight	–	Estableced a font-weight por defecto para todas as anotacións contidas. Pode ser sobrescrito por annotation.
annot-font-style	calquera CSS válido para font-style	–	Establece un estilo de fonte por defecto (por exemplo "cursiva") para todas as anotacións contidas. Pode ser sobrescrito por annotation.
annot-line-height	calquera CSS válido para line-height	–	Establece un line-height (espazo entre lilñas) por defecto para todas as anotaciñons contidas. Pode ser sobrescrito por annotation.
annot-color	calquera cor CSS válido	–	Establece a cor por defecto para todas as anotacións contidas. Pode ser sobrescrito por annotation.
icon	texto normal	A imaxe de arriba contén ligazóns clicables icona	Establece a icona (para eliminar a icona use |icon=none|).

^a Poden usarse imaxes SVG.

Internacionalización

Este modelo trata de facilitrar a internacionalización; o texto está xa separadoda imaxe, polo que é doado de traducir e, se é necesario, mover partes do texto, xa que as lonxitudes do mesmo texto en diferentes linguas poden variar moito. Por exemplo, nl:Sjabloon:Zijbalk mariene extincties, a versión holandesa de Modelo:Imaxe anotada/Extinction.

Dificultades

Hai unha dificultade que se pode presentar, aínda que ten que ver principalmente co uso dun buscador da forma axeitada (Microsoft Internet Explorer, por suposto). Internet Explorer ten dúas maneiras de escalar un texto para facilitar a lectura:

• Redimensionar un texto, que aparece no menú Ver de Internet Explorer, afecta ao texto pero non ás imaxes. Este método pode alterar as imaxes anotadas, xa que o texto é escalado pero a imaxe contida e o marco non. Firefox e Opera non usan este mecanismo.
• O zoom tamén escala a imaxe e os textos das anotacións, e así non distorsiona os tamaños relativos e localizacións das anotacións en imaxeds anotadas. Netscape e os seus derivados Mozilla, Firefox e Opera teñen tamén zoom desde jhai anos, e é mási útil, xa que tamén escala o texto que forma parte dunha imaxe, por exemplo como no logo de Wikipedia. As secuencias de control (atallos) de zoom (CTRL + para aumentar, CTRL - para diminuír) son as mesmas en Firefox, Opera e Internet Explorer. En Firefox e Opera, hai tamén menús paa o zoom, que mostran as secuencias de control.

Exemplos

Modelo:Annotated image/Extinction

Engadir notas explicativas

Ver Modelo:Annotated image/doc/Samples.

Recortar

Se ten unha imaxe como commons:Ficheiro:Mona Lisa color restoration2.jpg, pero quere mostrar só unha partre da imaxe, por exemplo a parte da boca e o nariz:

Esta imaxe ten unha anchura de 300 píxeles (tal como está almacenado en Wikimedia Commons), pero isto é irrelevante para o uso deste modelo.

Todas as medidas relacionadas coa anchura da imaxde, a anchura virtual que lle deu á imaxe (neste exemplo: 2000px)

Pode facelo co seguinte código:

{{Imaxe anotada
| image = Mona Lisa color restoration2.jpg
| image-width = 2000  <!-- elixa calquera anchura, se quere. Non importa a anchura real da imaxe-->
| image-left = -850   <!-- recorte a parte esquerda. Teña coidado do "-" símbolo de menos  --> 
| image-top = -800    <!-- recorte a parte superior. Teña coidado co "-" ´símbolo de menos  -->
| width =  250        <!-- recorte a parte dereita. Esa será a anchura da imaxe no artigo -->
| height =  250       <!-- recorte a parte inferior. Esa será a altura da imaxe no artigo -->
| float = left
| annotations =       <!-- este parámetro debe incluírse, estea baleiro ou non -->
| caption = Mona Lisa recortada dunha imaxe de 2000 píxeles
| icon = none
}}

O resultado é un ha área de 250 píxeles x 250 píxeles a partir dunha anchura de imaxe de 2000 píxeles (a anchira real da imaxe non importa). Os 800 píxeles superiores e os 850 píxeles no lado esquerdo da imaxe de 2000 son "discartados" e tamén o "resto" no lado dereito alén dos 250 píxeles e na parte de abaixo alén dos 250 píxeles:

Mona Lisa recortada dunha imaxe de 2000 píxeles

Véxase tamén

• {{Annotation}}, para crear anotacións.