pagetop/extensions/pagetop-bootsier
Manuel Cillero d83f8b0f7f 💄 Renueva los estilos de Basic y Bootsier
- Bootsier: paleta propia a partir del logotipo, campos rellenos con
  sombra al enfocar, fieldsets y mensajes con sombra en vez de borde,
  desplegables sin borde, migas con fondo y paginador adaptable.
- Bootsier: quita la rejilla de Bootstrap (la maquetación es de Flex y
  Grid) y el container-fluid interior de la barra de navegación.
- Basic: margen inferior en campos y bloques, padding lateral en el
  envoltorio de la página y paginador que se reparte en varias líneas.
- Nuevo ejemplo theme-showcase con todos los componentes en los dos
  temas.
2026-11-16 14:22:18 +01:00
..
assets 💄 Renueva los estilos de Basic y Bootsier 2026-11-16 14:22:18 +01:00
src 💄 Renueva los estilos de Basic y Bootsier 2026-11-16 14:22:18 +01:00
tests ✨ Detecta errores de programación en desarrollo 2026-11-08 12:59:45 +01:00
.gitattributes 🎨 (bootsier): Ajusta estilos para personalizar 2025-10-12 20:37:38 +02:00
build.rs 🔥 (bootsier): Elimina AdminLTE 2026-09-22 21:34:16 +02:00
Cargo.toml 🔧 Declara la versión mínima de Rust (1.88) 2026-10-17 11:41:23 +02:00
CHANGELOG.md 🔖 Prepara publicación de pagetop-bootsier 0.1.1 2026-05-07 21:21:47 +02:00
LICENSE-APACHE 📄 Actualiza licencias y revisa *badges* de README 2025-10-12 13:08:33 +02:00
LICENSE-MIT 📄 Actualiza licencias y revisa *badges* de README 2025-10-12 13:08:33 +02:00
README.md ♻️ (admin): Navegación del panel con Nav::admin() 2026-11-16 13:09:08 +01:00

PageTop Bootsier

Tema de PageTop basado en Bootstrap para aplicar su catálogo de estilos y componentes flexibles.

Doc API Crates.io Descargas Licencia

Sobre PageTop

PageTop es un entorno de desarrollo que reivindica la esencia de la web clásica para crear soluciones web SSR (renderizadas en el servidor) modulares, extensibles y configurables, basadas en HTML, CSS y JavaScript.

Guía rápida

Igual que con otras extensiones, añade la dependencia a tu Cargo.toml:

[dependencies]
pagetop-bootsier = { ... }

Declara la extensión en tu aplicación (o extensión que la requiera). Recuerda que el orden en dependencies() determina la prioridad relativa frente a las otras extensiones:

use pagetop::prelude::*;

struct MyApp;

#[async_trait]
impl Extension for MyApp {
    fn dependencies(&self) -> Vec<ExtensionRef> {
        vec![
            // ...
            &pagetop_bootsier::Bootsier,
            // ...
        ]
    }
}

Y selecciona el tema en la configuración de la aplicación:

[app]
theme = "Bootsier"

o fuerza el tema por código en una página concreta:

use pagetop::prelude::*;
use pagetop_bootsier::Bootsier;

async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
    Page::new(request)
        .with_theme(&Bootsier)
        .with_child(
            Block::new()
                .with_title(Lc::l("sample_title"))
                .with_child(Html::with(|cx| html! {
                    p { (Lc::l("sample_content").using(cx)) }
                })),
        )
        .render().await
}

Plantillas

Bootsier maqueta las dos plantillas de PageTop (CoreTemplates) con las mismas regiones (cabecera, lateral, contenido y pie): Standard, la plantilla por defecto de cualquier página; y Admin, que se activa creando la página con Page::admin() en lugar de Page::new() y añade el panel de administración (ver más abajo).

use pagetop::prelude::*;

async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
    Page::new(request)
        .with_child(Html::with(|_| html! {
            h1 { "Sobre nosotros" }
            p { "Texto de presentación." }
        }))
        .render().await
}

Panel de administración

En la plantilla Admin, Bootsier sigue la composición del núcleo: en lugar del contenido pinta el marco de la página (AdminFrame: migas, título, botones y pestañas). La navegación del panel (Nav::admin()) la coloca la aplicación, en una barra aparte o en su barra principal, donde se pliega con su botón en pantallas pequeñas. Todo se construye con componentes del núcleo (Navbar/Nav/Dropdown, Breadcrumb), que Bootsier ya pinta con su aspecto.

Selector de modo de color

bs::theme_toggle() crea un ítem de menú con el selector de modo de color (claro / oscuro / automático), pensado para añadirse a cualquier Nav de la aplicación, no sólo a las páginas de administración:

use pagetop::prelude::*;
use pagetop_bootsier::theme::*;

let navbar = bs::Navbar::simple().with_item(bs::navbar::Item::nav(
    bs::Nav::new()
        .with_item(bs::nav::Item::link(Lc::n("Home"), "/"))
        .with_item(bs::theme_toggle()),
));

Temas hijo

Un tema hijo hereda todo de Bootsier (plantillas, componentes, estilos, scripts y fuentes) y cambia su aspecto con una hoja de estilos propia que se carga detrás de la de Bootsier. Esa hoja sólo contiene lo que cambia: Bootstrap define casi todo su aspecto con variables CSS (--bs-*), y basta con redefinirlas:

:root {
  --bs-border-radius: .25rem;
  --bs-link-color: #6f42c1;
  --bs-link-color-rgb: 111, 66, 193;
  --bs-link-hover-color: #59359a;
  --bs-link-hover-color-rgb: 89, 53, 154;
}

Las variantes de color de los componentes (.btn-primary, .alert-primary...) llevan sus propios valores, así que se cambian redefiniendo las variables de cada componente:

.btn-primary {
  --bs-btn-bg: #6f42c1;
  --bs-btn-border-color: #6f42c1;
  --bs-btn-hover-bg: #59359a;
  --bs-btn-hover-border-color: #59359a;
  --bs-btn-active-bg: #4b2d83;
  --bs-btn-active-border-color: #4b2d83;
}

Lo redefinido en :root vale también en el modo oscuro, porque gana a los valores oscuros de Bootstrap; lo que deba ser distinto en él va dentro de [data-bs-theme=dark] { ... }.

El build.rs del tema hijo incluye la hoja en el binario con pagetop-build:

use pagetop_build::StaticFilesBundle;

fn main() -> std::io::Result<()> {
    StaticFilesBundle::from_dir("./assets/css", None)
        .with_name("my_theme_css")
        .build()
}

El tema la sirve con serve_static_files!(files, [my_theme_css] => "/my-theme/css") en Extension::configure_static_files(), declara a Bootsier como padre y añade su hoja tras la de Bootsier:

use pagetop::prelude::*;
use pagetop_bootsier::Bootsier;

pub struct MyTheme;

#[async_trait]
impl Extension for MyTheme {
    fn theme(&self) -> Option<ThemeRef> {
        Some(&Self)
    }

    fn dependencies(&self) -> Vec<ExtensionRef> {
        vec![&Bootsier]
    }
}

#[async_trait]
impl Theme for MyTheme {
    fn parent(&self) -> Option<ThemeRef> {
        Some(&Bootsier)
    }

    fn before_render_page_body(&self, page: &mut Page) {
        Bootsier.before_render_page_body(page);
        // Justo detrás de la hoja de Bootsier (peso -99).
        page.alter_assets(StyleSheet::from("/my-theme/css/my-theme.css").with_weight(-98));
    }
}

Créditos

Este crate integra la biblioteca de estilos Bootstrap 5.3.8 para definir el comportamiento, la apariencia y los componentes de la interfaz. Bootstrap se distribuye bajo licencia MIT.

Los iconos son los de Bootstrap Icons 1.13.1, bajo licencia MIT, y la tipografía es Source Sans 3, de Adobe, bajo licencia SIL Open Font License 1.1.

Advertencia

PageTop es un proyecto personal para aprender Rust y conocer su ecosistema. Su API está sujeta a cambios frecuentes. No se recomienda su uso en producción, al menos hasta que se libere la versión 1.0.0.

Licencia

El código está disponible bajo una doble licencia:

Puedes elegir la licencia que prefieras. Este enfoque de doble licencia es el estándar de facto en el ecosistema Rust.