stringtranslate.com

Ayuda:HTML en wikitexto

El software MediaWiki , que impulsa Wikipedia, permite el uso de un subconjunto de elementos HTML 5 , o etiquetas y sus atributos , para dar formato a la presentación. [1] Pero la mayor parte del HTML se puede incluir utilizando plantillas o marcas wiki equivalentes ; generalmente se prefieren 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 determinados casos. (Consulte Ayuda: Wikitext para conocer los equivalentes wiki de las etiquetas HTML que no se analizan a continuación). Y HTML es útil fuera de los artículos, por ejemplo para formatear dentro de las plantillas. Para obtener ayuda con el uso de las hojas de estilo en cascada en Wikipedia, consulte Ayuda: Hojas de estilo en cascada .

Algunas etiquetas parecen HTML, pero en realidad son etiquetas de extensión y analizador de MediaWiki, y también lo son en realidad marcas wiki. Se puede comprobar que el HTML de las páginas cumple con HTML5 mediante la validación. Algunos elementos y atributos son compatibles con MediaWiki y los navegadores, pero han quedado obsoletos en HTML5 y, por lo tanto, ya no deberían usarse.

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 proporcionan información adicional sobre un elemento y siempre se especifican en la etiqueta de inicio. Están formateados como un par de nombre/valor como name="value".

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

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

Otras etiquetas, como las <table>que admiten atributos específicos, se enumeran en la sección correspondiente.

MediaWiki Sanitizer.phprealiza una limpieza de atributos. Una mejor práctica 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, marcas wiki relevantes y plantillas.

Básico

h1, h2, h3, h4, h5, h6

Las etiquetas <h1>...</h1>directas <h6>...</h6>son encabezados de las secciones a 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: rodea el texto con el número adecuado de signos iguales. Los encabezados formateados con wikimarkup agregan un enlace [editar].


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

pag

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

Wikimarkup: Separe 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).

hermano

<br>inserta un salto de línea. Consulte H:BR para conocer las otras 4 versiones a las que el software MediaWiki convierte en <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. Rodear un comentario con líneas en blanco dará como resultado un párrafo en blanco, percibido como dos líneas en blanco adicionales:

Formato

abbr

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

Plantillas:{{abbr}}

b

<b>...</b>formatea el texto estilísticamente separado de otro texto (negrita) sin transmitir importancia adicional.

Wikimarkup: Úselo '''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 texto en un bloque desplazado.

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

citar

<cite>...</cite>contiene el título de una obra. Esta es una nueva definición en HTML5; en la implementación XML anterior <cite>se usaba 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 usa 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 de computadora. Diseñado con CSS como tipo de letra monoespaciadomediawiki.skinning/elements.less negro con fondo gris (#F8F9FA) y borde (#EAECF0).

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

Consulte § samp y § kbd en esta página para conocer 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 tramo de texto con énfasis enfático (es decir, énfasis semántico). En la mayoría de los navegadores, aparece en cursiva.

Plantillas:{{em}}

i

<i>...</i>representa un tramo de texto separado del contenido que lo rodea 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 s

<ins>...</ins>indica un rango de texto que se ha agregado. Diseñado como texto subrayado. Se utiliza en páginas de discusión para indicar texto refactorizado; ver WP: REDACTAR .

kbd

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

Plantillas:

marca

<mark>...</mark>representa una serie de texto en un documento marcado o resaltado con fines de referencia, debido a su relevancia en otro contexto. El texto marcado tiene el formato de fondo amarillo de forma predeterminada.

Soporte: No es compatible con Internet Explorer 8 y versiones anteriores.

pre

<pre>...</pre>El elemento representa un bloque de texto preformateado. En MediaWiki, en realidad es 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 escapar de esto, reemplácelo &con &amp;o utilícelo <syntaxhighlight lang="text">en su lugar.

Plantillas:

q

<q>...</q>se utiliza para marcar una cita breve. Todavía ha habido muy poca implementación de este elemento en Wikipedia.

MOS:QUOTATION dice que Wikipedia debería usar "", {{ quote }} o <blockquote>.

rp, rt, rubí

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

Los navegadores que no admiten caracteres Ruby mostrarán el texto Ruby 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 apropiado cuando se indican 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. Los ejemplos incluyen: salida de un programa, script o plantilla de Wikipedia; pantallas de estado o anuncios de audio realizados por una aplicación o dispositivo; listados de directorios del sistema de archivos y ejemplos de ellos, como rutas y nombres de archivos.

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

pequeño

<small>...</small>formatear texto pequeño.

Plantillas:

fuerte

<strong>...</strong>formatea un tramo de texto con gran importancia o énfasis inusual; en la mayoría de los navegadores se muestra en negrita. Por lo general, esto no debe usarse en artículos de Wikipedia, según WP: política de punto de vista neutral . Consulte MOS:BOLD sobre el uso de este elemento y otras negritas. La mayor parte del énfasis semántico, incluso en el material citado, debe presentarse con el <em>elemento.

Plantillas:{{strong}}

sub

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

Plantillas:

sorber

<sup>...</sup>formatea un tramo 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 hora y un desplazamiento de zona horaria.

Atributos:datetime

Soporte: No es compatible con Internet Explorer 8 y versiones anteriores.

tu

<u>...</u>representa un tramo de texto separado del contenido que lo rodea sin transmitir ningún énfasis o importancia adicional, y para el cual la presentación tipográfica convencional está subrayada; 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 en favor del estilo CSS{text-decoration: underline} . [4] En HTML5, la etiqueta reapareció pero su significado cambió significativamente: ahora "representa un tramo 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 una línea roja ondulada subrayada para señalar errores de ortografía en el momento de la entrada, pero que no deben incrustarse 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}}

var

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

Plantillas:

wbr

<wbr>es una oportunidad para romper palabras; 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 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 haya una razón para hacerlo, ya que esto hace que el software MediaWiki interprete cada elemento como si comenzara una nueva lista.

dl, dt, dd

<dl>...</dl>y <dt>...</dt>se <dd>...</dd>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 usando ;mientras se incluye automáticamente en <dl>...</dl>. <dd>se crea usando :para cada valor. Para un valor único o primero, se :puede colocar en la misma línea después de ;donde los valores posteriores se deben colocar 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: uso *para elementos en una lista desordenada y #para listas ordenadas.

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

Contenedores

div

<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 fluido que se muestra como un elemento en línea.

Mesas

mesa, td, tr

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

Atributos:

th

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

Atributos:

subtítulo

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

Atributos:

cabeza, pie, cuerpo

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

Elementos obsoletos/obsoletos

Estos elementos ahora están obsoletos y obsoletos o eliminados en HTML5, pero aún son compatibles con los navegadores. [5] Estas etiquetas no deben usarse en Wikipedia. Estas etiquetas tienen una etiqueta alternativa o una plantilla que reemplaza su función con CSS. Consulte Wikipedia: HTML5 § Elementos y atributos obsoletos para obtener más detalles sobre partes HTML obsoletas y sus reemplazos.

centro

<center>...</center>(obsoleto)se utiliza para centrar elementos de texto.

Plantillas: utiliza CSS.{{center}}

fuente

<font>...</font>(obsoleto)se utiliza 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 utiliza para marcar texto base en una anotación Ruby.

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

huelga

<strike>...</strike>(obsoleto)formatea caracteres tachados; utilizar <s>en su lugar.

TT

<tt>...</tt>(obsoleto)formatea el texto en una fuente de ancho fijo. Utilice <code>, <kbd>o <samp>en su lugar.

Plantillas: utiliza CSS.{{mono}}

Elementos no soportados

Estos elementos no son compatibles, pero tienen un marcado wiki equivalente. Si intenta utilizar cualquier elemento que no esté incluido 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 ser eliminada. Tidy analiza la salida de MediaWiki y la limpia para aumentar la probabilidad de que se represente HTML4 válido. Por ejemplo, con Tidy habilitado, <br>, </br>, <br/>, <br.>todo se representa como <br />. Tidy no está habilitado para las páginas de la interfaz MediaWiki . Tidy nunca fue perfecto y se sabe que introduce errores.

Excepciones

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

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

Validación

El software MediaWiki intenta corregir errores de 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 analizador y extensión

  • 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 no 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>

Ver también

Referencias

  1. ^ ab Los elementos y atributos permitidos se definen en el Sanitizer.phpmódulo.
  2. ^ "El modelo de microdatos". Estándar de vida HTML .
  3. ^ abc Para la celda de la tabla, aquí se eligió un color de fondo blanco para mostrar 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: vocabulario y API asociadas para HTML y XHTML: funciones obsoletas". W3C . 31 de julio de 2014.

enlaces externos