121 lines
3.6 KiB
Rust
121 lines
3.6 KiB
Rust
/*!
|
|
<div align="center">
|
|
|
|
<h1>PageTop Bootsier</h1>
|
|
|
|
<p>Tema de <strong>PageTop</strong> basado en Bootstrap para ofrecer su catálogo de estilos y componentes flexibles.</p>
|
|
|
|
[](#-licencia)
|
|
[](https://docs.rs/pagetop-bootsier)
|
|
[](https://crates.io/crates/pagetop-bootsier)
|
|
[](https://crates.io/crates/pagetop-bootsier)
|
|
|
|
<br>
|
|
</div>
|
|
|
|
## Sobre PageTop
|
|
|
|
[PageTop](https://docs.rs/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`:
|
|
|
|
```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:
|
|
|
|
```rust,no_run
|
|
use pagetop::prelude::*;
|
|
|
|
struct MyApp;
|
|
|
|
impl Extension for MyApp {
|
|
fn dependencies(&self) -> Vec<ExtensionRef> {
|
|
vec![
|
|
// ...
|
|
&pagetop_bootsier::Bootsier,
|
|
// ...
|
|
]
|
|
}
|
|
}
|
|
|
|
#[pagetop::main]
|
|
async fn main() -> std::io::Result<()> {
|
|
Application::prepare(&MyApp).run()?.await
|
|
}
|
|
```
|
|
|
|
Y **selecciona el tema en la configuración** de la aplicación:
|
|
|
|
```toml
|
|
[app]
|
|
theme = "Bootsier"
|
|
```
|
|
|
|
…o **fuerza el tema por código** en una página concreta:
|
|
|
|
```rust,no_run
|
|
use pagetop::prelude::*;
|
|
|
|
async fn homepage(request: HttpRequest) -> ResultPage<Markup, ErrorPage> {
|
|
Page::new(request)
|
|
.with_theme("Bootsier")
|
|
.add_component(
|
|
Block::new()
|
|
.with_title(L10n::l("sample_title"))
|
|
.add_component(Html::with(|cx| html! {
|
|
p { (L10n::l("sample_content").using(cx)) }
|
|
})),
|
|
)
|
|
.render()
|
|
}
|
|
```
|
|
*/
|
|
|
|
use pagetop::prelude::*;
|
|
|
|
/// El tema usa las mismas regiones predefinidas por [`ThemeRegion`].
|
|
pub type BootsierRegion = ThemeRegion;
|
|
|
|
// Versión de la librería Bootstrap.
|
|
const BOOTSTRAP_VERSION: &str = "5.3.3";
|
|
|
|
/// Tema basado en [Bootstrap](https://getbootstrap.com/) para los componentes base de PageTop.
|
|
///
|
|
/// Ofrece composición de páginas *responsive*, utilidades y componentes listos para usar, con
|
|
/// estilos coherentes y enfoque en accesibilidad.
|
|
pub struct Bootsier;
|
|
|
|
impl Extension for Bootsier {
|
|
fn theme(&self) -> Option<ThemeRef> {
|
|
Some(&Self)
|
|
}
|
|
|
|
fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
|
|
static_files_service!(scfg, [bootsier] => "/bootsier/css");
|
|
static_files_service!(scfg, [bootsier_js] => "/bootsier/js");
|
|
}
|
|
}
|
|
|
|
impl Theme for Bootsier {
|
|
fn after_render_page_body(&self, page: &mut Page) {
|
|
page.alter_assets(ContextOp::AddStyleSheet(
|
|
StyleSheet::from("/bootsier/css/bootstrap.min.css")
|
|
.with_version(BOOTSTRAP_VERSION)
|
|
.with_weight(-90),
|
|
))
|
|
.alter_assets(ContextOp::AddJavaScript(
|
|
JavaScript::defer("/bootsier/js/bootstrap.min.js")
|
|
.with_version(BOOTSTRAP_VERSION)
|
|
.with_weight(-90),
|
|
));
|
|
}
|
|
}
|