Los bloques de código en Document360 muestran el nombre del lenguaje de programación como una etiqueta por defecto, por ejemplo, css, javascript, o xml. Para bases de conocimiento que documentan sistemas propietarios, herramientas internas o formatos no estándar, estas etiquetas genéricas pueden resultar confusas o irrelevantes para los lectores. Sustituirlos por una etiqueta personalizada consistente como "Ejemplo" o "Código de ejemplo" hace que los bloques de código sean más claros y le da a tu documentación un aspecto más pulido y de marca.
Cuándo usar esto
Utiliza esta personalización cuando quieras:
- Sustituye los nombres de lenguajes técnicos por etiquetas fáciles de leer (por ejemplo, "Sample code" en lugar de "javascript").
- Aplica una etiqueta de bloque de código consistente en toda tu base de conocimientos para un aspecto uniforme.
- Documenta lenguajes de scripting propietarios o formatos de configuración donde la etiqueta predeterminada no coincida con tu contenido.
NOTAEste cambio de CSS se aplica a todos los bloques de código de toda tu base de conocimiento, no a artículos individuales o bloques específicos.
Antes de que empieces
Necesitas acceso a Configuración > sitio de la base de conocimientos> personalización del sitio > CSS y JavaScript personalizados en el portal de la base de conocimientos.
Cómo cambiar la etiqueta del idioma en bloques de código
-
Navega a Configuración (
) > Sitio de la base de conocimiento > personalización del sitio > CSS y JavaScript personalizados en el portal de la base de conocimiento.
-
Desde el panel de navegación izquierdo, selecciona la pestaña CSS y pega el siguiente fragmento CSS:
div.code-toolbar>.toolbar .toolbar-item:first-child {
visibility: hidden;
}
div.code-toolbar>.toolbar .toolbar-item:first-child span:before {
visibility: visible;
content: "Example" !important;
}
-
Sustituye
"Example"por el texto de la etiqueta que deseas, por ejemplo,"Sample code","Command", o el nombre de tu producto. -
Haz clic en Guardar.

Mejores prácticas
- Elige una etiqueta que refleje a tu audiencia. Los lectores que no son desarrolladores pueden encontrar etiquetas como "Ejemplo" o "Comando" más intuitivas que "bash" o "Python". Empareja la etiqueta con lo que tus lectores llaman a este tipo de contenido.
- Mantén la etiqueta breve. Las etiquetas de bloques de código tienen un espacio de visualización limitado. Las etiquetas de más de 20 caracteres pueden truncarse dependiendo del tamaño de pantalla del lector.
- Prueba después de guardar. Abre un artículo en tu base de conocimientos y confirma que la nueva etiqueta aparece correctamente en diferentes tipos de bloques de código antes de publicarlo para los lectores.
- Considera etiquetas por bloque para audiencias técnicas. Si tus lectores son desarrolladores que necesitan ver el lenguaje exacto, usa la función de etiqueta personalizada integrada de Document360 en bloques de código individuales en lugar de esta anulación CSS a nivel de sitio. Navega al bloque de código en el editor, selecciona Personalizado en el menú desplegable del idioma, haz clic en el icono Editar e introduce un título solo para ese bloque.