Plantilla:Dfn
{{{1}}}
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
Uso
Esta plantilla aplica el elemento de frase HTML <dfn> alrededor del texto dado como primer parámetro, el término , y, si el segundo parámetro de definición opcional está presente, aplica un subrayado punteado (un estilo común en toda la Web para indicar un término con una función de definición) y una ventana emergente de definición " información sobre herramientas " cuando el foco del cursor está en el término.
Sin el segundo parámetro, no hace nada de cara al usuario y es solo una forma de metadatos que pueden ser detectados y utilizados por software interno y externo (bots de recopilación de estadísticas, aplicaciones Web 2.0 enriquecidas, etc.) y pueden proporcionar información contextual valiosa a los editores.
Algunas otras plantillas la utilizan como metaplantilla. Cuando se utiliza sola, su propósito más común sería en torno a un término que aparece en negrita en un artículo y se define inmediatamente allí, como una pieza clave de terminología introducida después de la sección principal. Wikipedia no es un diccionario , por lo que esta plantilla no debe utilizarse para atraer la atención de los metadatos hacia palabras cotidianas, y es más adecuada en lugares donde hay una definición breve o una aclaración de la jerga que es importante en el contexto.
(Detalle técnico: al usar un interno <span>...</span>con su propio titleatributo independiente para la diversión de la información sobre herramientas, lo configura de una manera que no viola la especificación HTML 5 sobre el manejo del titleatributo de <dfn>, que es el término exacto definido, no su definición).
Propósito y aplicación
Este marcado indica que el texto es la instancia que define ese término (palabra, frase, nombre, etc.) en la página en la que aparece. Por lo tanto, debe usarse solo una vez por término y por página.
Wikipedia no es un diccionario , por lo que esta plantilla no se debe utilizar para proporcionar definiciones de palabras cotidianas, y es más adecuada para definiciones breves o aclaraciones de jerga que son importantes en el contexto pero que es poco probable que todos nuestros lectores en general comprendan por completo. La plantilla se puede adaptar a la mayoría de los casos directamente editables en los que el <dfn>elemento sería útil.
Debido a que el contenido del parámetro de definición no es fácilmente accesible para los usuarios de la mayoría (si no todos) del software de lectura de pantalla , navegadores de solo texto, navegadores de teléfonos móviles, etc., el segundo parámetro nunca debe usarse para brindar información vital para comprender el tema del artículo, solo es conveniente o complementario para aquellos que pueden acceder a él; la información vital pertenece a la prosa principal del artículo.
Esta plantilla no debe utilizarse para marcar entradas de glosario ni enlaces a ellas; consulte {{ term }} y {{ glossary link }} , respectivamente. Asimismo, esta plantilla no debe utilizarse para marcar el asunto del artículo en negrita en el encabezado; [se prevé que] se creará otra plantilla, [nombre a publicarse, probablemente Template:Subject], para utilizarla con este fin, que incluya el marcado en negrita necesario y [quizás] otras características de metadatos y marcado.
Este es un marcado semántico , no simplemente un estilo de presentación, y tiene un significado particular predefinido; no use esta plantilla de manera incorrecta solo para obtener sus efectos de visualización. Si el contenido que se está marcando no es adecuado para el <dfn>elemento según lo definido por las especificaciones HTML del W3C, entonces no debe usar esta plantilla.
Parámetros
Hay dos parámetros básicos, el primer parámetro obligatorio, el término , y el segundo opcional, la definición :
{{dfn|term}}{{dfn|term|definition}}
Si se proporciona el parámetro de definición y el navegador del lector admite la funcionalidad, mover el foco del navegador al término (por ejemplo, al pasar el cursor del mouse sobre él o, en algunos navegadores, al usar la navegación con el teclado para acceder a él) cambiará el cursor a la versión de "ayuda" (normalmente un signo de interrogación) y mostrará el texto de la definición en una información sobre herramientas emergente (o en alguna otra interfaz, según lo proporcione el navegador en cuestión). Sin un segundo parámetro, no se producen estos efectos de subrayado y de información sobre herramientas.
Lo más seguro es numerarlos explícitamente, pero esto solo es absolutamente necesario si el contenido contiene un signo igual en alguna parte:
{{dfn|1=term|2=definition}}{{dfn|term|2=definition}}– esto funciona si solo la definición tiene un "=".{{dfn|1=term|definition}}– esto falla; si el parámetro 1 está numerado, también debe estarlo el parámetro 2
Si no se proporciona ninguna definición , la plantilla es invisible:
{{dfn|ecdysis|moulting of the exoskeleton}}resultados en: ecdisis{{dfn|ecdysis}}, the moulting of the exoskeletonresultados en: ecdisis , la muda del exoesqueleto[[Ecdysis|{{dfn|ecdysis}}]]resultados en: ecdisis
Los segundos y terceros casos "invisibles" no serán detectados por los lectores ocasionales, pero aún así pueden ser detectados y tratados por software interno y externo (bots de recopilación de estadísticas, aplicaciones Web 2.0 enriquecidas, etc.) y pueden proporcionar información contextual valiosa a los editores.
El parámetro de definición se omite con mayor frecuencia cuando el texto que sigue al término proporciona el contenido definitorio en línea en la prosa, o cuando el término está vinculado a una explicación en otra parte, como se muestra arriba. Un caso común de esto es cuando un artículo proporciona un término en negrita y una explicación del mismo, a menudo al comienzo de un párrafo o sección, lo que indica un tema secundario significativo en el artículo, subordinado al tema principal del artículo en negrita en la introducción.
Otros parámetros opcionales
|title=exact, plaintext term being defined– se utiliza a) cuando el contenido del primer parámetro (término) contiene cualquier wikimarkup o HTML; o b) cuando el término que se define es en realidad ligeramente diferente (es decir, más preciso que) el contenido marcado; el verdadero término que se define va en este parámetro. Cualquier comilla doble (") debe ser escapada, como".
Ejemplo del mundo real: mostrar un término impreciso en el texto y su nombre oficial preciso como|title=, con comillas escapadas:{{dfn|Mac OS X Lion|title=Mac OS X 10.7 "Lion"}}, lo que da como resultado: Mac OS X Lion (pasa el cursor sobre él para ver que la información sobre herramientas es diferente del contenido base)|id=an_ID– un ID (sin espacios, debe comenzar con una letra del alfabeto) para #vincular y posiblemente otros propósitos|style=arbitrary:css;– Directivas CSS para personalizar el estilo de la instancia|class=css_class– una o más clases CSS (separadas por espacios, no por comas, si hay más de una)
Personajes problemáticos
Si hubiera un " =" (signo igual) en el término , a) ambos parámetros sin nombre, si están presentes, deben estar numerados explícitamente:
{{dfn|1=E=MC2|2=Mass–energy equivalence}}lo que resulta en: E=MC 2
o b) el carácter en sí puede escaparse como el código de referencia de entidad de carácter= HTML o la plantilla:{{=}}
{{dfn|E=MC2|Mass–energy equivalence}}lo que resulta en: E=MC 2{{dfn|E{{=}}MC2|Mass–energy equivalence|title=E=MC²}}lo que resulta en: E=MC 2
No se conocen otros caracteres que resulten problemáticos en el término .
Por razones técnicas, el segundo parámetro ( |2=, la definición ) es más "frágil". El signo igual ( =) debe ser escapado por una de las técnicas que acabamos de mencionar, y las comillas dobles estándar del teclado (rectas, no curvas) ( ") también deben ser escapadas, sin importar cómo, como "o ". Estas comillas dobles también deben ser escapadas de la misma manera en el |title=parámetro:
{{dfn|1=ACT UP's slogan|2="Silence = Death"}}Lo que resulta en: el lema de ACT UP{{dfn|ACT UP's slogan|"Silence {{=}} Death"}}Lo que resulta en: el lema de ACT UP{{dfn|ACT UP's slogan|"Silence = Death"}}Lo que resulta en: el lema de ACT UP{{dfn|"Teenage Wasteland"{{sic}}|title="Baba O'Riley"}}Lo que resulta en: "Teenage Wasteland" [ sic ]
Enlaces y marcado
Los enlaces y el marcado wiki deben realizarse fuera de la plantilla cuando sea posible:
- Bien:
'''[[Foo|{{dfn|Foo}}]]''' - Equivocado:
{{dfn|'''[[Foo]]'''}}
El término contenido en el primer parámetro puede estar marcado con wikimarkup o HTML, a inlinenivel de texto, como cursiva, superíndice u otro código de formato de texto (en comparación con blockelementos de nivel de texto, como párrafos, tablas, citas en bloque, etc.), si es absolutamente necesario. Si se hace esto, el |title=parámetro debe contener el término de texto simple sin marcar. Ejemplo: el texto mostrado (primer parámetro) utiliza marcado de superíndice, por razones de accesibilidad, mientras que el texto simple real en el parámetro de título utiliza una entidad de carácter Unicode (no cuenta como wikimarkup) para un 2 superíndice, que en realidad es más correcto pero puede que no se muestre correctamente en sistemas más antiguos:
{{dfn|1=E=MC<sup>2</sup>|title=E=MC²}}
rendimientos:
- E= MC2
mientras esto:
{{dfn|1=E=MC<sup>2</sup>|2=Mass–energy equivalence; E is energy, m is mass, and c is the speed of light in a vacuum|title=E=MC²}}
da:
- E= MC2
Tenga en cuenta que en el primer caso, la información sobre herramientas al pasar el mouse es la versión Unicode del término , tal como se proporciona en el |title=, mientras que en el último es la definición proporcionada en el |2=parámetro.
Versión vinculada:
[[Mass–energy equivalence|{{dfn|1=E=MC2|2=Mass–energy equivalence; E is energy, m is mass, and c is the speed of light in a vacuum|title=E=MC²}}]]
da:
Todavía tiene un subrayado punteado que indica una información sobre herramientas, pero también es un enlace azul. Al pasar el mouse sobre el enlace, se muestran tanto la información sobre herramientas como, en la barra de estado, la URL de destino, en los navegadores que admiten estas funciones.
Enlace dentro del {{dfn}}:
{{dfn|1=[[Mass–energy equivalence|E=MC2]]|2=Mass–energy equivalence; E is energy, m is mass, and c is the speed of light in a vacuum|title=E=MC²}}
resultados en:
Esto no daña la página, pero la definición falla y no hay un cursor de información sobre herramientas; mientras tanto, el marcado es difícil de entender para otros editores, por lo que está obsoleto .
Los enlaces, HTML, wikimarkup y otros marcados no se pueden aplicar al contenido en el parámetro |2=( definición ), ni en un |title=parámetro, solo texto simple y referencias de entidades de caracteres ("&-codes", como ").
Anclajes e identificación
Ejemplo en el que se agrega un {{ anchor }}2= . Como falta, no aparece ningún texto cuando se pasa el ratón sobre el término recién definido " open set".
An {{em|{{dfn|1=open set|id=dfn-anchorname open set}}}} is defined as ...<br/><br/> This makes it an example of an [[#dfn-anchorname open set|open set]].
resultados en:
- Un conjunto abierto se define como...
Esto lo convierte en un ejemplo de conjunto abierto.
Contraste con la alternativa que utiliza la plantilla {{ visible anchor }} :
An {{em|{{visible anchor|open set}}}} is defined as ...<br/><br/> This makes it an example of an [[#open set|open set]].
Lo que resulta en:
- UnEl conjunto abierto se define como...
Esto lo convierte en un ejemplo de conjunto abierto.
Tenga en cuenta que al hacer clic en el enlace "Abrir conjunto", el texto se resaltará.
Véase también
- {{ dfni }} es un contenedor para {{ dfn }} que aplica cursiva para usos MOS:TECHNICAL
- Relacionado con {{ glossary link }} , una variante para usar con glosarios independientes e integrados
- {{ abr }}
- {{ información sobre herramientas }}
- No debe confundirse con {{ defn }} (pero consulte las plantillas de glosario relacionadas {{ glossary }} , {{ glossary end }} y especialmente {{ term }} ; la última de estas también hace uso del
dfnelemento HTML)
