pagetop/extensions/pagetop-bootsier
2026-11-07 16:39:22 +01:00
..
assets ✨ (bootsier): Maqueta la plantilla Admin del panel 2026-11-07 16:39:22 +01:00
src ✨ (bootsier): Maqueta la plantilla Admin del panel 2026-11-07 16:39:22 +01:00
tests ♿️ (form): Enlaza ayuda de los campos a su control 2026-10-09 00:59:43 +02: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 ✨ (bootsier): Maqueta la plantilla Admin del panel 2026-11-07 16:39:22 +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: tras la cabecera pinta la navegación del panel (AdminMenu) y, en lugar del contenido, el marco de la página (AdminFrame: migas, título, botones y pestañas). Los dos se construyen 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()),
));

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.