CSS personalizado
Aplica cambios de CSS en todo el proyecto y habilita el control total del diseño con CSS personalizado.
Si deseas aplicarlo (o probarlo) en una versión, puedes usar el selector .customise .version-{{versionSlug}}.
Personalizar el CSS
Para personalizar el CSS:
Abre Configuración del proyecto → Personalización.
En la tarjeta Código personalizado, haz clic en Editar CSS.
Introduce el CSS personalizado y luego haz clic en Guardar borrador en el menú superior. Esto guardará el CSS en modo borrador, para que puedas probarlo.
Para publicarlo a los lectores, haz clic en Guardar y publicar.
Para descartar los cambios del borrador, haz clic en Revertir.
El CSS se aplicará de inmediato.
CSS de la organización
Si tus proyectos pertenecen a una organización, el propietario puede mantener una hoja de estilos compartida entre ellos desde Configuración de la organización → CSS personalizado.
Un proyecto no la hereda automáticamente. Para activarla, abre Configuración del proyecto → Personalización y activa Usar CSS de la organización. La hoja de estilos de la organización se aplica primero y el CSS propio del proyecto después, de modo que una regla del proyecto prevalece sobre una regla de la organización con la misma especificidad.
Uso de un agente de programación con IA
Un agente de programación con IA como Claude Code, Cursor o Codex puede escribir el CSS por ti. Copia el siguiente prompt en tu agente y completa las tres líneas de la parte superior.
El prompt hace que el agente lea las páginas importantes antes de escribir nada: Personalización visual para comprobar si un ajuste ya resuelve lo que necesitas, esta página, Etiquetas HEAD personalizadas, Herramientas para desarrolladores y Personalizaciones populares. Para cualquier otra cosa, parte del llms.txt de este sitio.
Si tu agente no puede abrir páginas web, abre tú mismo cada enlace del prompt y pega el contenido después del prompt.
Pega el CSS que devuelva en CSS personalizado y luego pruébalo con Guardar borrador antes de publicar.
Probar el CSS
Probablemente quieras probar los cambios de CSS antes de enviarlos a tus clientes. Para probar el CSS, haz clic en Guardar borrador en el menú superior mientras editas el CSS. El borrador se aplica de inmediato dentro del editor, y los lectores siguen viendo el CSS publicado.
Para comprobar el borrador en tu documentación publicada, haz clic en Ver proyecto en borrador en el aviso situado sobre el CSS. Tu documentación se abre con el CSS del borrador aplicado, enmarcada en azul, con una barra en la parte inferior que lista los borradores que estás viendo. La documentación que abras desde el editor seguirá mostrando tus borradores de esta manera. Para ver una página como la ven los lectores, haz clic en Ver como lector en la barra, o abre la documentación en una ventana de incógnito.
Puedes revertir el borrador desde el botón Revertir del menú superior.
Al revertir el CSS, los cambios del borrador se descartan y se pierden.
Para probar la última aplicación frontend en el sitio de lectores si tu aplicación frontend está fijada, añade ?deployment_id=latest a la URL. Para confirmar qué versión de la aplicación se está usando, revisa el encabezado X-DeveloperHub-Version en la primera solicitud de red.
Probar el tema oscuro
Para probar el tema oscuro sin habilitarlo para tus lectores, usa la función Cambiar tema para aplicar el tema sin modificar la configuración del proyecto.
Desactivar estilos
Para comprobar si un estilo aplicado con CSS personalizado está causando problemas, quizá quieras desactivar momentáneamente todos los estilos personalizados solo en tu navegador. Para ello, añade el parámetro ?disableStyles=true a cualquier URL de la documentación publicada.
Por ejemplo, si tu documentación está disponible en https://example.com/docs, puedes desactivar los estilos personalizados durante tu sesión usando https://example.com/docs?disableStyles=true.
Cuando actualices la página sin disableStyles=true, los estilos personalizados volverán a estar habilitados.
¿Por qué personalizar el CSS?
Al personalizar el CSS, puedes:
Aplicar una imagen al encabezado de navegación.
Cambiar el estilo del índice.
Añadir iconos a las categorías del índice, o aplicar una transformación suave de color como en nuestra documentación.
Animar botones.
Importar otro archivo CSS usando
@import url(...).Usar tu propia fuente personalizada (que no sea de Google Fonts).
Crear una página de inicio personalizada, eliminando barras laterales y títulos.
Cambiar el tema de código.
O cualquier cosa que se te ocurra...
El CSS no está encapsulado y se aplica globalmente. El CSS de DeveloperHub cambia con frecuencia y no podemos garantizar un diseño consistente (consulta Fijar la versión de la aplicación frontend). Quizá quieras añadir !important a tus estilos.
Buenas prácticas de CSS
El CSS de DeveloperHub no está encapsulado y se aplica globalmente. Esto significa que puedes cambiarlo todo, incluido lo que ves en el editor, ¡e incluso el propio editor! Con tanto poder viene una gran responsabilidad, así que sigue estas buenas prácticas. Los ejemplos desarrollan un caso: "Cómo cambiar el color del título de la página".
Asegúrate de que los cambios de CSS personalizado se adapten a todos los tamaños de pantalla y dispositivos de entrada. El CSS predeterminado está diseñado para funcionar en teléfonos, tabletas, portátiles y pantallas grandes. Prueba siempre los cambios de CSS en todos los tamaños para garantizar la satisfacción de los lectores.
El CSS personalizado se aplica exactamente como lo escribes. Para llegar a todos los lectores, usa CSS que nuestros navegadores compatibles entiendan.
1 Usa .customise
.customise es un selector CSS que probablemente debas usar en todas tus reglas CSS. .customise engloba todo lo que no es el editor, que es todo lo que podrías querer personalizar. Por ejemplo:
2 Usa .live
.live es un selector CSS que probablemente debas usar en todas tus reglas CSS. .live engloba el CSS que solo se carga en tu sitio de documentación publicado, pero no en el editor. Cambiar los estilos de la página en el editor podría causar inconsistencias y romper funciones si el CSS no se escribe con mucho cuidado, por lo que es mejor que estos estilos se apliquen solo en el sitio publicado. Por ejemplo:
3 Usa selectores específicos
En nuestros ejemplos anteriores, h1 es un selector bastante vago. Si queremos cambiar el color del título de la página, es mejor usar su selector específico y solo en Documentación.
Cambiar el CSS de selectores genéricos como table, p, .container, .row, img, etc. modificará el aspecto global y probablemente romperá la funcionalidad tanto del editor como de la vista publicada. Usamos Bootstrap intensamente y no se recomienda cambiar sus estilos estándar. En su lugar, busca un selector específico donde aplicar los estilos.
Si estás creando una página de inicio, crea selectores específicos. Por ejemplo, si quisieras usar un .container, añade también un selector .x-container en el contenedor y aplica los estilos en .x-container en lugar del genérico .container.
Ejemplos de personalización de CSS
Consulta Personalizaciones populares.
Ejemplos en la página
Como no queremos cambiar el estilo de nuestra documentación (porque nos encanta), mostraremos aquí algunos elementos con estilo.
Botón de registro con efecto al pasar el cursor.
Enlaces a otras documentaciones.
Formularios de registro.
We'll send you updates every week
Variables CSS
Hemos configurado variables que puedes cambiar para modificar fácilmente el aspecto. Cuando se establece el tema, esas variables se modifican automáticamente.
Para modificar las variables usadas cuando el tema oscuro está habilitado, usa el selector .dark-mode, por ejemplo:
Grosores de fuente
Si la fuente asignada no tiene todos los grosores que usamos en DeveloperHub, puedes reasignar algunos grosores a otro:
Por ejemplo, si el grosor 500 no existe, puedes establecer --fw-500: 600, de modo que se use el grosor 600 siempre que se espere el 500.
Tenemos más variables que no se mencionan aquí, como --shadeX y --helperX, que no están pensadas para que el usuario las modifique. Cambiarlas sin duda provocará resultados inesperados.
Fijar la versión de la aplicación frontend
A medida que desarrollamos nuevas funciones para DeveloperHub, podemos cambiar el DOM, el CSS y el JavaScript que componen tu sitio de documentación. Estos cambios pueden interferir con tus cambios de CSS personalizado (si son extensos) y provocar un estilo inesperado en el sitio.
Para evitarlo, puedes fijar la versión de la aplicación frontend a un despliegue concreto. Esto significa que ningún cambio que hagamos en la aplicación de una sola página se reflejará a tus lectores. También podemos fijar automáticamente la versión de tu aplicación frontend cuando hagamos cambios importantes que puedan afectar al CSS personalizado.
Para fijar la versión de tu aplicación frontend:
Abre Configuración del proyecto → Avanzado.
Haz clic en el botón junto a Fijar versión de la aplicación frontend.
Elige una versión según su fecha y descripción.
Para desfijar la versión de la aplicación frontend, elige Última versión.
El cambio puede tardar hasta 5 minutos en reflejarse en el sitio de documentación. Solo se refleja en el sitio de lectores, no en el editor.
Aunque esto garantiza que tus lectores no vean estilos inesperados, también detiene todas las actualizaciones de tu sitio de documentación. Se espera que modifiques el CSS personalizado lo antes posible y vuelvas a la Última versión. No garantizamos que las versiones anteriores sigan funcionando.
Migrar a la última versión de la aplicación frontend
Si tienes fijada otra versión de la aplicación y quieres pasar a la última versión de la aplicación frontend para obtener las funciones más recientes, haz lo siguiente:
Prueba cómo se vería la documentación con la última versión de la aplicación frontend
Para probar la última aplicación frontend en el sitio de lectores si tu aplicación frontend está fijada, añade ?deployment_id=latest a la URL. Para confirmar qué versión de la aplicación se está usando, revisa X-DeveloperHub-Version header en la primera solicitud de red.
Carga al menos la página de inicio, una página de documentación y la referencia de la API con ?deployment_id=latest al final de la URL y comprueba que las páginas se ven como esperas. Si no, modifica el CSS/JS en modo borrador y sigue iterando hasta que las páginas se vean perfectas.
Asegúrate de añadir ?deployment_id=latest cada vez que recargues la página y quieras verla en la última versión de la aplicación.
Publica los cambios de CSS/JS
Como tus cambios de CSS/JS ya son perfectos, publícalos para tus lectores.
Desfija la versión de la aplicación frontend
Para desfijar la versión de tu aplicación frontend:
Abre Configuración del proyecto → Avanzado.
Haz clic en el botón junto a Fijar versión de la aplicación frontend.
Elige "Latest".
Need help? Visit our community forums or contact us.