Documentation Index

Fetch the complete documentation index at: https://docs.document360.com/llms.txt

Use this file to discover all available pages before exploring further.

Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

As of 22 Nov 2025, the Markdown editor has been upgraded from v1.4.10 to v3.2.2. The toolbar, layout, icons, and editor structure remain unchanged.

Cómo cambiar el texto del nombre del idioma en bloques de código

Prev Next

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.

NOTA

Este 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

  1. 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.

    Custom CSS and JavaScript settings panel in the Document360 Knowledge base portal

  2. 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;
}
  1. Sustituye "Example" por el texto de la etiqueta que deseas, por ejemplo, "Sample code", "Command", o el nombre de tu producto.

  2. Haz clic en Guardar.

    CSS tab showing the custom label snippet saved in the Custom CSS and JavaScript panel


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.