stringtranslate.com

Ayuda:HTML en wikitexto

El software MediaWiki , que controla Wikipedia, permite el uso de un subconjunto de elementos HTML 5 , o etiquetas y sus atributos , para el formato de presentación. [1] Pero la mayor parte del HTML se puede incluir mediante el uso de marcado wiki equivalente o plantillas ; estos son generalmente preferidos dentro de los artículos, ya que a veces son más simples para la mayoría de los editores y menos intrusivos en la ventana de edición; pero el Manual de estilo de Wikipedia recomienda su uso en ciertos casos. (Véase Ayuda:Wikitexto para equivalentes wiki a etiquetas HTML que no se discuten de otro modo a continuación.) Y HTML es útil fuera de los artículos, por ejemplo para el formato dentro de las plantillas. Para obtener ayuda con el uso de hojas de estilo en cascada dentro de Wikipedia, consulte Ayuda:Hojas de estilo en cascada .

Algunas etiquetas parecen HTML, pero en realidad son etiquetas de extensión y analizador de MediaWiki, por lo que son realmente marcas wiki. Se puede comprobar el cumplimiento de HTML5 en las páginas mediante la validación. Algunos elementos y atributos son compatibles con MediaWiki y los navegadores, pero HTML5 los ha dejado obsoletos y, por lo tanto, ya no se deben utilizar.

Tutoriales

Esta página de ayuda solo ofrece una descripción general del marcado permitido. Para obtener más ayuda y especificaciones detalladas:

Atributos

Los atributos HTML brindan información adicional sobre un elemento y siempre se especifican en la etiqueta de inicio. Tienen el formato de un par nombre/valor, como name="value".

Los atributos globales se aplican a todas las etiquetas. MediaWiki no permite los atributos que no se enumeran aquí [1] :

Los atributos de microdatos HTML5 se aplican a todas las etiquetas: [2]

Otras etiquetas, como <table>los atributos de soporte específicos, se enumeran en la sección correspondiente.

MediaWiki Sanitizer.phprealiza una limpieza de atributos. Una práctica recomendada es utilizar la sintaxis adecuada.

Elementos

Estos elementos HTML son compatibles con el software MediaWiki. Esta sección ofrece una breve descripción general del elemento HTML, un ejemplo, el marcado wiki relevante y las plantillas.

Básico

h1, h2, h3, h4, h5, h6

Las etiquetas <h1>...</h1>through <h6>...</h6>son encabezados para las secciones con las que están asociadas. <h1>se utiliza para el título del artículo. Los encabezados se diseñan mediante CSS y se agregan a la tabla de contenido de la página .

Wikimarkup: rodee el texto con la cantidad adecuada de signos de igual. Los encabezados formateados con wikimarkup agregan un enlace [editar].


Plantillas: para usar en documentación{{fake heading}}

pag

<p>...</p>La etiqueta coloca el contenido en un párrafo separado.

Wikimarkup: separa los párrafos con una sola línea en blanco.

<p>...</p>es especialmente útil en listas, para elementos de lista con varios párrafos:

Tenga en cuenta que la etiqueta de cierre </p>no es estrictamente necesaria para las instalaciones de MediaWiki que generan HTML 5 (como Wikipedia).

es

<br>Inserta un salto de línea. Consulte H:BR para conocer las otras 4 versiones a las que el software MediaWiki convierte <br />el HTML que leen los navegadores.

Plantillas:

hora

<hr>o <hr />representa una ruptura temática a nivel de párrafo y se presenta como una regla horizontal.

Wikimarkup: uso----

Plantillas:{{hr}}

Comentarios

<!--...-->formatea el texto adjunto como un comentario oculto.

Tenga cuidado con el espacio entre los comentarios. Si rodea un comentario con líneas en blanco, se creará un párrafo en blanco, que se percibirá como dos líneas en blanco adicionales:

Formato

abr.

<abbr>...</abbr>crea una información sobre herramientas para definir una abreviatura o acrónimo que se muestra al pasar el mouse por encima.

Plantillas:{{abbr}}

b

<b>...</b>formatea el texto de manera estilísticamente separada del resto del texto (negrita) sin transmitir importancia adicional.

Wikimarkup: se utiliza '''para abrir y cerrar texto en negrita.

bdi

<bdi>...</bdi>Aísla el contenido de la configuración de dirección del texto circundante.

Soporte: Firefox, Chrome

bdo

<bdo>...</bdo>especifica la dirección del texto.

Atributos y valores:

cita en bloque

<blockquote>...</blockquote>presenta el texto en un bloque desplazado.

Plantillas: ; admite parámetros de fuente y atribución preformateados. Para otras plantillas de citas especializadas, consulte Categoría:Plantillas de citas .{{quote}}

citar

<cite>...</cite>Contiene el título de una obra. Esta es una nueva definición en HTML5: en la implementación anterior, XML <cite>se utilizaba para contener una cita o una referencia a otras fuentes. No se aplica ningún formato cuando se utiliza esta etiqueta.

<cite>...</cite>Generalmente no se utiliza directamente en los artículos de Wikipedia y a menudo se usa incorrectamente; consulte Wikipedia:HTML 5#cite para obtener instrucciones de reemplazo.

código

<code>...</code>Formatea una sección de código informático. Se diseñó con CSS como mediawiki.skinning/elements.lessuna tipografía monoespaciada negra con un fondo gris (#F8F9FA) y borde (#EAECF0).

Plantillas: utiliza . Consulta la sección "Ver también" en la página de plantillas para obtener plantillas de marcado de código adicionales.{{code}}<syntaxhighlight>

Consulte § samp y § kbd en esta página para el marcado semántico de salida y entrada, respectivamente.

datos

<data>...</data>formatea una versión legible por máquina del contenido.

Atributos:value

del

<del>...</del>formatea el texto eliminado.

Dfn

<dfn>...</dfn>se utiliza para indicar la instancia definitoria de un término.

Plantillas:{{dfn}}

ellos

<em>...</em>representa un fragmento de texto con énfasis enfático (es decir, énfasis semántico). En la mayoría de los navegadores, se muestra en cursiva.

Plantillas:{{em}}

i

<i>...</i>representa un fragmento de texto separado de su contenido circundante sin transmitir ningún énfasis o importancia adicional, y para el cual la presentación tipográfica convencional es texto en cursiva.

Wikimarkup: se utiliza ''para abrir y cerrar texto en cursiva.

En

<ins>...</ins>Indica un rango de texto que se ha añadido. Se presenta como texto subrayado. Se utiliza en páginas de discusión para indicar texto refactorizado; consulte WP:REDACT .

kbd

<kbd>...</kbd>indica la entrada del usuario, como la entrada del teclado o los comandos de voz (pero no gray background como con la plantilla ).{{kbd}}

Plantillas:

marca

<mark>...</mark>Representa una secuencia de texto en un documento marcada o resaltada para fines de referencia, debido a su relevancia en otro contexto. El texto marcado tiene un formato de fondo amarillo de manera predeterminada.

Soporte: No compatible con Internet Explorer 8 y anteriores.

pre

<pre>...</pre>El elemento representa un bloque de texto preformateado. En MediaWiki, es en realidad una etiqueta de analizador y no HTML, pero la función es la misma. También evita el análisis de plantillas.<pre>

Entidades HTML

<pre>analiza entidades HTML . Si desea omitir esto, reemplácelo &con &amp;o utilice <syntaxhighlight lang="text">en su lugar.

Plantillas:

q

<q>...</q>se utiliza para marcar una cita breve. Este elemento se ha implementado muy poco en Wikipedia hasta el momento.

MOS:QUOTATIONS dice que Wikipedia debería utilizar en su lugar "", {{ quote }} o <blockquote>.

rp, rt, rubí

<ruby>...</ruby>marca tramos de contenido de fraseo con anotaciones ruby.

Los navegadores que no admiten caracteres rubí mostrarán el texto rubí en tamaño normal, entre paréntesis y después del contenido normal.

Plantillas:

s

<s>...</s>se utiliza para indicar contenido que ya no es preciso o relevante y que ha sido eliminado de la página. No es adecuado para indicar ediciones de documentos; para marcar un fragmento de texto como eliminado de un documento, utilice <del>.

Plantillas:{{strikethrough}}

sémola gruesa de maíz

<samp>...</samp>Indica la salida de muestra de un programa o sistema informático. Algunos ejemplos incluyen: salida de un programa, script o plantilla de Wikipedia; visualizaciones de estado o anuncios de audio realizados por una aplicación o dispositivo; listados de directorios del sistema de archivos y muestras de ellos, como rutas y nombres de archivos.

Plantillas: aplica estilo monoespaciado y muestra el texto en gris oscuro para distinguirlo del código ( ) y la entrada ( o ).{{samp}}<code><kbd>{{kbd}}

pequeño

<small>...</small>Formato de texto pequeño.

Plantillas:

fuerte

<strong>...</strong>formatea un fragmento de texto con gran importancia o énfasis inusual; en la mayoría de los navegadores, se muestra en negrita. Por lo general, esto no se debe usar en los artículos de Wikipedia, según la política de punto de vista de WP:Neutral . Consulte MOS:BOLD sobre el uso de este elemento y otros elementos en negrita. La mayoría de los énfasis semánticos, incluso en material citado, se deben mostrar con el <em>elemento.

Plantillas:{{strong}}

sub

<sub>...</sub>formatea un fragmento de texto como subíndice.

Plantillas:

sorber

<sup>...</sup>formatea un fragmento de texto como superíndice.

Plantillas:

tiempo

<time>...</time>define una hora (reloj de 24 horas) o una fecha en el calendario gregoriano, opcionalmente con una diferencia de hora y zona horaria.

Atributos:datetime

Soporte: No compatible con Internet Explorer 8 y anteriores.

<u>...</u>representa un fragmento de texto separado de su contenido circundante sin transmitir ningún énfasis o importancia adicional, y para el cual la presentación tipográfica convencional es el subrayado; por ejemplo, un fragmento de texto en chino que es un nombre propio (una marca de nombre propio chino) o un fragmento de texto que se sabe que está mal escrito.

<u>era un elemento de presentación de HTML que se usaba originalmente para subrayar texto; este uso quedó obsoleto en HTML4 a favor del estilo CSS{text-decoration: underline} . [4] En HTML5, la etiqueta reapareció pero su significado cambió significativamente: ahora "representa un fragmento de texto en línea que debe representarse de una manera que indique que tiene una anotación no textual". [4] Esta función está destinada, por ejemplo, a proporcionar un subrayado de línea ondulada roja para marcar errores ortográficos en el momento de la entrada pero que no se deben incrustar en ningún archivo almacenado (a diferencia de una marca de énfasis, que sí lo sería).

Plantillas: (que proporciona el estilo CSS recomendado){{underline}}

variedad

<var>...</var>formatea el texto en cursiva para indicar una variable en una expresión matemática o un contexto de programación, o un texto de marcador de posición que el lector debe reemplazar mentalmente con algún otro valor literal.

Plantillas:

WBR-Español:

<wbr>es una oportunidad de salto de palabra; es decir, especifica dónde estaría bien agregar un salto de línea cuando una palabra es demasiado larga o se percibe que el navegador romperá una línea en el lugar equivocado.

A medida que la ventana del navegador se hace más estrecha, el segundo ejemplo se ajusta entre Hyper y Text .

Liza

No deje líneas en blanco entre los elementos de una lista a menos que exista una razón para hacerlo, ya que esto hace que el software MediaWiki interprete cada elemento como el comienzo de una nueva lista.

dl, dt, dd

<dl>...</dl>, <dt>...</dt>y <dd>...</dd>se utilizan para crear una lista de descripción (anteriormente, lista de definiciones) con términos y descripciones. Los términos se muestran en negrita y las descripciones tienen sangría. Cada término debe incluir una o más descripciones.

Wikimarkup: <dt>se crea utilizando ;while automáticamente encerrado entre <dl>...</dl>. <dd>se crea utilizando :para cada valor. Para un valor único o el primero, se :puede colocar en la misma línea después de ;donde los valores posteriores deben colocarse en líneas separadas.

Plantillas:{{defn}}

ol, ul, li

<ol>...</ol>representa una lista ordenada; <ul>...</ul>representa una lista desordenada; <li>...</li>representa un elemento de lista dentro de cualquier tipo de lista.

Wikimarkup: se utiliza *para elementos de una lista desordenada y #para listas ordenadas.

Plantillas: para una variedad de usos especializados, consulte Categoría:Plantillas de funciones y formatos de listas .

Contenedores

división

<div>...</div>es un contenedor genérico para contenido de flujo que se muestra como un elemento de bloque.

durar

<span>...</span>es un contenedor para contenido de flujo que se muestra como un elemento en línea.

Tablas

mesa, td, tr

<table>...</table>define una tabla.

Atributos:

El

<th>...</th>define un encabezado de tabla; con estilo centrado y en negrita.

Atributos:

subtítulo

<caption>...</caption>Agrega un título a una tabla.

Atributos:

cabeza, pie, cuerpo

<thead>, <tfoot>y <tbody>no son compatibles, pero se generan automáticamente cuando se renderiza la página.

Elementos obsoletos/en desuso

Estos elementos están obsoletos y se han eliminado o descontinuado en HTML5, aunque los navegadores aún los admiten. [5] Se debe evitar su uso en Wikipedia. Estas etiquetas tienen una etiqueta alternativa o una plantilla que reemplaza su función con CSS; los editores están reemplazando las etiquetas en las páginas de Wikipedia (consulte Wikipedia:Linter para obtener más detalles). Consulte Wikipedia:HTML5 § Elementos y atributos obsoletos para obtener más detalles sobre las partes HTML obsoletas y sus reemplazos.

centro

<center>...</center>(obsoleto)Se utilizó para centrar elementos de texto.

Plantillas: utiliza CSS.{{center}}

fuente

<font>...</font>(obsoleto)Se utilizó para establecer el tamaño de fuente, el tipo de fuente y el color del texto.

Plantillas: utiliza CSS.{{font}}

Rb

<rb>...</rb>(obsoleto)Se utilizó para marcar el texto base en una anotación ruby.

Para reemplazos, consulte: Ayuda:HTML en wikitext#rp, rt, ruby

huelga

<strike>...</strike>(obsoleto)caracteres tachados formateados; utilice <s>...</s>o <del>...</del>en su lugar, según el contexto.

El o

<tt>...</tt>(obsoleto)Texto formateado en una fuente de ancho fijo. Utilice <code>, <kbd>o <samp>en su lugar, según el contexto.

Plantillas: utiliza CSS.{{mono}}

Elementos no compatibles

Estos elementos no son compatibles, pero tienen un marcado wiki equivalente. Si intentas usar cualquier elemento que no esté en la lista blanca, Sanitizer.phpel marcado se mostrará como texto sin formato.

a

<a>se utiliza para crear enlaces. Utilice el [[ ]]wikimarkup para enlaces internos/intrawiki y enlaces interwiki , y [ ]para enlaces externos.

aporte

<input>Se utiliza para crear formularios . La <inputbox>etiqueta de extensión se utiliza para crear un cuadro de texto con un botón.

HTML ordenado

HTML Tidy es una biblioteca HTML4 obsoleta que está programada para eliminarse. Tidy analiza la salida de MediaWiki y la limpia para aumentar la probabilidad de que se muestre HTML4 válido. Por ejemplo, con Tidy habilitado, <br>, </br>, <br/>, <br.>se muestran todos como <br />. Tidy no está habilitado para las páginas de interfaz de MediaWiki . Tidy nunca fue perfecto y se sabe que introduce errores.

Excepciones

En algunas páginas del espacio de nombres MediaWiki , normalmente los mensajes cortos como las etiquetas de los botones, el HTML no se analizan y las etiquetas quedan expuestas.

Las páginas CSS y JavaScript de usuario y de todo el sitio se interpretan como si estuvieran dentro de un <pre>bloque. Consulte Ayuda:Estilo de usuario .

Validación

El software MediaWiki intenta corregir errores HTML, pero no los detecta todos. Cuando se utiliza HTML, resulta útil verificarlo con el Servicio de validación de marcado del W3C .

Etiquetas de extensión y de analizador

  • Ayuda:Etiqueta de extensión
  • Ayuda: Etiqueta del analizador

Para obtener una lista generada por máquina, consulte Special:Version#mw-version-parser-extensiontags . Puede incluir etiquetas que no se encuentran documentadas aquí.

Etiquetas del analizador
<gallery>, , , , ,<includeonly><noinclude><nowiki><onlyinclude><pre>
Etiquetas de extensión
<categorytree>, <charinsert>, (alias ), , , , , , , , , , , , , , , (alias ), , ,<chem><ce><graph><hiero><imagemap><indicator><inputbox><mapframe><maplink><math><math chem><poem><ref><references><score><section><syntaxhighlight><source><templatedata><templatestyles><timeline>

Véase también

Referencias

  1. ^ ab Los elementos y atributos permitidos se definen en el Sanitizer.phpmódulo.
  2. ^ "El modelo de microdatos". HTML Living Standard .
  3. ^ abc Para la celda de la tabla se eligió un color de fondo blanco para visualizar mejor el fondo gris claro.
  4. ^ ab "<u>: El elemento de anotación no articulada (subrayado)". mozilla.org . 1 de agosto de 2020 . Consultado el 9 de octubre de 2020 .
  5. ^ abcde «HTML5: Un vocabulario y API asociadas para HTML y XHTML: Características obsoletas». W3C . 31 de julio de 2014.

Enlaces externos