¡Discourse es increíblemente personalizable!
El objetivo de este tema es mostrarte cómo sacar provecho de todas las opciones maravillosas que tienes disponibles como desarrollador de temas. Ya sabes… para que no tengas que reinventar la rueda ![]()
¿Variables? ¿Qué variables?
Las variables cubren una gran cantidad de aspectos, desde tamaños de fuente y colores hasta valores de z-index. Puedes usar y sobrescribir la gran mayoría de las variables en tu editor de temas.
Colores
Hay muchos colores disponibles para que los uses o sobrescribas en tu tema. Puedes ver el conjunto básico de colores en la interfaz de administración, en Personalizar > Colores. Aquí tienes una captura de pantalla del esquema de colores predeterminado:
Estos colores están disponibles como propiedades personalizadas de CSS que puedes usar y sobrescribir mediante esta sintaxis:
var(--primary)
var(--secondary)
var(--tertiary)
var(--quaternary)
var(--header_background)
var(--header_primary)
var(--highlight)
var(--danger)
var(--success)
var(--love)
El uso de variables de color SCSS (como
$primary,$secondaryy así sucesivamente) está obsoleto. Discourse core utiliza propiedades personalizadas de CSS desde agosto de 2020 y recomendamos que todos los temas existentes cambien las variables SCSS a propiedades personalizadas de CSS. Para manipulaciones complejas de color, consulta esta guía.
Entonces, ¿cómo puedo usarlos?
Comienza creando un nuevo tema o, si estás utilizando un tema basado en git, crea un nuevo componente de tema y añádelo a tu tema.
Digamos que quiero establecer el fondo de <body> para que coincida con el color highlight del esquema de colores actual. Bueno, puedo hacerlo así:
body {
background: var(--highlight);
}
Y el color se extraería automáticamente del esquema de colores actual, así:
(Este color de fondo no es recomendable
)
Ahora, digamos que el esquema de colores actual no está configurado como “Light scheme” (Esquema claro) para el tema actual. En cambio, supongamos que está configurado en el esquema “Dark” (Oscuro) predeterminado; el mismo código produciría un resultado diferente porque la variable es diferente.
Puedes ver cómo el fondo de <body> sigue la variable highlight actual, sea cual sea, para el esquema de colores actual.
Esto cubre las variables de color básicas. Discourse también utiliza colores derivados que se pueden usar o sobrescribir. Puedes ver la lista completa de colores del esquema de colores actual en el inspector de tu navegador; aquí tienes una captura de pantalla del tema predeterminado:
Ten en cuenta que puedes inspeccionar estos colores en cualquier instancia de Discourse, sin necesidad de estar autenticado. En tu propia instancia de Discourse, puedes (y deberías) usar también el plugin styleguide, que ahora está incluido en el core. Habilítalo y ve a /styleguide, y verás todos los elementos de la interfaz de usuario de Discourse, incluidos los colores:
(El anterior es el esquema de colores Grey Ember.)
Bien, pasemos a temas más avanzados:
Variables avanzadas
Echa un vistazo a este archivo en el repositorio de Discourse:
Aquí es donde se definen la mayoría de las variables. Al igual que los colores, estas variables están mágicamente disponibles para que las uses en las hojas de estilo de temas.
Intentaré desglosar el contenido del archivo a continuación:
Anchuras
$small-width: 800px !default;
$medium-width: 995px !default;
$large-width: 1110px !default;
Estas son muy útiles si quieres que tu tema coincida con el comportamiento nativo de Discourse, especialmente en las consultas de medios (media queries). Por ejemplo, echa un vistazo a las partes relevantes del scss precompilado para .user-info:
.user-info {
&.medium {
flex: 0 0 32%;
margin: 0 2% 4vh 0;
@media screen and (max-width: $small-width) {
flex: 0 0 48%;
margin-right: 0;
}
}
}
Observa cómo la consulta de medios recibe una variable para determinar un punto de corte para pantallas pequeñas y aplicar estilos diferentes.
Fuentes
--base-font-size: 0.938em; // eq. a 15px
--base-font-size-larger: 1.063em; // eq. a 17px
--base-font-size-largest: 1.118em; // eq. a 19px
// Definiciones de tamaño de fuente, multiplicador ^ (paso / intervalo)
--font-up-6: 2.296em;
--font-up-5: 2em;
--font-up-4: 1.7511em;
--font-up-3: 1.5157em;
--font-up-2: 1.3195em;
--font-up-1: 1.1487em; // 2^(1/5)
--font-0: 1em;
--font-down-1: 0.8706em; // 2^(-1/5)
--font-down-2: 0.7579em; // Tamaño más pequeño que usamos basado en la base de 1em
--font-down-3: 0.6599em;
--font-down-4: 0.5745em;
--font-down-5: 0.5em;
--font-down-6: 0.4355em;
Esto también es bastante sencillo, Discourse tiene un sistema de escalado de fuentes genial y deberías aprovecharlo.
Las unidades utilizadas están en em y, por lo tanto, serían relativas a --base-font-size, que se utiliza en el elemento <html>.
Así que:
.btn {
font-size: var(--font-up-6);
}
se compila a:
(–base-font-size * --font-up-6) o (14px * 2.296) = 32.14px
O esto:
Alturas de línea
--line-height-small: 1;
--line-height-medium: 1.2; // Encabezados o texto grande
--line-height-large: 1.4; // Texto normal o pequeño
Estas variables se pueden usar igual que en el ejemplo anterior. Ten en cuenta que son valores sin unidades. Esto es lo que eso significa:
Valores de z-index
$z-layers: (
"max": 9999,
"fullscreen": 1700,
"modal": (
"tooltip": 1600,
"popover": 1500,
"dropdown": 1400,
"content": 1300,
"overlay": 1200,
),
"mobile-composer": 1100,
"header": 1000,
"tooltip": 600,
"composer": (
"popover": 500,
"content": 400,
),
"dropdown": 300,
"usercard": 200,
"timeline": 100,
"base": 1,
);
Estos se pueden usar como se discutió aquí:
div {
z-index: z("header");
}
“o cuando están anidados, así:”
div {
z-index: z("modal", "dropdown");
}
“También puedes hacer matemática básica como esperarías:”
div {
z-index: z("base") + 1;
}
Los bloques de código anteriores son parte de la cita, pero los saqué para mejorar el formato
Ahora, aquí tienes un ejemplo:
Pon una caja encima del encabezado:
.zbox {
position: fixed;
top: 0;
left: 0;
height: 200px;
width: 200px;
background: red;
z-index: z("header") + 1;
}
Pon una caja debajo del encabezado:
.zbox {
position: fixed;
top: 0;
left: 0;
height: 200px;
width: 200px;
background: red;
z-index: z("header") - 1;
}
Sombras de caja
$box-shadow: (
"modal": 0 8px 60px rgba(0, 0, 0, 0.6),
"composer": 0 -1px 40px rgba(0, 0, 0, 0.12),
"menu-panel": 0 6px 14px rgba(0, 0, 0, 0.15),
"card": 0 4px 14px rgba(0, 0, 0, 0.15),
"dropdown": 0 2px 3px 0 rgba(0, 0, 0, 0.2),
"header": 0 2px 4px -1px rgba(0, 0, 0, 0.25),
"kbd": (
0 2px 0 rgba(0, 0, 0, 0.2),
0 0 0 1px dark-light-choose(#fff, #000) inset,
),
"focus": 0 0 6px 0 $tertiary,
"focus-danger": 0 0 6px 0 $danger,
);
Como puedes ver de alguna manera, la mayor parte del trabajo ya está hecho para ti en lo que respecta a las variables, y solo necesitas utilizar lo que ya está allí en la mayoría de los casos.
El uso de las sombras de caja se ve así:
.d-header {
box-shadow: shadow("focus");
}
Esto debería hacer que el encabezado utilice la sombra de caja de foco. Y si verificamos para confirmar:
Esta publicación es una wiki, así que edítala según sea necesario ![]()
Este documento está bajo control de versiones - sugiere cambios en github.








