diff --git a/README.md b/README.md
index ee81baff..771659a1 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@
-`PageTop` reivindica la sencillez de la web clásica utilizando SSR (*renderizado en el servidor*),
+`PageTop` reivindica la sencillez de la web clásica combinando SSR (*renderizado en el servidor*),
HTML, CSS y JavaScript. Proporciona un conjunto completo de funcionalidades que pueden extenderse y
adaptarse a las necesidades de cada solución web implementando:
@@ -77,8 +77,7 @@ El repositorio se organiza en un *workspace* con los siguientes subproyectos:
* **[pagetop](https://github.com/manuelcillero/pagetop/tree/latest/pagetop)**, es la librería
principal. Reúne algunos de los *crates* más estables y populares del ecosistema Rust para
- proporcionar APIs, patrones de desarrollo y buenas prácticas para la creación avanzada de
- soluciones web SSR (*Server-Side Rendering*).
+ proporcionar APIs y recursos para la creación avanzada de soluciones web.
## Auxiliares
diff --git a/drust/README.md b/drust/README.md
index 61ae89d1..bb5e0d5f 100644
--- a/drust/README.md
+++ b/drust/README.md
@@ -16,10 +16,11 @@ dinámicos, manejables y personalizables; y facilite a los usuarios la gestión
contenidos de manera sencilla.
-# 📦 Sobre PageTop
+# 📌 Sobre PageTop
-[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
-sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
+[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
+clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
+modulares, extensibles y configurables.
# 🚧 Advertencia
diff --git a/drust/src/main.rs b/drust/src/main.rs
index 90fee5cf..f958109f 100644
--- a/drust/src/main.rs
+++ b/drust/src/main.rs
@@ -1,3 +1,21 @@
+//!
+//!
+//!
Drust
+//!
+//!
Un Sistema de Gestión de Contenidos (CMS) basado en PageTop para compartir tu mundo.
+//!
+//! [](#-license)
+//! [](https://crates.io/crates/drust)
+//! [](https://crates.io/crates/drust)
+//!
+//!
+//!
+//! # 📌 Sobre PageTop
+//!
+//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
+//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
+//! soluciones web modulares, extensibles y configurables.
+
use pagetop::prelude::*;
struct Drust;
diff --git a/helpers/pagetop-build/README.md b/helpers/pagetop-build/README.md
index 2afda877..abcc896e 100644
--- a/helpers/pagetop-build/README.md
+++ b/helpers/pagetop-build/README.md
@@ -11,10 +11,11 @@
-# 📦 Sobre PageTop
+# 📌 Sobre PageTop
-[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
-sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
+[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
+clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
+modulares, extensibles y configurables.
# 🚧 Advertencia
diff --git a/helpers/pagetop-build/src/lib.rs b/helpers/pagetop-build/src/lib.rs
index 51d39abb..61a18659 100644
--- a/helpers/pagetop-build/src/lib.rs
+++ b/helpers/pagetop-build/src/lib.rs
@@ -1,7 +1,23 @@
-//! Incluye fácilmente archivos estáticos o archivos SCSS compilados directamente en el binario de
-//! tus aplicaciones `PageTop``.
+//!
//!
-//! # Añadir al proyecto
+//!
PageTop Build
+//!
+//!
Incluye fácilmente archivos estáticos o archivos SCSS compilados directamente en el binario de tus aplicaciones PageTop.
+//!
+//! [](#-license)
+//! [](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 sencillez de
+//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
+//! soluciones web modulares, extensibles y configurables.
+//!
+//! # ⚡️ Guía rápida
//!
//! Añade en el archivo `Cargo.toml` de tu aplicación:
//!
@@ -10,12 +26,14 @@
//! pagetop-build = { ... }
//! ```
//!
-//! Crea luego un archivo `build.rs` para definir cómo se van a incluir los archivos estáticos o
-//! archivos SCSS en tu aplicación, diseño o paquete de `PageTop`. Ejemplos de uso:
+//! Luego crea un archivo `build.rs` para definir cómo se van a incluir los archivos estáticos o
+//! archivos SCSS en tu aplicación. Casos de uso:
//!
-//! ## 1. Incluir archivos estáticos desde un directorio
+//! ## Incluir archivos estáticos desde un directorio
//!
-//! Prepara un conjunto de recursos con todos los archivos de un directorio:
+//! Prepara una carpeta en tu proyecto con todos los archivos que deseas incluir, por ejemplo
+//! `static`, y añade el siguiente código a tu archivo `build.rs` para crear tu conjunto de
+//! recursos:
//!
//! ```rust#ignore
//! use pagetop_build::StaticFilesBundle;
@@ -27,54 +45,55 @@
//! }
//! ```
//!
-//! O aplica un filtro para incluir únicamente archivos específicos:
+//! Si es necesario, puedes añadir un filtro para seleccionar archivos específicos de la carpeta:
//!
//! ```rust#ignore
//! use pagetop_build::StaticFilesBundle;
//! use std::path::Path;
//!
//! fn main() -> std::io::Result<()> {
-//! fn solo_archivos_css(path: &Path) -> bool {
-//! // Incluye solo archivos con la extensión `.css`.
-//! path.extension().map_or(false, |ext| ext == "css")
+//! fn only_pdf_files(path: &Path) -> bool {
+//! // Include only files with the `.pdf` extension.
+//! path.extension().map_or(false, |ext| ext == "pdf")
//! }
//!
-//! StaticFilesBundle::from_dir("./static", Some(solo_archivos_css))
+//! StaticFilesBundle::from_dir("./static", Some(only_pdf_files))
//! .with_name("guides")
//! .build()
//! }
//! ```
//!
-//! ## 2. Compilar archivos SCSS a CSS
+//! ## Compilar archivos SCSS a CSS
//!
-//! Crea un archivo CSS compilando un archivo SCSS, que puede importar otros a su vez, para preparar
-//! el conjunto de recursos:
+//! Puedes compilar un archivo SCSS, que podría importar otros a su vez, para preparar un conjunto
+//! de recursos con el archivo CSS obtenido. Por ejemplo:
//!
//! ```rust#ignore
//! use pagetop_build::StaticFilesBundle;
//!
//! fn main() -> std::io::Result<()> {
-//! StaticFilesBundle::from_scss("./styles/main.scss", "main.css")
+//! StaticFilesBundle::from_scss("./styles/main.scss", "styles.css")
//! .with_name("main_styles")
//! .build()
//! }
//! ```
//!
-//! Este código compila el archivo `main.scss`, incluyendo los archivos SCSS que importe, en un
-//! archivo `main.css` que definirá el conjunto de recursos `main_styles`.
+//! Este código compila el archivo `main.scss` de la carpeta `static` del proyecto, en un archivo
+//! `styles.css` que se preparará como un conjunto de recursos llamado `main_styles`.
//!
//!
-//! # Módulos generados
+//! # 📦 Módulos generados
//!
-//! Cada [`StaticFilesBundle`] genera un archivo en el directorio estándar
-//! [OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html) donde se
-//! incluyen los recursos requeridos para compilar. Por ejemplo, si usas `with_name("guides")` se
-//! generará un archivo llamado `guides.rs`.
+//! 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 la compilación. Por ejemplo, para
+//! `with_name("guides")` se crea un archivo llamado `guides.rs`.
//!
//! Ten en cuenta que puedes generar más de un conjunto de recursos para usar en tu proyecto.
//!
-//! Normalmente no necesitarás acceder directamente a este archivo; simplemente inclúyelo en tu
-//! proyecto con `include_files!`, y luego configura un servicio web usando `include_files_service!`
+//! Normalmente no necesitarás acceder directamente a este archivo; sólo inclúyelo en tu proyecto
+//! con [`include_files!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files.html), y luego
+//! configura un servicio web usando [`include_files_service!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files_service.html)
//! para servir tu conjunto de recursos desde la ruta indicada:
//!
//! ```rust#ignore
@@ -92,7 +111,7 @@
//! }
//! ```
//!
-//! También puedes incluir el conjunto de recursos declarando un `HashMap` estático global:
+//! También podrías acceder a tu conjunto de recursos declarando un `HashMap` estático global:
//!
//! ```rust#ignore
//! use pagetop::prelude::*;
diff --git a/helpers/pagetop-macros/README.md b/helpers/pagetop-macros/README.md
index 99275ba8..4e5b0eba 100644
--- a/helpers/pagetop-macros/README.md
+++ b/helpers/pagetop-macros/README.md
@@ -20,10 +20,11 @@ necesidad de referenciar `maud` o `smart_default` en las dependencias del archiv
cada proyecto `PageTop`.
-# 📦 Sobre PageTop
+# 📌 Sobre PageTop
-[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
-sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
+[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
+clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
+modulares, extensibles y configurables.
# 🚧 Advertencia
diff --git a/helpers/pagetop-macros/src/lib.rs b/helpers/pagetop-macros/src/lib.rs
index ab94ea1a..2680e773 100644
--- a/helpers/pagetop-macros/src/lib.rs
+++ b/helpers/pagetop-macros/src/lib.rs
@@ -1,4 +1,21 @@
-//! Una colección de macros que impulsan el desarrollo con `PageTop`.
+//!
+//!
+//!
PageTop Macros
+//!
+//!
Una colección de macros que mejoran la experiencia de desarrollo con PageTop.
+//!
+//! [](#-license)
+//! [](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 sencillez de
+//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
+//! soluciones web modulares, extensibles y configurables.
mod maud;
mod smart_default;
diff --git a/packages/pagetop-seaorm/README.md b/packages/pagetop-seaorm/README.md
index c5223e31..2b3ce793 100644
--- a/packages/pagetop-seaorm/README.md
+++ b/packages/pagetop-seaorm/README.md
@@ -5,7 +5,7 @@
Integra SeaORM para trabajar con bases de datos en aplicaciones PageTop.
[](#-license)
-[](https://docs.rs/pagetop-seaorm)
+[](https://docs.rs/pagetop-seaorm)
[](https://crates.io/crates/pagetop-seaorm)
[](https://crates.io/crates/pagetop-seaorm)
@@ -17,10 +17,11 @@ exportar sus funcionalidades, y también integra en código una versión adaptad
permitir migraciones independientes para cada paquete del proyecto.
-# 📦 Sobre PageTop
+# 📌 Sobre PageTop
-[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
-sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
+[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
+clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
+modulares, extensibles y configurables.
# 🚧 Advertencia
diff --git a/packages/pagetop-seaorm/src/config.rs b/packages/pagetop-seaorm/src/config.rs
index 4d9b3a74..27c052e4 100644
--- a/packages/pagetop-seaorm/src/config.rs
+++ b/packages/pagetop-seaorm/src/config.rs
@@ -1,4 +1,4 @@
-//! Configuration settings for the SeaORM PageTop package.
+//! Opciones de configuración del paquete.
//!
//! Example:
//!
diff --git a/packages/pagetop-seaorm/src/lib.rs b/packages/pagetop-seaorm/src/lib.rs
index 8a9f3dac..59c5a7f5 100644
--- a/packages/pagetop-seaorm/src/lib.rs
+++ b/packages/pagetop-seaorm/src/lib.rs
@@ -1,3 +1,22 @@
+//!
+//!
+//!
PageTop SeaORM
+//!
+//!
Integra SeaORM para trabajar con bases de datos en aplicaciones PageTop.
+//!
+//! [](#-license)
+//! [](https://docs.rs/pagetop-seaorm)
+//! [](https://crates.io/crates/pagetop-seaorm)
+//! [](https://crates.io/crates/pagetop-seaorm)
+//!
+//!
+//!
+//! # 📌 Sobre PageTop
+//!
+//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
+//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
+//! soluciones web modulares, extensibles y configurables.
+
use pagetop::prelude::*;
use std::sync::LazyLock;
@@ -5,7 +24,7 @@ use std::sync::LazyLock;
pub mod config;
pub mod db;
-/// The package Prelude.
+/// *Prelude* del paquete.
pub mod prelude {
pub use crate::db;
pub use crate::install_migrations;
@@ -13,7 +32,7 @@ pub mod prelude {
include_locales!(LOCALES_SEAORM);
-/// Implements [`PackageTrait`] and specific package API.
+/// Implementa [`PackageTrait`] y API específica.
pub struct SeaORM;
impl PackageTrait for SeaORM {
diff --git a/pagetop/src/config.rs b/pagetop/src/config.rs
index 99e1c60d..65ce6e1c 100644
--- a/pagetop/src/config.rs
+++ b/pagetop/src/config.rs
@@ -1,4 +1,4 @@
-//! Carga los ajustes de configuración.
+//! Carga las opciones de configuración.
//!
//! These settings are loaded from [TOML](https://toml.io) files as `key = value` pairs and mapped
//! into type-safe structures with predefined values.
diff --git a/pagetop/src/global.rs b/pagetop/src/global.rs
index 4c8fed28..f03fe363 100644
--- a/pagetop/src/global.rs
+++ b/pagetop/src/global.rs
@@ -1,4 +1,4 @@
-//! Ajustes globales de `PageTop`.
+//! Opciones globales de configuración de `PageTop`.
use crate::include_config;
diff --git a/pagetop/src/lib.rs b/pagetop/src/lib.rs
index 120f1a49..c65c68d6 100644
--- a/pagetop/src/lib.rs
+++ b/pagetop/src/lib.rs
@@ -14,7 +14,7 @@
//!
//!
//!
-//! `PageTop` reivindica la sencillez de la web clásica utilizando SSR (*renderizado en el
+//! `PageTop` reivindica la sencillez de la web clásica combinando SSR (*renderizado en el
//! servidor*), HTML, CSS y JavaScript. Proporciona un conjunto completo de funcionalidades que
//! pueden extenderse y adaptarse a las necesidades de cada solución web implementando:
//!
@@ -28,7 +28,7 @@
//! * **Paquetes** (*packages*). Extienden o personalizan funcionalidades existentes interactuando
//! con las APIs de `PageTop` o de paquetes de terceros.
//!
-//! # ⚡️ Inicio rápido
+//! # ⚡️ Guía rápida
//!
//! La aplicación más sencilla de `PageTop` se ve así:
//!
@@ -96,9 +96,9 @@ pub type Weight = i8;
// Funciones y macros útiles.
pub mod util;
-// Carga los ajustes de configuración.
+// Carga las opciones de configuración.
pub mod config;
-// Ajustes globales.
+// Opciones de configuración globales.
pub mod global;
// Gestión de trazas y registro de eventos de la aplicación.
pub mod trace;