wiki

BBCode

BBCode es un lenguaje de marcado que se usa en los foros de osu! y, en mayor medida, la gran mayoría de foros en internet. Se usa para habilitar el formato de texto enriquecido, se compone de etiquetas que rodean el texto para indicar formato, atributos, incrustaciones y más. Se usa en varios lugares del sitio web de osu!, como publicaciones en foros, firmas, páginas de usuario y descripciones de beatmaps.

El editor de publicaciones del foro con sus botonesEl cuadro de edición en los foros

Comportamiento

Al hacer clic en un botón de marcado sin resaltar ningún texto, se creará un conjunto de etiquetas abiertas y cerradas alrededor del cursor de texto en el editor de publicaciones. Resaltar el texto antes de hacer clic en un botón de marcado rodeará dicho texto con las etiquetas.

Los usuarios que deseen combinar el formato en una sola sección de texto, pueden hacerlo colocando etiquetas de BBCode una dentro de otra. Sin embargo, el orden y el anidamiento de estas etiquetas debe respetarse al combinar. Si no se hace, se romperá el formato.

A continuación se describe un conjunto de usos correctos e incorrectos de las etiquetas anidadas:

  • [centre][b]texto[/b][/centre] es correcto
  • [b][centre]texto[/b][/centre] es incorrecto

Alineación

Las etiquetas de alineación se usan para controlar la posición horizontal del texto y los elementos de BBCode. Si se coloca dentro de una etiqueta [quote] o alrededor de ella, el texto del bloque de cita se alineará según la etiqueta de alineación, pero la línea vertical del bloque de cita seguirá estando a la izquierda.

Izquierda

[left]texto[/left]

La etiqueta [left] se usa para alinear el contenido a la izquierda. De forma predeterminada, todo el contenido está alineado a la izquierda.

Centro

[centre]texto[/centre]

La etiqueta [centre] se usa para alinear el texto al centro de una caja. Esto se usa con mayor frecuencia para efectos estilísticos en títulos, encabezados o poemas.

Derecha

[right]texto[/right]

La etiqueta [right] se usa para alinear el contenido a la derecha.

Etiquetas

BBCode, como muchos otros lenguajes de marcado, formatea el texto mediante un sistema de etiquetas, que se indica mediante un par de corchetes ([]). Estas etiquetas se dividen en etiquetas de «apertura» y «cierre», que se diferencian mediante la inclusión de una barra diagonal (/). Específicamente, las etiquetas de cierre contienen una barra inclinada justo después del corchete de apertura, mientras que las etiquetas de apertura no.

También es importante tener en cuenta que las etiquetas abiertas ocasionalmente incluyen signos de igual (=) dentro para indicar direcciones URL, tamaños de fuente y otros elementos similares.

Las etiquetas de BBCode, que son compatibles con el sitio web de osu!, se enumeran y describen en detalle a continuación.

Negrita

[b]texto[/b]

La etiqueta [b] se usa para enfatizar mucho el texto mediante el uso de negrita. La negrita de BBCode no afecta el tamaño de la fuente.

Botón de la barra de herramientas: Botón de negrita

Cursiva

[i]texto[/i]

La etiqueta [i] se usa para enfatizar ligeramente el texto inclinando el texto hacia adelante (es decir, en cursiva).

Botón de la barra de herramientas: Botón de cursiva

Subrayado

[u]texto[/u]

La etiqueta [u] se usa para enfatizar el texto dibujando una línea horizontal debajo de dicho texto (es decir, subrayado). La línea horizontal que se dibuja se verá afectada por otras etiquetas como negrita y cursiva.

Tachado

[s]texto[/s]

La etiqueta [s] se usa para indicar la eliminación de texto incluido anteriormente mediante el uso de una línea horizontal que «tacha» el texto (es decir, un «tachado»). [strike] es un alias aceptado para esta etiqueta.

Botón de la barra de herramientas: Botón de tachar

Color

[color=#CÓDIGOHEX]texto[/color]

Nota: Para obtener una lista de todos los nombres de colores, véase X11 color names

La etiqueta [color] se usa para estilizar el texto a través de varios tipos de colores seguros para la web. La etiqueta usa el formato del código HEX para especificar el color, aunque también se puede especificar a través de nombres de color HTML como «red» o «green». Para especificar, reemplace el argumento #CÓDIGOHEX con el código HEX o nombre HTML correspondiente de un color.

El argumento mencionado anteriormente no lleva comillas (") y no tiene un color predeterminado. Si no se especifica ningún argumento, o si se usan comillas, la etiqueta no se analizará como una etiqueta de BBCode.

Tamaño de fuente

[size=NÚMERO]texto[/size]

La etiqueta [size] se usa para ajustar la apariencia del texto modificando el tamaño de la fuente.

El argumento NÚMERO especifica un porcentaje relativo al tamaño de fuente predeterminado (100 %). Por ejemplo, 50 reduce el texto a la mitad del tamaño predeterminado, mientras que 150 lo aumenta al doble y medio del tamaño predeterminado. El argumento no requiere comillas y acepta dos tipos de valores:

  • Números enteros (no se permiten decimales) del 30 al 200
  • Palabras clave de tamaño predefinidas: «tiny», «small», «normal» y «large», que corresponden a 50, 85, 100 y 150 respectivamente.

Si se proporciona un valor no válido, la etiqueta no funcionará correctamente.

Hay un botón en la barra de herramientas para acceder rápidamente a estos cuatro tamaños comunes.

Botón de la barra de herramientas: Opciones de tamaño de fuente

Spoiler

Nota: No debe confundirse con Caja de spoiler.

[spoiler]texto[/spoiler]

La etiqueta [spoiler] se usa para ocultar información confidencial con un primer plano negro sólido que revela el texto debajo al resaltarlo. Si se apila con la etiqueta [color], la cubierta negra no se verá afectada. Sin embargo, el texto debajo de la cubierta negra seguirá estando coloreado, sea legible o no.

La etiqueta se usa más comúnmente para evitar estropear información crítica/sensible sobre un programa de televisión, una película u otros medios. A veces también se usa para efectos cómicos o énfasis.

Caja

Nota: No debe confundirse con Caja de spoiler.

[box=NOMBRE]
texto
[/box]

La etiqueta [box] se usa para ocultar texto e imágenes dentro de un hipervínculo en el que se puede hacer clic. Al hacer clic, el contenido del interior se revelará de manera similar a un menú desplegable.

El texto del hipervínculo personalizado se indica mediante el argumento NOMBRE. Especificar este argumento creará un texto de encabezado dentro de la caja usando ese argumento y ajustará el tamaño de la caja en consecuencia. Si NOMBRE se deja sin especificar, la etiqueta [box] creará una caja sin texto de encabezado dentro. El argumento no usa comillas ("), y generará espacios en blanco.

La etiqueta se usa más comúnmente para ocultar grandes paredes de texto e imágenes que pueden aumentar el tamaño de una publicación en el foro. Más notablemente en las publicaciones de preguntas frecuentes o de skins.

Aviso
el botón de la barra de herramientas de la caja se llama «Caja de spoiler», pero no crea una etiqueta [spoilerbox].

Botón de la barra de herramientas: Botón de caja

Caja de spoiler

[spoilerbox]texto[/spoilerbox]

Una caja de spoiler es un tipo especial de caja de BBCode que no tiene un argumento NOMBRE especificable. El nombre de una caja de spoiler siempre se muestra como SPOILER. Las cajas de spoiler tienen su propia etiqueta ([spoilerbox]) pero son funcionalmente idénticas a las cajas.

Cita

[quote="NOMBRE"]
texto
[/quote]

La etiqueta [quote] se usa para dar formato estilístico a citas largas (también conocidas como «citas en bloque») mediante el uso de sangría, color, negrita y separación del texto a través de una línea vertical rosa. El contenido real de la cita se coloca entre las etiquetas abiertas y cerradas, mientras que el argumento NOMBRE especifica el autor de la cita (aunque esto es opcional). El texto dentro de las comillas generará espacios en blanco y saltos de línea.

Aviso
el argumento NOMBRE debe estar entre comillas (").

Las citas largas generalmente se usan en los escritos más formales en lugar de citas en línea cuando dicha cita tiene tres o más líneas. Sin embargo, dentro de los foros de osu!, se usan más comúnmente para responder al comentario de otro usuario, lo que se puede hacer automáticamente a través del botón Citar y responder ubicado en la parte superior derecha del comentario deseado (que se muestra a continuación). Sin embargo, este botón solo aparecerá si el cursor está cerca.

Botón de citar y responder: Botón de citar y responder

Código en línea

Nota: No debe confundirse con Bloque de código.

[c]texto[/c]

La etiqueta [c] permite resaltar texto en línea en una fuente monoespaciada. En el sitio web de osu!, el texto se formateará con un cuadro gris a su alrededor. A diferencia de los bloques de código, la etiqueta solo se puede colocar en líneas individuales.

Dentro de los foros de osu!, esto es útil para enfatizar, por ejemplo, atajos de teclado o descripciones de botones.

Bloque de código

Nota: No debe confundirse con Código en línea.

[code]
texto
[/code]

La etiqueta [code] se usa para crear bloques de código preformateados (también conocido como texto preformateado). En el sitio web de osu!, la etiqueta [code] formateará el texto en una fuente monoespaciada dentro de un cuadro gris semitransparente. Dar formato al texto dentro de un bloque de código le indicará al editor que trate el texto entre esas etiquetas literalmente, evitando así la conversión de cualquier etiqueta o código fuente en otra cosa.

Dentro de los foros de osu!, los bloques de código se usan con mayor frecuencia para publicar el código fuente de un storyboard, o en tutoriales que requieren mostrar la sintaxis de las etiquetas, los comandos o el código fuente.

URL

[url=ENLACE]texto[/url]

La etiqueta [url] se usa para convertir texto regular en hipervínculos en los que se puede hacer clic.

Aviso
El uso de esta etiqueta no es necesario si no se desea usar texto con un hipervínculo personalizado, ya que el editor del foro analiza las URL adecuadas sin la etiqueta [url] en enlaces automáticamente.

Para crear hipervínculos con la etiqueta [url], los usuarios deben especificar dos argumentos: la URL específica del sitio web al que se dirigirá el enlace y el texto vinculado que se mostrará. El primero debe especificarse como el argumento ENLACE (sin comillas "), y el último debe especificarse entre las etiquetas de apertura y cierre. Si no se especifica ningún texto, la etiqueta no funcionará correctamente.

También son compatibles los enlaces con [url]ENLACE[/url], pero en la mayoría de los casos son redundantes, ya que las URL simples se analizan automáticamente.

Aviso
Todas las URL, ya sea que se usen con la etiqueta [url] o como texto sin formato, deben ser válidas e incluir un protocolo (http://, https://, ftp://) o el prefijo www.. De lo contrario, el enlace no funcionará.

Botón de la barra de herramientas: Botón de enlace

Perfil

[profile=iddeusuario]nombre de usuario[/profile]

La etiqueta [profile] se usa para enlazar la página de perfil de osu! de un usuario usando su nombre de usuario o ID de usuario. A diferencia de los enlaces estándar de las URL, al pasar el cursor por encima de esta etiqueta se mostrará una tarjeta de usuario interactiva.

Para crear un enlace de perfil, los usuarios deben especificar dos argumentos: el ID numérico del usuario y su nombre de usuario. El primero se especifica como el argumento iddeusuario (sin comillas), mientras que el segundo se coloca entre las etiquetas de apertura y cierre.

Para obtener mejores resultados, incluye tanto el ID del usuario correcto como su nombre de usuario correspondiente. Esto garantiza que el enlace funcione correctamente y se mantenga funcional incluso si el nombre de usuario cambia posteriormente. Si se especifica a los usuarios solo por su nombre de usuario, el enlace dejará de funcionar una vez que lo cambien.

Cuando la etiqueta se usa en foros, firmas o descripciones de beatmaps, el sitio web osu! puede corregir y actualizar automáticamente la etiqueta [profile] si el username no es válido o el iddeusuario no es válido o no está presente. Esto permite insertar rápidamente enlaces de perfil si se conoce el ID de usuario o el nombre de usuario, sin necesidad de consultar ambos datos.

Aviso
El ID de usuario es una cadena de números que siguen directamente a /users/ en la URL de una página de perfil de osu!.

Listas formateadas

[list] NOMBRE_DE_LA_LISTA
[*]ítem 1
[*]ítem 2
[*]ítem 3
[/list]

o

[list=TIPO] NOMBRE_DE_LA_LISTA
[*]ítem 1
[*]ítem 2
[*]ítem 3
[/list]

La etiqueta [list] se usa para formatear automáticamente dos tipos diferentes de listas en todos los foros de el osu!. Cada elemento de la lista está marcado con [*]. De forma predeterminada, esto creará una lista simple con viñetas.

Si se especifica el argumento TIPO (el valor real no importa), creará una lista numerada.

El argumento opcional NOMBRE_DE_LA_LISTA añade un encabezado con sangría sobre la lista. Si se omite, no se mostrará ningún encabezado.

Aviso
Las listas de BBCode se pueden anidar o apilar, aunque esto a veces puede causar problemas de formato.

Botón de la barra de herramientas: Botón de lista Botón de lista numerada

Correo electrónico

[email=DIRECCIÓN]texto[/email]

La etiqueta [email] crea enlaces de correo electrónico clicables con texto personalizado. Al hacer clic, se abre el cliente de correo predeterminado del usuario con la dirección del destinatario predefinida.

Para crear enlaces de correo electrónico con la etiqueta [email], los usuarios deben especificar dos argumentos: la dirección de correo electrónico que se debe completar y el texto del enlace que se mostrará. El primero debe especificarse como el argumento DIRECCIÓN (sin comillas), mientras que el segundo debe especificarse entre las etiquetas de apertura y cierre. Si no se proporciona texto para mostrar, el hipervínculo no se mostrará correctamente.

También es compatible con [email]DIRECCIÓN[/email], pero en la mayoría de los casos es redundante, ya que los correos electrónicos sin formato se analizan automáticamente.

Imágenes

[img]DIRECCIÓN[/img]

La etiqueta [img] se usa para incluir imágenes en línea en las publicaciones de foro de osu!. Para usar la etiqueta, los usuarios deben pegar la dirección de la imagen directa (representada por el argumento DIRECCIÓN anterior) procedente de un sitio web. Las rutas de archivos locales (por ejemplo, C:\Users\Name\Pictures\image.jpg) no funcionarán.

Aviso
la URL de un sitio web no es lo mismo que la dirección de una imagen.

Para obtener una dirección de imagen, uno debe navegar al sitio web en el que se encuentra, pasar el ratón sobre la imagen, hacer clic con el botón derecho en la imagen y seleccionar Copiar dirección de la imagen. Luego, la dirección debe copiarse y pegarse entre las etiquetas.

Aunque las imágenes se pueden obtener desde cualquier lugar, osu! recomienda que los usuarios carguen imágenes en sitios de intercambio de imágenes acreditados como ImgBB, ya que algunos sitios web no aprecian los enlaces directos a sus imágenes (también conocidos como «hotlinks»).

Aviso: Imgur ha bloqueado las IP del sitio web de osu!, por lo que las nuevas imágenes alojadas allí ya no se pueden mostrar.1

Botón de la barra de herramientas: Botón de imagen

Mapa de imágenes

[imagemap]
URL_DE_LA_IMAGEN
X Y ANCHO ALTURA REDIRECCIÓN TÍTULO
[/imagemap]

La etiqueta [imagemap] se usa para integrar uno o más hipervínculos en una imagen en áreas rectangulares.

La imagen, que está incrustada en el sitio web, está representada por el argumento URL_DE_LA_IMAGEN. Debe referirse directamente a una imagen alojada en un sitio web.

Para agregar un área en la que se puede hacer clic, se debe insertar una nueva línea que contenga la posición x e y del área, el ancho y el alto del área, así como un enlace para redirigir después del argumento URL_DE_LA_IMAGEN. Además, se mostrará un argumento TÍTULO opcional al pasar el cursor por el área si se especifica. Un enlace se puede especificar con el argumento REDIRECCIÓN u omitirse con #. Cada unidad de tamaño (X, Y, ANCHO y ALTURA) es un porcentaje (0–100) sin el signo de porcentaje.

Botón de la barra de herramientas: Botón de mapa de imagen

YouTube

[youtube]ID_DEL_VÍDEO[/youtube]

La etiqueta [youtube] se usa para incrustar un vídeo de YouTube en el sitio web. La etiqueta requiere que el usuario ingrese solo el ID del vídeo (no la URL completa) entre las dos etiquetas (representadas por el argumento ID_DEL_VÍDEO anterior).

El ID de un vídeo de YouTube se encuentra en la URL del vídeo y es la cadena de 11 caracteres directamente después de v=.

Audio

[audio]URL[/audio]

La etiqueta [audio] se usa para incrustar un reproductor de audio HTML5 desde una fuente de audio en línea. Los archivos de audio se pueden obtener desde cualquier lugar, siempre que el archivo exista desde una URL determinada. Las rutas de archivos locales (por ejemplo, C:\Users\Name\Music\audio.mp3) no funcionarán.

Precaución
tenga en cuenta que no todos los servicios de intercambio de archivos aprecian la copia de sus archivos de audio debido a las preocupaciones sobre la piratería de música. osu! no es responsable de ningún problema de derechos de autor que los usuarios puedan encontrar en ese sentido.

Para incrustar archivos de audio a través de este método, los usuarios deben pegar su URL de origen (por ejemplo, https://www.example.com/example.mp3) entre las dos etiquetas [audio].

Encabezado (v1)

[heading]texto[/heading]

La etiqueta [heading] se usa para dar formato al texto en grandes encabezados de color rosa. La etiqueta no admite encabezados de varios niveles y no se puede vincular específicamente.

Botón de la barra de herramientas: Botón de encabezado

Anuncio

[notice]
texto
[/notice]

La etiqueta [notice] se usa para colocar párrafos en un cuadro grande y delineado con un cuerpo de color oscuro. El botón se usa principalmente para indicar anuncios o advertencias sobre un determinado tema en el sitio web.

Antiguas

Las siguientes son etiquetas de BBCode que alguna vez se usaron en varios lugares del sitio web de osu!, pero ahora no están disponibles para su uso. Sus usos y sintaxis se describen a continuación con fines históricos.

Google

[google]consulta de búsqueda[/google]

La etiqueta [google] es una etiqueta obsoleta que alguna vez se usó en los foros de osu! para vincular a una consulta de búsqueda de Google usando el texto proporcionado entre las dos etiquetas.

La etiqueta redirigiría a los usuarios a una búsqueda de Google a través de su cuenta, lo que significa que no se darían exactamente los mismos resultados a todos, ya que Google personaliza los resultados de los usuarios. Asimismo, esto también significa que algunos resultados de búsqueda estarían ocultos para ciertos usuarios debido a restricciones de idioma o país.

Suerte

[lucky]consulta de búsqueda[/lucky]

La etiqueta [lucky] es una etiqueta obsoleta que alguna vez se usó en los foros de osu! para vincular a un sitio web dirigido desde el botón Voy a tener suerte de Google usando el texto proporcionado. El sitio web vinculado a través de esta etiqueta no sería el mismo para todos debido a la naturaleza del botón en sí.

Encabezado (v2)

[texto]

La etiqueta encabezado (v2) es una etiqueta desactualizada que alguna vez se usó en los foros de osu! para dar formato al texto en un encabezado púrpura de apariencia más elegante con una línea horizontal. La etiqueta solo funcionó en el foro Beatmaps, y solo aparecia después de la publicación (no en la vista previa). No tenía botón cuando estaba en servicio y se indicaba con un corchete abierto y cerrado (sin etiquetas de apertura y cierre).

Herramientas

Estos proyectos simplifican el proceso de formatear texto con BBCode:

Nombre Responsable del proyecto Descripción
OSUWME rezzvy Editor de BBCode con vista previa en tiempo real para el perfil de osu!
osu! BBCode Editor HonokaKousakaTV Editor de BBCode con vista previa en tiempo real para el perfil de osu! (Archivado)
osu-gradient [____________] Crea degradados de color para el perfil de osu!
osu-web enhanced RockRoller Extensión del navegador que añade más botones de BBCode y otras funciones al sitio web de osu!
textcolorizer david Coloración de texto para BBCode y HTML

Curiosidades

  • Este artículo de la wiki originalmente fue adaptado del hilo del foro «HOW TO: Forum BBCodes» por Stefan.
  • Solía haber un error que permitía a los usuarios hacer que el texto fuera transparente usando la etiqueta de color y escribiendo «transparent» después del signo igual (=).
    • A partir de ahora, el texto volverá al color predeterminado (blanco) cuando esto suceda.
  • Antes de que se agregara la etiqueta imagemap, era posible agregar un hipervínculo a una imagen combinando las etiquetas url e img; sin embargo, solo se puede establecer un hipervínculo por imagen. Esto requeriría cortar la imagen original en varias piezas (es decir, una imagen parcial para cada enlace) y colocarlas horizontalmente una al lado de la otra.

Referencias