Modelo:Imaxe anotada

Na Galipedia, a Wikipedia en galego.
Saltar ata a navegación Saltar á procura
Test Template Info-Icon - Version (2).svg Indicacións de uso do modelo

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[editar a fonte]

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

Parámetros[editar a fonte]

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 imaxde 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[editar a fonte]

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[editar a fonte]

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[editar a fonte]

Modelo:Annotated image/Extinction

Engadir notas explicativas[editar a fonte]

Ver Modelo:Annotated image/doc/Samples.

Recortar[editar a fonte]

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[editar a fonte]

Este recadro non aparecerá no artigo.
Esta documentación está transcluída desde Modelo:Imaxe anotada/uso. Os editores poden probar cambios no mesmo en Modelo:Imaxe anotada/probas.
Por favor, engade as categorías na subpáxina de documentación e os interwikis no Wikidata. Ver as subpáxinas deste modelo.