El software MediaWiki, que maneja Wikipedia, permite el uso de un subconjunto de elementos HTML 5 , o etiquetas y sus atributos , para formatear la presentación. [1] Pero la mayoría de HTML se puede incluir usando plantillas o marcas de wiki equivalentes ; 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. (Ver Ayuda: Wikitextpara wiki equivalentes a etiquetas HTML que no se describen a continuación.) Y HTML es útil fuera de los artículos, por ejemplo, para formatear dentro de 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 se parecen a HTML, pero en realidad son etiquetas de extensión y analizador de MediaWiki , por lo que son marcas de wiki. Se puede verificar el cumplimiento de HTML5 en las páginas mediante la validación . Algunos elementos y atributos son compatibles con MediaWiki y los navegadores, pero HTML 5 han dejado de utilizarlos y, por lo tanto, ya no deberían utilizarse.
Tutoriales
Esta página de ayuda ofrece solo una descripción general del marcado permitido. Para obtener más ayuda y especificaciones detalladas:
- Introducción a HTML5 en developer.mozilla.org
- Introducción a HTML5 en w3schools.com
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. Los atributos que no se enumeran aquí no están permitidos por MediaWiki [1] :
class
: una o más clasificaciones a las que pertenece el elemento. Ver Wikipedia: Catálogo de clases CSS .dir
: dirección del texto:"ltr"
(de izquierda a derecha),"rtl"
(de derecha a izquierda) o"auto"
.id
: identificador único del elemento.lang
: idioma principal para el contenido del elemento según BCP 47 .style
: aplica estilo CSS al contenido del elemento.title
: información de aviso asociada al elemento.
Los atributos de microdatos HTML5 se aplican a todas las etiquetas: [2]
- Cualquier atributo que comience con
data-
itemid
itemprop
itemref
itemscope
itemtype
Otras etiquetas, como
atributos específicos de soporte, se enumeran en la sección correspondiente.
Margen | Renderiza como |
---|---|
| Este es el texto rojo . |
MediaWiki Sanitizer.php
hace una limpieza en los atributos. Una buena práctica es utilizar la sintaxis adecuada.
- Descarta los atributos que no están en una lista blanca para el elemento dado.
- Convierte entidades rotas o inválidas en texto sin formato.
- Comillas dobles todos los valores de los atributos.
- Los atributos sin valores reciben el nombre como valor.
- Los atributos dobles se descartan.
- Los atributos de estilo no seguros se descartan.
- Antepone espacio si hay atributos.
Elementos
Estos elementos HTML son compatibles con el software MediaWiki. Esta sección ofrece una breve descripción general del elemento HTML, un ejemplo, wikimarkup y plantillas relevantes.
Básico
h1, h2, h3, h4, h5, h6
Las etiquetas through
son encabezados de las secciones con las que están asociadas. ...
se utiliza para el título del artículo. Los títulos se diseñan mediante CSS y se agregan a la tabla de contenido de la página .
Margen | Renderiza como |
---|---|
| |
Wikimarkup: rodee el texto con el número apropiado de signos iguales. Los encabezados formateados con wikimarkup agregan un enlace [editar].
Margen | Renderiza como |
---|---|
= Título 1 === Título 2 ===== Título 3 ======= Título 4 ========= Título 5 =========== Encabezado 6 ====== | |
Plantillas: para usar en documentación{{fake heading}}
pag
...
La etiqueta coloca el contenido en un párrafo separado.
Margen | Renderiza como |
---|---|
| Lenguaje de marcado de hipertexto Lenguaje de marcado de hipertexto |
Wikimarkup: separe los párrafos con una sola línea en blanco.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertextoLenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto Lenguaje de marcado de hipertexto |
...
es especialmente útil en listas, para elementos de lista con varios párrafos:
Margen | Renderiza como |
---|---|
|
|
Tenga en cuenta que la etiqueta de cierre
br
o
inserta un salto de línea. Ambas versiones de la pausa son compatibles con HTML5. El uso
sin resaltar la sintaxis de los /
saltos , por lo que debe evitarse. no es válido.
Margen | Renderiza como |
---|---|
Hipertexto |
|
Plantillas:
{{break}}
agrega múltiples saltos de línea.{{crlf2}}
agrega un verdadero retorno de carro y salto de línea.{{clear}}
agrega una ruptura con el estilo para borrar los elementos flotantes.{{plainlist}}
crea una lista sin viñetas.
hora
o
representa un salto temático a nivel de párrafo y se presenta como una regla horizontal.
Margen | Renderiza como |
---|---|
Wikimarkup: usar ----
Margen | Renderiza como |
---|---|
---- |
|
Plantillas: {{hr}}
Comentarios
formatea el texto adjunto como un comentario oculto.
Margen | Renderiza como |
---|---|
Hipertexto | Hipertexto |
Tenga cuidado con espaciar los comentarios. Rodear un comentario con líneas en blanco resultará en un párrafo en blanco, percibido como dos líneas en blanco adicionales:
Margen | Renderiza como |
---|---|
Línea de contenido 1Línea de contenido 2 | Línea de contenido 1
|
Formateo
abbr
...
crea una información sobre herramientas para definir una abreviatura o un acrónimo que se muestra al pasar el mouse.
Margen | Renderiza como |
---|---|
HTML | HTML |
Plantillas: {{abbr}}
B
...
formatea el texto con un desfase estilístico de otro texto (negrita) sin transmitir una importancia adicional.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Wikimarkup: Úselo '''
para abrir y cerrar texto en negrita.
Margen | Renderiza como |
---|---|
'''Lenguaje de marcado de hipertexto''' | Lenguaje de marcado de hipertexto |
bdi
...
aísla el contenido de la configuración de dirección del texto circundante.
Margen | Renderiza como |
---|---|
اليمين إلى اليسار de izquierda a derecha | اليمين إلى اليسار de izquierda a derecha |
اليمين إلى اليسار de izquierda a derecha | اليمين إلى اليسارde izquierda a derecha |
Soporte: Firefox, Chrome
bdo
...
especifica la dirección del texto.
Atributos y valores:
dir
- Especifica la dirección del texto.ltr
rtl
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
blockquote
presenta texto en un bloque de desplazamiento. ...
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto |
|
Plantillas :; admite parámetros de fuente y atribución formateados previamente. Para otras plantillas de cotización especializadas, consulte Categoría: Plantillas de cotización .{{quote}}
citar
...
contiene el título de una obra. Esta es una nueva definición en HTML5; en la implementación XML anterior se usó para contener una cita o una referencia a otras fuentes. No se aplica ningún formato cuando se utiliza esta etiqueta.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
...
generalmente no se usa directamente en los artículos de Wikipedia y, a menudo, se usa indebidamente; consulte Wikipedia: HTML 5 # cite para obtener instrucciones de reemplazo.
código
formatea una sección de código de computadora. Diseñado con CSS a través de ...
mediawiki.skinning/elements.less
un tipo de letra monoespaciado con un fondo y un borde grises.
Margen | Renderiza como |
---|---|
|
|
Plantillas: usos . Consulte la sección "Consulte también" en la página de la plantilla para obtener más plantillas de marcado de código.{{code}}
<syntaxhighlight>
Consulte § samp y § kbd en esta página para el marcado semántico de salida y entrada, respectivamente.
datos
...
formatea una versión de contenido legible por máquina.
Margen | Renderiza como |
---|---|
HTML para principiantes | HTML para tontos |
Atributos: value
del
formatea el texto eliminado. ...
Margen | Renderiza como |
---|---|
|
|
dfn
...
se utiliza para indicar la instancia definitoria de un término.
Margen | Renderiza como |
---|---|
Definición | Definición |
Plantillas: {{dfn}}
em
...
representa un espacio de texto con énfasis enfático (es decir, énfasis semántico). En la mayoría de los navegadores, se muestra en cursiva.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Plantillas: {{em}}
I
...
representa un espacio de texto desplazado 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.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Wikimarkup: Úselo ''
para abrir y cerrar texto en cursiva.
Margen | Renderiza como |
---|---|
''Lenguaje de marcado de hipertexto'' | Lenguaje de marcado de hipertexto |
En s
...
indica un rango de texto que se ha agregado. Diseñado como texto subrayado. Se usa en páginas de discusión para indicar texto refactorizado; ver WP: REDACT .
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
kbd
...
indica la entrada del usuario, como la entrada del teclado o los comandos de voz.
Margen | Renderiza como |
---|---|
Presione Enter | prensa Enter |
Plantillas:
{{kbd}}
aplica un estilo de espacio único y un fondo gris claro para distinguirlo del código () y la salida (
o ).
{{samp}}
{{key press}}
renderiza teclas y pulsaciones de teclas ilustradas.
Marcos
...
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 se formatea con un fondo amarillo de forma predeterminada.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Soporte: no es compatible con Internet Explorer 8 y versiones anteriores.
pre
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>
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Entidades HTML
analiza entidades HTML . Si desea evitar esto, reemplácelo
&
con &
o utilice en su lugar.<source lang="text">
Margen | Renderiza como |
---|---|
& amp; | Y |
& lt; | < |
& amp; amp; | &erio |
& amp; lt; | & lt; |
Plantillas:
{{pre}}
envuelve el texto que desborda la página.{{pre2}}
envuelve o usa scrollbox.
q
se utiliza para marcar una cita breve. Hasta ahora, ha habido muy poca implementación de este elemento en Wikipedia....
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto |
|
MOS: QUOTATIONS dice que Wikipedia debería usar "", {{ quote }} o
.
rp, rt, rubí
...
marca tramos de contenido de fraseo con anotaciones ruby.
marca el componente de texto ruby de una anotación ruby; el texto rubí se muestra en un tamaño reducido por encima de los caracteres normales.
se utiliza para proporcionar paréntesis alrededor de un componente de texto ruby de una anotación ruby, para que lo muestren los agentes de usuario que no admiten 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.
Margen | Renderiza como |
---|---|
| 東 京 |
Plantillas:
{{ruby}}
{{ruby-ja}}
para japoneses{{Ruby-zh-p}}
para pinyin chino{{Ruby-zh-b}}
para el bopomofo chino
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 espacio de texto como eliminado de un documento, utilice ...
.
Margen | Renderiza como |
---|---|
|
|
Plantillas: {{strikethrough}}
sémola gruesa de maíz
...
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 muestras de ellos, como rutas y nombres de archivos.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Plantillas: aplica un estilo de espacio único y le da al texto en gris oscuro para distinguirlo del código ( ) y la entrada ( o ).{{samp}}
{{kbd}}
pequeña
...
formato de texto pequeño.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Plantillas:
{{small}}
utiliza. Se recomienda más ya que tiene un significado semántico que es para letra pequeña , mientras que es puramente estilístico.
{{small}}
...
{{small}}
fuerte
...
formatea un espacio 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 otros en negrita. La mayor parte del énfasis semántico, incluso en el material citado, se debe representar con el elemento.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Plantillas: {{strong}}
sub
...
da formato a un tramo de texto como subíndice.
Margen | Renderiza como |
---|---|
Hipertexto Lenguaje de marcado | Lenguaje de marcado de hipertexto |
Plantillas:
{{sub}}
( texto de subíndice ){{subsub}}
( texto subíndice subíndice ){{ssub}}
( subíndice, texto pequeño ){{sup}}
( texto en superíndice ){{su}}
(subíndice superíndice
texto){{sup sub}}
(textosup
sub){{e}}
(1,23 × 10 4 )
sorber
...
da formato a un tramo de texto como superíndice.
Margen | Renderiza como |
---|---|
Hipertexto Lenguaje de marcado | Lenguaje de marcado de hipertexto |
Plantillas:
{{sub}}
( texto de subíndice ){{subsub}}
( texto subíndice subíndice ){{ssub}}
( subíndice, texto pequeño ){{sup}}
( texto en superíndice ){{su}}
(subíndice superíndice
texto){{sup sub}}
(textosup
sub){{e}}
(1,23 × 10 4 )
hora
define una hora (reloj de 24 horas) o una fecha en el calendario gregoriano, opcionalmente con una hora y una diferencia horaria.
Margen | Renderiza como |
---|---|
| |
Atributos: datetime
Soporte: no es compatible con Internet Explorer 8 y versiones anteriores.
tu
...
representa un espacio de texto desplazado de su contenido circundante sin transmitir ningún énfasis o importancia adicional, y para el cual la presentación tipográfica convencional está subrayada; por ejemplo, un segmento de texto en chino que es un nombre propio (una marca de nombre propio chino) o un segmento de texto que se sabe que está mal escrito.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Plantillas: {{underline}}
var
...
da formato al 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.
Margen | Renderiza como |
---|---|
* E = m c 2 (c es una constante, no una variable)* |
|
Plantillas:
{{var}}
{{varserif}}
formateado en cursiva serif para diferenciar caracteres
wbr
es una oportunidad para romper las 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.
Margen | Renderiza como |
---|---|
Ahora es el momento de convertirse en un editor avanzado, aprendiendo el lenguaje de marcado de hipertexto | Ahora es el momento de convertirse en un editor avanzado, aprendiendo el lenguaje de marcado de hipertexto |
Ahora es el momento de convertirse en un editor avanzado, aprendiendo Hyper | Ahora es el momento de convertirse en un editor avanzado, aprendiendo Hyper |
A medida que la ventana del navegador se ajusta 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 haya 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
, ...
y
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 están sangradas. Cada término debe incluir una o más descripciones.
Margen | Renderiza como |
---|---|
|
|
Wikimarkup: se crea usando
;
mientras se adjunta automáticamente
. ...
se crea usando
:
para cada valor. Para un valor único o el primer valor, :
se puede colocar en la misma línea después de ;
donde los valores posteriores deben colocarse en líneas separadas.
Margen | Renderiza como |
---|---|
; Término: Definición 1: Definición 2 |
|
Plantillas: {{defn}}
ol, ul, li
representa una lista ordenada; ...
representa una lista desordenada; ...
representa un elemento de lista dentro de cualquier tipo de lista.
Margen | Renderiza como |
---|---|
|
|
|
|
Wikimarkup: utilícelo *
para elementos en una lista desordenada y #
para listas ordenadas.
Margen | Renderiza como |
---|---|
|
|
|
|
Plantillas: para una variedad de usos especializados, consulte Categoría: Plantillas de función y formato de lista .
Contenedores
div
es un contenedor genérico para contenido de flujo que se muestra como un elemento de bloque.
Margen | Renderiza como |
---|---|
Lenguaje de | Hipertexto Margen Idioma |
lapso
...
es un contenedor de contenido de flujo que se muestra como un elemento en línea.
Margen | Renderiza como |
---|---|
Lenguaje de marcado de hipertexto | Lenguaje de marcado de hipertexto |
Mesas
mesa, td, tr
define una tabla. ...
define una fila de la tabla....
define una celda de datos con contenidos que pueden incluir texto, enlaces, imágenes, listas, formularios, otras tablas, etc....
Margen | Renderiza como | ||
---|---|---|---|
|
| ||
Atributos:
:- Permitido pero no recomendado:
border=""
yborder="1"
- Permitido pero obsoleto:
border
(con un valor diferente no vacío de "1"),align
,bgcolor
,cellpadding
,cellspacing
,frame
,rules
,summary
,width
[3]
- Permitido pero no recomendado:
:colspan
,headers
,rowspan
- Permitido pero obsoleta:
abbr
,align
,axis
,bgcolor
,scope
,height
,nowrap
,valign
,width
[3]
- Permitido pero obsoleta:
th
define un encabezado de tabla; diseñado como centrado y en negrita....
Margen | Renderiza como | ||||
---|---|---|---|---|---|
|
| ||||
Atributos:
:colspan
,headers
,rowspan
,scope
- Permitido pero obsoleta:
abbr
,align
,axis
,bgcolor
,height
,nowrap
,valign
,width
[3]
- Permitido pero obsoleta:
agrega un título a una tabla.
Margen | Renderiza como | ||
---|---|---|---|
|
| ||
Atributos:
:- Permitido pero obsoleto:
align
[3]
- Permitido pero obsoleto:
thead, tfoot, tbody
,
y
no son compatibles, pero se generan automáticamente cuando se representa la página.
Elementos obsoletos / obsoletos
Estos elementos ahora son obsoletos y obsoletos o eliminados en HTML5, pero aún son compatibles con los navegadores. [3] 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 las partes HTML obsoletas y sus reemplazos.
centrar
se utiliza para centrar elementos de texto.
(obsoleto)
Plantillas: usa CSS.{{center}}
fuente
se utiliza para establecer el tamaño de fuente, el tipo de fuente y el color del texto. ...
(obsoleto)
Plantillas: usa CSS.{{font}}
rb
Se usa para marcar el texto base en una anotación ruby
(obsoleto)
Para reemplazos, consulte: Ayuda: HTML en wikitexto # rp, rt, ruby
Huelga
formatos de caracteres tachados; utilizar
(obsoleto)...
en su lugar.
tt
da formato al texto en una fuente de ancho fijo. Utilice ...
(obsoleto),
o en su
lugar.
Plantillas: usa CSS.{{mono}}
Elementos no admitidos
Estos elementos no son compatibles, pero tienen un marcado wiki equivalente. Si intenta utilizar cualquier elemento que no esté en la lista blanca Sanitizer.php
, el marcado se mostrará como texto sin formato.
a
se utiliza para crear enlaces. Utilice
[[ ]]
wikimarkup para enlaces internos / intrawiki y enlaces interwiki , y [ ]
para enlaces externos.
aporte
se utiliza para crear formularios . La etiqueta de extensión se usa para crear un cuadro de texto con un botón.
<inputbox>
HTML ordenado
HTML Tidy es una biblioteca HTML4 obsoleta que está programada para su eliminación . Tidy analiza la salida de MediaWiki y la limpia para aumentar la probabilidad de que se procese HTML4 válido. Por ejemplo, con Tidy habilitado,
, ,
,
todo representa como
. Tidy no está habilitado para las páginas de la interfaz de 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 las etiquetas de los botones, el HTML no se analiza y las etiquetas se exponen.
Las páginas de CSS y JavaScript de usuario y de todo el sitio se interpretan como si estuvieran dentro de un bloque. Ver Ayuda: Estilo de usuario .
Validación
El software MediaWiki intenta corregir los errores HTML, pero no los detecta todos. Cuando se usa HTML, es útil verificarlo con el Servicio de validación de marcado del W3C .
Etiquetas de analizador y extensión
Para obtener una lista generada por máquina, consulte Special: Version # mw-version-parser-extensiontags . Puede incluir etiquetas no documentadas aquí.
- Etiquetas de analizador
<gallery>
, , , , ,<includeonly>
<noinclude>
<nowiki>
<onlyinclude>
<pre>
- Etiquetas de extensión
<categorytree>
, , (Alias ), , , , , , , , , , , , , , , (alias ), , ,<charinsert>
<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
- Ayuda: marcado Wiki
- Wikipedia: HTML5
Referencias
- ^ a b Los elementos y atributos permitidos se definen en el
Sanitizer.php
módulo. - ^ "El modelo de microdatos" . Estándar de vida HTML .
- ^ a b c d e "HTML5: un vocabulario y API asociadas para HTML y XHTML: características obsoletas" . W3C . 31 de julio de 2014.