diff --git a/README.md b/README.md
index fe85e66..e7fab94 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,7 @@
[](https://crates.io/crates/pagetop)
[](https://crates.io/crates/pagetop)
+
`PageTop` reivindica la esencia de la web clásica usando [Rust](https://www.rust-lang.org/es) para
@@ -32,7 +33,7 @@ según las necesidades de cada proyecto, incluyendo:
La aplicación más sencilla de `PageTop` se ve así:
-```rust
+```rust,no_run
use pagetop::prelude::*;
#[pagetop::main]
@@ -46,7 +47,7 @@ de bienvenida accesible desde un navegador local en la dirección `http://localh
Para personalizar el servicio, se puede crear una extensión de `PageTop` de la siguiente manera:
-```rust
+```rust,no_run
use pagetop::prelude::*;
struct HelloWorld;
@@ -83,9 +84,14 @@ El código se organiza en un *workspace* donde actualmente se incluyen los sigui
## Auxiliares
+ * **[pagetop-statics](https://git.cillero.es/manuelcillero/pagetop/src/branch/main/helpers/pagetop-statics)**,
+ es la librería que permite incluir archivos estáticos en el ejecutable de las aplicaciones
+ `PageTop` para servirlos de forma eficiente, con detección de cambios que optimizan el tiempo
+ de compilación.
+
* **[pagetop-build](https://git.cillero.es/manuelcillero/pagetop/src/branch/main/helpers/pagetop-build)**,
- permite incluir fácilmente archivos estáticos o archivos SCSS compilados directamente en el
- binario de las aplicaciones `PageTop`.
+ prepara los archivos estáticos o archivos SCSS compilados para incluirlos en el binario de las
+ aplicaciones `PageTop` durante la compilación de los ejecutables.
* **[pagetop-macros](https://git.cillero.es/manuelcillero/pagetop/src/branch/main/helpers/pagetop-macros)**,
proporciona una colección de macros que mejoran la experiencia de desarrollo con `PageTop`.
diff --git a/helpers/pagetop-build/README.md b/helpers/pagetop-build/README.md
index d9d5257..5af492b 100644
--- a/helpers/pagetop-build/README.md
+++ b/helpers/pagetop-build/README.md
@@ -18,6 +18,107 @@ clásica para crear soluciones web SSR (*renderizadas en el servidor*) modulares
configurables, basadas en HTML, CSS y JavaScript.
+# ⚡️ Guía rápida
+
+Añadir en el archivo `Cargo.toml` del proyecto:
+
+```toml
+[build-dependencies]
+pagetop-build = { ... }
+```
+
+Y crear un archivo `build.rs` a la altura de `Cargo.toml` para indicar cómo se van a incluir los
+archivos estáticos o cómo se van a compilar los archivos SCSS para el proyecto. Casos de uso:
+
+## Incluir archivos estáticos desde un directorio
+
+Hay que preparar una carpeta en el proyecto con todos los archivos que se quieren incluir, por
+ejemplo `static`, y añadir el siguiente código en `build.rs` para crear el conjunto de recursos:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+
+fn main() -> std::io::Result<()> {
+ StaticFilesBundle::from_dir("./static", None)
+ .with_name("guides")
+ .build()
+}
+```
+
+Si es necesario, se puede añadir un filtro para seleccionar archivos específicos de la carpeta, por
+ejemplo:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+use std::path::Path;
+
+fn main() -> std::io::Result<()> {
+ fn only_pdf_files(path: &Path) -> bool {
+ // Selecciona únicamente los archivos con extensión `.pdf`.
+ path.extension().map_or(false, |ext| ext == "pdf")
+ }
+
+ StaticFilesBundle::from_dir("./static", Some(only_pdf_files))
+ .with_name("guides")
+ .build()
+}
+```
+
+## Compilar archivos SCSS a CSS
+
+Se puede compilar un archivo SCSS, que podría importar otros a su vez, para preparar un recurso con
+el archivo CSS minificado obtenido. Por ejemplo:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+
+fn main() -> std::io::Result<()> {
+ StaticFilesBundle::from_scss("./styles/main.scss", "styles.min.css")
+ .with_name("main_styles")
+ .build()
+}
+```
+
+Este código compila el archivo `main.scss` de la carpeta `static` del proyecto, y prepara un recurso
+llamado `main_styles` que contiene el archivo `styles.min.css` obtenido.
+
+
+# 📦 Módulos generados
+
+Cada conjunto de recursos [`StaticFilesBundle`] genera un archivo en el directorio estándar
+[OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
+donde se incluyen los recursos necesarios para compilar el proyecto. Por ejemplo, para
+`with_name("guides")` se crea un archivo llamado `guides.rs`.
+
+No hay ningún problema en generar más de un conjunto de recursos para cada proyecto.
+
+Normalmente no habrá que acceder a estos módulos; bastará con incluirlos en el proyecto con
+[`include_files!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files.html), y luego con
+[`include_files_service!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files_service.html)
+configurar un servicio web para servir los recursos desde la ruta indicada:
+
+```rust,ignore
+use pagetop::prelude::*;
+
+include_files!(guides);
+
+pub struct MyExtension;
+
+impl Extension for MyExtension {
+ // Servicio web que publica los recursos de `guides` en `/ruta/a/guides`.
+ fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
+ include_files_service!(scfg, guides => "/ruta/a/guides");
+ }
+}
+```
+
+También se puede asignar el conjunto de recursos a una variable global; p.ej. `GUIDES`:
+
+```rust,ignore
+include_files!(GUIDES => guides);
+```
+
+
# 🚧 Advertencia
`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su
diff --git a/helpers/pagetop-build/src/lib.rs b/helpers/pagetop-build/src/lib.rs
index b360377..6f74341 100644
--- a/helpers/pagetop-build/src/lib.rs
+++ b/helpers/pagetop-build/src/lib.rs
@@ -1,122 +1,124 @@
-//!
-//!
-//!
PageTop Build
-//!
-//!
Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto PageTop.
-//!
-//! [](#-licencia)
-//! [](https://docs.rs/pagetop-build)
-//! [](https://crates.io/crates/pagetop-build)
-//! [](https://crates.io/crates/pagetop-build)
-//!
-//!
-//!
-//! ## 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
-//!
-//! Añadir en el archivo `Cargo.toml` del proyecto:
-//!
-//! ```toml
-//! [build-dependencies]
-//! pagetop-build = { ... }
-//! ```
-//!
-//! Y crear un archivo `build.rs` a la altura de `Cargo.toml` para indicar cómo se van a incluir los
-//! archivos estáticos o cómo se van a compilar los archivos SCSS para el proyecto. Casos de uso:
-//!
-//! ## Incluir archivos estáticos desde un directorio
-//!
-//! Hay que preparar una carpeta en el proyecto con todos los archivos que se quieren incluir, por
-//! ejemplo `static`, y añadir el siguiente código en `build.rs` para crear el conjunto de recursos:
-//!
-//! ```rust,no_run
-//! use pagetop_build::StaticFilesBundle;
-//!
-//! fn main() -> std::io::Result<()> {
-//! StaticFilesBundle::from_dir("./static", None)
-//! .with_name("guides")
-//! .build()
-//! }
-//! ```
-//!
-//! Si es necesario, se puede añadir un filtro para seleccionar archivos específicos de la carpeta,
-//! por ejemplo:
-//!
-//! ```rust,no_run
-//! use pagetop_build::StaticFilesBundle;
-//! use std::path::Path;
-//!
-//! fn main() -> std::io::Result<()> {
-//! fn only_pdf_files(path: &Path) -> bool {
-//! // Selecciona únicamente los archivos con extensión `.pdf`.
-//! path.extension().map_or(false, |ext| ext == "pdf")
-//! }
-//!
-//! StaticFilesBundle::from_dir("./static", Some(only_pdf_files))
-//! .with_name("guides")
-//! .build()
-//! }
-//! ```
-//!
-//! ## Compilar archivos SCSS a CSS
-//!
-//! Se puede compilar un archivo SCSS, que podría importar otros a su vez, para preparar un recurso
-//! con el archivo CSS minificado obtenido. Por ejemplo:
-//!
-//! ```rust,no_run
-//! use pagetop_build::StaticFilesBundle;
-//!
-//! fn main() -> std::io::Result<()> {
-//! StaticFilesBundle::from_scss("./styles/main.scss", "styles.min.css")
-//! .with_name("main_styles")
-//! .build()
-//! }
-//! ```
-//!
-//! Este código compila el archivo `main.scss` de la carpeta `static` del proyecto, y prepara un
-//! recurso llamado `main_styles` que contiene el archivo `styles.min.css` obtenido.
-//!
-//!
-//! # 📦 Módulos generados
-//!
-//! Cada conjunto de recursos [`StaticFilesBundle`] genera un archivo en el directorio estándar
-//! [OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
-//! donde se incluyen los recursos necesarios para compilar el proyecto. Por ejemplo, para
-//! `with_name("guides")` se crea un archivo llamado `guides.rs`.
-//!
-//! No hay ningún problema en generar más de un conjunto de recursos para cada proyecto.
-//!
-//! Normalmente no habrá que acceder a estos módulos; bastará con incluirlos en el proyecto con
-//! [`include_files!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files.html), y luego con
-//! [`include_files_service!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files_service.html)
-//! configurar un servicio web para servir los recursos desde la ruta indicada:
-//!
-//! ```rust,ignore
-//! use pagetop::prelude::*;
-//!
-//! include_files!(guides);
-//!
-//! pub struct MyExtension;
-//!
-//! impl Extension for MyExtension {
-//! // Servicio web que publica los recursos de `guides` en `/ruta/a/guides`.
-//! fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
-//! include_files_service!(scfg, guides => "/ruta/a/guides");
-//! }
-//! }
-//! ```
-//!
-//! También se puede asignar el conjunto de recursos a una variable global; p.ej. `GUIDES`:
-//!
-//! ```rust,ignore
-//! include_files!(GUIDES => guides);
-//! ```
+/*!
+
+
+
PageTop Build
+
+
Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto PageTop.
+
+[](#-licencia)
+[](https://docs.rs/pagetop-build)
+[](https://crates.io/crates/pagetop-build)
+[](https://crates.io/crates/pagetop-build)
+
+
+
+## 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
+
+Añadir en el archivo `Cargo.toml` del proyecto:
+
+```toml
+[build-dependencies]
+pagetop-build = { ... }
+```
+
+Y crear un archivo `build.rs` a la altura de `Cargo.toml` para indicar cómo se van a incluir los
+archivos estáticos o cómo se van a compilar los archivos SCSS para el proyecto. Casos de uso:
+
+## Incluir archivos estáticos desde un directorio
+
+Hay que preparar una carpeta en el proyecto con todos los archivos que se quieren incluir, por
+ejemplo `static`, y añadir el siguiente código en `build.rs` para crear el conjunto de recursos:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+
+fn main() -> std::io::Result<()> {
+ StaticFilesBundle::from_dir("./static", None)
+ .with_name("guides")
+ .build()
+}
+```
+
+Si es necesario, se puede añadir un filtro para seleccionar archivos específicos de la carpeta, por
+ejemplo:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+use std::path::Path;
+
+fn main() -> std::io::Result<()> {
+ fn only_pdf_files(path: &Path) -> bool {
+ // Selecciona únicamente los archivos con extensión `.pdf`.
+ path.extension().map_or(false, |ext| ext == "pdf")
+ }
+
+ StaticFilesBundle::from_dir("./static", Some(only_pdf_files))
+ .with_name("guides")
+ .build()
+}
+```
+
+## Compilar archivos SCSS a CSS
+
+Se puede compilar un archivo SCSS, que podría importar otros a su vez, para preparar un recurso con
+el archivo CSS minificado obtenido. Por ejemplo:
+
+```rust,no_run
+use pagetop_build::StaticFilesBundle;
+
+fn main() -> std::io::Result<()> {
+ StaticFilesBundle::from_scss("./styles/main.scss", "styles.min.css")
+ .with_name("main_styles")
+ .build()
+}
+```
+
+Este código compila el archivo `main.scss` de la carpeta `static` del proyecto, y prepara un recurso
+llamado `main_styles` que contiene el archivo `styles.min.css` obtenido.
+
+
+# 📦 Módulos generados
+
+Cada conjunto de recursos [`StaticFilesBundle`] genera un archivo en el directorio estándar
+[OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
+donde se incluyen los recursos necesarios para compilar el proyecto. Por ejemplo, para
+`with_name("guides")` se crea un archivo llamado `guides.rs`.
+
+No hay ningún problema en generar más de un conjunto de recursos para cada proyecto.
+
+Normalmente no habrá que acceder a estos módulos; bastará con incluirlos en el proyecto con
+[`include_files!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files.html), y luego con
+[`include_files_service!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files_service.html)
+configurar un servicio web para servir los recursos desde la ruta indicada:
+
+```rust,ignore
+use pagetop::prelude::*;
+
+include_files!(guides);
+
+pub struct MyExtension;
+
+impl Extension for MyExtension {
+ // Servicio web que publica los recursos de `guides` en `/ruta/a/guides`.
+ fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
+ include_files_service!(scfg, guides => "/ruta/a/guides");
+ }
+}
+```
+
+También se puede asignar el conjunto de recursos a una variable global; p.ej. `GUIDES`:
+
+```rust,ignore
+include_files!(GUIDES => guides);
+```
+*/
#
+[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.
+
+## Créditos
+
+Esta librería incluye entre sus macros una adaptación de
+[maud-macros](https://crates.io/crates/maud_macros)
([0.27.0](https://github.com/lambda-fairy/maud/tree/v0.27.0/maud_macros)) de
[Chris Wong](https://crates.io/users/lambda-fairy) y una versión renombrada de
[SmartDefault](https://crates.io/crates/smart_default) (0.7.1) de
@@ -21,12 +28,6 @@ Entre sus macros se incluye una adaptación de [maud-macros](https://crates.io/c
necesidad de referenciar `maud` o `smart_default` en las dependencias del archivo `Cargo.toml` de
cada proyecto `PageTop`.
-## 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.
-
# 🚧 Advertencia
diff --git a/helpers/pagetop-macros/src/lib.rs b/helpers/pagetop-macros/src/lib.rs
index 496ce82..6421ca6 100644
--- a/helpers/pagetop-macros/src/lib.rs
+++ b/helpers/pagetop-macros/src/lib.rs
@@ -1,21 +1,34 @@
-//!
-//!
-//!
PageTop Macros
-//!
-//!
Una colección de macros que mejoran la experiencia de desarrollo con PageTop.
-//!
-//! [](#-licencia)
-//! [](https://docs.rs/pagetop-macros)
-//! [](https://crates.io/crates/pagetop-macros)
-//! [](https://crates.io/crates/pagetop-macros)
-//!
-//!
-//!
-//! ## 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.
+/*!
+
+
+
PageTop Macros
+
+
Una colección de macros que mejoran la experiencia de desarrollo con PageTop.
+
+[](#-licencia)
+[](https://docs.rs/pagetop-macros)
+[](https://crates.io/crates/pagetop-macros)
+[](https://crates.io/crates/pagetop-macros)
+
+
+
+## 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.
+
+## Créditos
+
+Esta librería incluye entre sus macros una adaptación de
+[maud-macros](https://crates.io/crates/maud_macros)
+([0.27.0](https://github.com/lambda-fairy/maud/tree/v0.27.0/maud_macros)) de
+[Chris Wong](https://crates.io/users/lambda-fairy) y una versión renombrada de
+[SmartDefault](https://crates.io/crates/smart_default) (0.7.1) de
+[Jane Doe](https://crates.io/users/jane-doe), llamada `AutoDefault`. Estas macros eliminan la
+necesidad de referenciar `maud` o `smart_default` en las dependencias del archivo `Cargo.toml` de
+cada proyecto `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.
+
## Descripción general
-Permite a `PageTop` incluir archivos estáticos en el ejecutable de la aplicación para servirlos de
-forma eficiente vía web, con detección de cambios que optimiza el tiempo de compilación.
+Esta librería permite incluir archivos estáticos en el ejecutable de las aplicaciones `PageTop` para
+servirlos de forma eficiente vía web, con detección de cambios que optimizan el tiempo de
+compilación.
-Para ello, reúne el código de los *crates* [static-files](https://crates.io/crates/static_files)
+## Créditos
+
+Para ello, adapta el código de los *crates* [static-files](https://crates.io/crates/static_files)
(versión [0.2.5](https://github.com/static-files-rs/static-files/tree/v0.2.5)) y
[actix-web-static-files](https://crates.io/crates/actix_web_static_files) (versión
[4.0.1](https://github.com/kilork/actix-web-static-files/tree/v4.0.1)), desarrollados ambos por
@@ -22,12 +31,6 @@ Para ello, reúne el código de los *crates* [static-files](https://crates.io/cr
Estas implementaciones se integran en `PageTop` para evitar que cada proyecto tenga que declarar
`static-files` manualmente como dependencia en su `Cargo.toml`.
-## 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.
-
# 🚧 Advertencia
diff --git a/helpers/pagetop-statics/src/lib.rs b/helpers/pagetop-statics/src/lib.rs
index fffd1ae..dab50d9 100644
--- a/helpers/pagetop-statics/src/lib.rs
+++ b/helpers/pagetop-statics/src/lib.rs
@@ -1,18 +1,37 @@
-//!
-//!
-//!
PageTop Statics
-//!
-//!
Librería para automatizar la recopilación de recursos estáticos en PageTop.
-//!
-//! [](#-licencia)
-//!
-//!
-//!
-//! ## 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.
+/*!
+
+
+
PageTop Statics
+
+
Librería para automatizar la recopilación de recursos estáticos en PageTop.
+
+[](#-licencia)
+
+
+
+## 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.
+
+## Descripción general
+
+Esta librería permite incluir archivos estáticos en el ejecutable de las aplicaciones `PageTop` para
+servirlos de forma eficiente vía web, con detección de cambios que optimizan el tiempo de
+compilación.
+
+## Créditos
+
+Para ello, adapta el código de los *crates* [static-files](https://crates.io/crates/static_files)
+(versión [0.2.5](https://github.com/static-files-rs/static-files/tree/v0.2.5)) y
+[actix-web-static-files](https://crates.io/crates/actix_web_static_files) (versión
+[4.0.1](https://github.com/kilork/actix-web-static-files/tree/v4.0.1)), desarrollados ambos por
+[Alexander Korolev](https://crates.io/users/kilork).
+
+Estas implementaciones se integran en `PageTop` para evitar que cada proyecto tenga que declarar
+`static-files` manualmente como dependencia en su `Cargo.toml`.
+*/
#![doc(test(no_crate_inject))]
#
-//!
-//!
PageTop
-//!
-//!
Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.
-//!
-//! [](#-licencia)
-//! [](https://docs.rs/pagetop)
-//! [](https://crates.io/crates/pagetop)
-//! [](https://crates.io/crates/pagetop)
-//!
-//!
-//!
-//!
-//! `PageTop` reivindica la esencia de la web clásica usando [Rust](https://www.rust-lang.org/es)
-//! para la creación de soluciones web SSR (*renderizadas en el servidor*) basadas en HTML, CSS y
-//! JavaScript. Ofrece un conjunto de herramientas que los desarrolladores pueden implementar,
-//! extender o adaptar según las necesidades de cada proyecto, incluyendo:
-//!
-//! * **Acciones** (*actions*): alteran la lógica interna de una funcionalidad interceptando su
-//! flujo de ejecución.
-//! * **Componentes** (*components*): encapsulan HTML, CSS y JavaScript en unidades funcionales,
-//! configurables y reutilizables.
-//! * **Extensiones** (*extensions*): añaden, extienden o personalizan funcionalidades usando las
-//! APIs de `PageTop` o de terceros.
-//! * **Temas** (*themes*): son extensiones que permiten modificar la apariencia de páginas y
-//! componentes sin comprometer su funcionalidad.
-//!
-//! # ⚡️ Guía rápida
-//!
-//! La aplicación más sencilla de `PageTop` se ve así:
-//!
-//! ```rust,no_run
-//! use pagetop::prelude::*;
-//!
-//! #[pagetop::main]
-//! async fn main() -> std::io::Result<()> {
-//! Application::new().run()?.await
-//! }
-//! ```
-//!
-//! Este código arranca el servidor de `PageTop`. Con la
-//! [configuración por defecto](crate::global::SETTINGS), muestra una página de bienvenida accesible
-//! desde un navegador local en la dirección `http://localhost:8080`.
-//!
-//! Para personalizar el servicio, se puede crear una extensión de `PageTop` de la siguiente manera:
-//!
-//! ```rust,no_run
-//! use pagetop::prelude::*;
-//!
-//! struct HelloWorld;
-//!
-//! impl Extension for HelloWorld {
-//! fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
-//! scfg.route("/", service::web::get().to(hello_world));
-//! }
-//! }
-//!
-//! async fn hello_world(request: HttpRequest) -> ResultPage {
-//! Page::new(Some(request))
-//! .with_component(Html::with(move |_| html! { h1 { "Hello world!" } }))
-//! .render()
-//! }
-//!
-//! #[pagetop::main]
-//! async fn main() -> std::io::Result<()> {
-//! Application::prepare(&HelloWorld).run()?.await
-//! }
-//! ```
-//!
-//! Este programa implementa una extensión llamada `HelloWorld` que sirve una página web en la ruta
-//! raíz (`/`) mostrando el texto "Hello world!" dentro de un elemento HTML ``.
-//!
-//! # 🧩 Gestión de Dependencias
-//!
-//! Los proyectos que utilizan `PageTop` gestionan las dependencias con `cargo`, como cualquier otro
-//! proyecto en Rust.
-//!
-//! Sin embargo, es fundamental que cada extensión declare explícitamente sus
-//! [dependencias](core::extension::Extension::dependencies), si las tiene, para que `PageTop` pueda
-//! estructurar e inicializar la aplicación de forma modular.
+/*!
+
+
+

+
+
PageTop
+
+
Un entorno para el desarrollo de soluciones web modulares, extensibles y configurables.
+
+[](#-licencia)
+[](https://docs.rs/pagetop)
+[](https://crates.io/crates/pagetop)
+[](https://crates.io/crates/pagetop)
+
+
+
+
+`PageTop` reivindica la esencia de la web clásica usando [Rust](https://www.rust-lang.org/es) para
+la creación de soluciones web SSR (*renderizadas en el servidor*) basadas en HTML, CSS y JavaScript.
+Ofrece un conjunto de herramientas que los desarrolladores pueden implementar, extender o adaptar
+según las necesidades de cada proyecto, incluyendo:
+
+ * **Acciones** (*actions*): alteran la lógica interna de una funcionalidad interceptando su flujo
+ de ejecución.
+ * **Componentes** (*components*): encapsulan HTML, CSS y JavaScript en unidades funcionales,
+ configurables y reutilizables.
+ * **Extensiones** (*extensions*): añaden, extienden o personalizan funcionalidades usando las APIs
+ de `PageTop` o de terceros.
+ * **Temas** (*themes*): son extensiones que permiten modificar la apariencia de páginas y
+ componentes sin comprometer su funcionalidad.
+
+
+# ⚡️ Guía rápida
+
+La aplicación más sencilla de `PageTop` se ve así:
+
+```rust,no_run
+use pagetop::prelude::*;
+
+#[pagetop::main]
+async fn main() -> std::io::Result<()> {
+ Application::new().run()?.await
+}
+```
+
+Este código arranca el servidor de `PageTop`. Con la configuración por defecto, muestra una página
+de bienvenida accesible desde un navegador local en la dirección `http://localhost:8080`.
+
+Para personalizar el servicio, se puede crear una extensión de `PageTop` de la siguiente manera:
+
+```rust,no_run
+use pagetop::prelude::*;
+
+struct HelloWorld;
+
+impl Extension for HelloWorld {
+ fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
+ scfg.route("/", service::web::get().to(hello_world));
+ }
+}
+
+async fn hello_world(request: HttpRequest) -> ResultPage {
+ Page::new(Some(request))
+ .with_component(Html::with(move |_| html! { h1 { "Hello World!" } }))
+ .render()
+}
+
+#[pagetop::main]
+async fn main() -> std::io::Result<()> {
+ Application::prepare(&HelloWorld).run()?.await
+}
+```
+
+Este programa implementa una extensión llamada `HelloWorld` que sirve una página web en la ruta raíz
+(`/`) mostrando el texto "Hello world!" dentro de un elemento HTML ``.
+
+
+# 🧩 Gestión de Dependencias
+
+Los proyectos que utilizan `PageTop` gestionan las dependencias con `cargo`, como cualquier otro
+proyecto en Rust.
+
+Sin embargo, es fundamental que cada extensión declare explícitamente sus
+[dependencias](core::extension::Extension::dependencies), si las tiene, para que `PageTop` pueda
+estructurar e inicializar la aplicación de forma modular.
+*/
#![cfg_attr(docsrs, feature(doc_cfg))]
#![doc(