📝 Homogeneiza README y documentación de crates
This commit is contained in:
parent
15a96a8310
commit
3fba1ca875
13 changed files with 460 additions and 49 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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(
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue