📝 Homogeneiza README y documentación de crates

This commit is contained in:
Manuel Cillero 2026-11-01 06:57:14 +01:00
parent 15a96a8310
commit 3fba1ca875
13 changed files with 460 additions and 49 deletions

View file

@ -75,12 +75,12 @@ async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
## Plantillas
Bootsier maqueta las dos plantillas de PageTop (`CoreTemplates`) con la misma cabecera, 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()`. Ambas se maquetan igual hoy -- la
distinción entre página "normal" y de administración no vive en el maquetado, sino en qué
extensión registra contenido en cada región y para qué plantilla se autolimita (por ejemplo, el
menú de `pagetop-admin`, ver más abajo).
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()`. Ambas se maquetan igual
hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué
extensión registra contenido en cada región y para qué plantilla se autolimita (por ejemplo, el menú
de `pagetop-admin`, ver más abajo).
```rust,no_run
use pagetop::prelude::*;
@ -91,7 +91,7 @@ async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
h1 { "Sobre nosotros" }
p { "Texto de presentación." }
}))
.render()
.render().await
}
```
@ -125,6 +125,11 @@ Este *crate* integra la biblioteca de estilos [Bootstrap 5.3.8](https://getboots
definir el comportamiento, la apariencia y los componentes de la interfaz. Bootstrap se distribuye
bajo licencia [MIT](https://github.com/twbs/bootstrap/blob/main/LICENSE).
Los iconos son los de [Bootstrap Icons 1.13.1](https://icons.getbootstrap.com/), bajo licencia
[MIT](https://github.com/twbs/icons/blob/main/LICENSE), y la tipografía es
[Source Sans 3](https://github.com/adobe-fonts/source-sans), de Adobe, bajo licencia
[SIL Open Font License 1.1](https://github.com/adobe-fonts/source-sans/blob/release/LICENSE.md).
## Advertencia
**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su

View file

@ -73,6 +73,52 @@ async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
.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()`. Ambas se maquetan igual
hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué
extensión registra contenido en cada región y para qué plantilla se autolimita (por ejemplo, el menú
de `pagetop-admin`, ver más abajo).
```rust,no_run
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
}
```
## Menú de administración
`pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y
páginas en `CoreRegions::Aside`, autolimitado a páginas con la plantilla `Admin` -- no requiere
ningún registro por parte de Bootsier. Se construye con `Navbar`/`Nav`/`Dropdown`, los mismos
componentes disponibles para cualquier página de la aplicación.
## 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:
```rust,no_run
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()),
));
```
*/
#![doc(