From cd9454a7293ea3237cd567d5bf9d43f0ea7f1983 Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Sat, 28 Mar 2026 07:48:20 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Retoques=20menores=20en=20docume?= =?UTF-8?q?ntaci=C3=B3n=20y=20ejemplos?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- extensions/pagetop-aliner/README.md | 2 +- extensions/pagetop-aliner/src/lib.rs | 2 +- extensions/pagetop-bootsier/README.md | 2 +- extensions/pagetop-bootsier/src/lib.rs | 10 +++++----- src/core/component/definition.rs | 12 +++++++----- src/html/unit.rs | 2 +- tools/release.sh | 2 +- 7 files changed, 17 insertions(+), 15 deletions(-) diff --git a/extensions/pagetop-aliner/README.md b/extensions/pagetop-aliner/README.md index f3849122..65f91f94 100644 --- a/extensions/pagetop-aliner/README.md +++ b/extensions/pagetop-aliner/README.md @@ -59,7 +59,7 @@ Y **selecciona el tema en la configuración** de la aplicación: theme = "Aliner" ``` -…o **fuerza el tema por código** en una página concreta: +o **fuerza el tema por código** en una página concreta: ```rust,no_run use pagetop::prelude::*; diff --git a/extensions/pagetop-aliner/src/lib.rs b/extensions/pagetop-aliner/src/lib.rs index 30621b21..aa0e6723 100644 --- a/extensions/pagetop-aliner/src/lib.rs +++ b/extensions/pagetop-aliner/src/lib.rs @@ -60,7 +60,7 @@ Y **selecciona el tema en la configuración** de la aplicación: theme = "Aliner" ``` -…o **fuerza el tema por código** en una página concreta: +o **fuerza el tema por código** en una página concreta: ```rust,no_run use pagetop::prelude::*; diff --git a/extensions/pagetop-bootsier/README.md b/extensions/pagetop-bootsier/README.md index e7a3ea79..a48bfd82 100644 --- a/extensions/pagetop-bootsier/README.md +++ b/extensions/pagetop-bootsier/README.md @@ -59,7 +59,7 @@ Y **selecciona el tema en la configuración** de la aplicación: theme = "Bootsier" ``` -…o **fuerza el tema por código** en una página concreta: +o **fuerza el tema por código** en una página concreta: ```rust,no_run use pagetop::prelude::*; diff --git a/extensions/pagetop-bootsier/src/lib.rs b/extensions/pagetop-bootsier/src/lib.rs index 0281fe7a..e23b391f 100644 --- a/extensions/pagetop-bootsier/src/lib.rs +++ b/extensions/pagetop-bootsier/src/lib.rs @@ -60,7 +60,7 @@ Y **selecciona el tema en la configuración** de la aplicación: theme = "Bootsier" ``` -…o **fuerza el tema por código** en una página concreta: +o **fuerza el tema por código** en una página concreta: ```rust,no_run use pagetop::prelude::*; @@ -69,10 +69,10 @@ use pagetop_bootsier::Bootsier; async fn homepage(request: HttpRequest) -> ResultPage { Page::new(request) .with_theme(&Bootsier) - .add_child( + .with_child( Block::new() .with_title(L10n::l("sample_title")) - .add_child(Html::with(|cx| html! { + .with_child(Html::with(|cx| html! { p { (L10n::l("sample_content").using(cx)) } })), ) @@ -118,7 +118,7 @@ impl Template for BootsierTemplate { .with_width(theme::container::Width::FluidMax( config::SETTINGS.bootsier.max_width, )) - .add_child(Html::with(|cx| { + .with_child(Html::with(|cx| { html! { (DefaultRegion::Header.render(cx)) (DefaultRegion::Content.render(cx)) @@ -163,7 +163,7 @@ impl Theme for Bootsier { )) .alter_child_in( &DefaultRegion::Footer, - ChildOp::AddIfEmpty(Child::with(PoweredBy::new())), + ChildOp::AddIfEmpty(PoweredBy::new().into()), ); } } diff --git a/src/core/component/definition.rs b/src/core/component/definition.rs index 8dd67434..2b64c5e8 100644 --- a/src/core/component/definition.rs +++ b/src/core/component/definition.rs @@ -133,14 +133,16 @@ impl ComponentClone for T { /// pueda ajustar su estructura interna. /// 3. Despacha [`action::component::BeforeRender`](crate::base::action::component::BeforeRender) /// para que las extensiones puedan hacer ajustes previos. -/// 4. **Prepara el renderizado del componente** recorriendo la cadena de temas (hijo → padre → -/// abuelo…) llamando a [`Theme::handle_component()`](crate::core::theme::Theme::handle_component) -/// en cada nivel hasta que uno devuelva `Some`. Si ninguno lo sobrescribe, llama a +/// 4. Prepara el renderizado del componente, recorre la cadena de temas (hijo > padre > abuelo...) +/// llamando a [`Theme::handle_component()`](crate::core::theme::Theme::handle_component) en cada +/// nivel hasta que uno devuelva `Some`. Si ninguno lo sobrescribe, llama al /// [`Component::prepare()`](Component::prepare) del propio componente. /// 5. Despacha [`action::component::AfterRender`](crate::base::action::component::AfterRender) /// para que las extensiones puedan reaccionar con sus últimos ajustes. -/// 6. Despacha [`action::component::TransformMarkup`](crate::base::action::component::TransformMarkup) -/// para que las extensiones puedan modificar el HTML final antes de devolverlo. +/// 6. Finalmente despacha +/// [`action::component::TransformMarkup`](crate::base::action::component::TransformMarkup) +/// para que las extensiones puedan trabajar sobre el HTML final para modificarlo antes de +/// devolverlo. /// 7. Devuelve el [`Markup`] resultante. impl ComponentRender for C { fn render(&mut self, cx: &mut Context) -> Markup { diff --git a/src/html/unit.rs b/src/html/unit.rs index af452598..cb564c71 100644 --- a/src/html/unit.rs +++ b/src/html/unit.rs @@ -56,7 +56,7 @@ use std::str::FromStr; /// /// - Las absolutas **no aceptan** decimales (p. ej., `"1.5px"` sería erróneo). /// - Se aceptan signos `+`/`-` en todas las unidades (p. ej., `"-12px"`, `"+0.5em"`). -/// - La comparación de unidad es *case-insensitive* al interpretar el texto (`"PX"`, `"Px"`, …). +/// - La comparación de unidad es *case-insensitive* al interpretar el texto (`"PX"`, `"Px"`, ...). /// - **Sobre píxeles**: Los píxeles (px) son relativos al dispositivo de visualización. En /// dispositivos con baja densidad de píxeles (dpi), 1px equivale a un píxel (punto) del /// dispositivo. En impresoras y pantallas de alta resolución, 1px implica múltiples píxeles del diff --git a/tools/release.sh b/tools/release.sh index bb092416..41dc2d4a 100755 --- a/tools/release.sh +++ b/tools/release.sh @@ -42,7 +42,7 @@ if [[ "$EXECUTE" != "--execute" ]]; then echo "Running dry-run (default mode). Add --execute to publish" cargo release --config "$CONFIG" --package "$CRATE" "$LEVEL" else - echo "Releasing $CRATE ($LEVEL)…" + echo "Releasing $CRATE ($LEVEL)..." cargo release --config "$CONFIG" --package "$CRATE" "$LEVEL" --execute echo "Release completed." fi