Un callout es un bloque resaltado diseñado para llamar la atención sobre información importante dentro de un artículo. Las señales destacan visualmente respecto al contenido circundante, haciéndolas inmediatamente visibles para los lectores.
Document360 ofrece cuatro tipos de llamadas integradas — Info, Warning, Error y Success — cada una con un color y propósito definidos.
Cuándo usar callout
- Usa Info para proporcionar contexto adicional que sea útil pero no crítico, o para compartir un consejo o atajo que facilite la tarea
- Usa Advertencia antes de un paso que sea irreversible — por ejemplo, eliminar datos, sobrescribir una configuración o hacer un cambio que afecte a otros usuarios
- Utiliza Error para documentar un estado de error conocido, explicar qué significa un código de error específico o marcar acciones que causarán un fallo si se realizan incorrectamente
- Utiliza Success para confirmar que un paso se ha completado correctamente o para resaltar una configuración recomendada que los lectores deben seguir
Inserta una señal
En el editor avanzado WYSIWYG:
- Coloca el cursor donde quieres insertar la señal.
- Escribe el comando
/calloutde barra y pulsa Enter. - Selecciona el tipo de llamada en el submenú: Info, Warning, Error o Exit.
- Haz clic en el campo del título e introduce el título de tu llamada.
- Haz clic en el campo de contenido e introduce el texto principal de tu llamada.
Tipos de callout
| Tipo | Color predeterminado | Propósito |
|---|---|---|
| Información | Azul | Proporciona contexto adicional, consejos útiles o información complementaria. |
| Advertencia | Amarillo | Alerta a los lectores sobre posibles problemas, consideraciones importantes o acciones que puedan tener consecuencias no deseadas. |
| Error | Rojo | Resalta errores conocidos, estados de fallo o acciones que deben evitarse. |
| Éxito | Verde | Confirma un paso completado, un resultado positivo o un enfoque recomendado. |
Cada callout tiene un campo de título y otro de contenido . Ambos se pueden editar directamente en el editor.
Editar color de señal
Los colores de callout por defecto pueden cambiarse para que coincidan con tu marca. Los cambios de color se aplican a toda la base de conocimiento, no a las llamadas individuales.
Para personalizar los colores de llamada:
- Navega a Configuración en la barra de navegación izquierda del portal de la Base de conocimientos.
- Ve a la base de conocimientos > Personalización del sitio > CSS y JavaScript personalizados.
- Haz clic en la pestaña CSS y luego haz clic en Añadir fragmentos de código.
- Selecciona Cambiar colores de referencia desde el panel. Esto te lleva a la sección donde se definen los colores de señalamiento existentes.
- Edita los valores de color en el código para aplicar los colores de tu marca.
- Haz clic en Guardar.
- Los cambios de color realizados aquí se aplican a todas las llamadas de ese tipo en toda la base de conocimiento.
- También puedes estilizar los colores de referencia en modo oscuro. Para más información, consulta el artículo sobre Cómo cambiar el color de las señales en modo oscuro. (#)
Mejores prácticas
- Ajusta el tipo de llamada a la naturaleza del mensaje: usa Info para contexto, Warning para riesgo, Error para fallos y Success para confirmación. Usar mal los tipos de callout (por ejemplo, usar Error como propina) reduce su credibilidad.
- Mantén el texto de llamada breve y enfocado. Una señal de varios párrafos pierde su impacto: mueve contenido extenso al cuerpo del artículo y utiliza la llamada para resumirlo o señalarlo.
- Usa las señales con moderación. Cuando cada otra sección tiene una señal, ninguna destaca. Reserva las señales para información que realmente necesite ser destacada.
- No uses solo el color para transmitir el significado — la etiqueta de señal (Info, Warning, Error, Success) ya comunica el tipo, por lo que el contenido debería ser autoexplicativo incluso sin color.
- Siempre previsualiza las llamadas en modo oscuro después de personalizar los colores para asegurar un contraste y legibilidad adecuados.
Preguntas frecuentes
¿Puedo usar un color personalizado para una sola llamada sin afectar a todos los demás?
No. La personalización de color de los callouts mediante CSS personalizado se aplica a todos los callouts de ese tipo en toda la base de conocimiento. No es posible aplicar un color diferente a una instancia de callout individual.
¿Puedo cambiar el tipo de callout después de insertarlo?
No puedes cambiar directamente una llamada de un tipo a otro. Elimina la llamada existente y vuelve a insertar el tipo correcto usando el comando barra.