diff --git a/CREDITS.md b/CREDITS.md index f5c1b0f..c5a7bd2 100644 --- a/CREDITS.md +++ b/CREDITS.md @@ -1,8 +1,7 @@ # 馃攦 Dependencias -`PageTop` est谩 basado en [Rust](https://www.rust-lang.org/) y crece a hombros de gigantes -aprovechando algunas de las librer铆as m谩s robustas y populares del [ecosistema Rust](https://lib.rs) -como son: +PageTop est谩 basado en [Rust](https://www.rust-lang.org/) y crece a hombros de gigantes aprovechando +algunas de las librer铆as m谩s robustas y populares del [ecosistema Rust](https://lib.rs) como son: * [Actix Web](https://actix.rs/) para los servicios web. * [Config](https://docs.rs/config) para cargar y procesar las opciones de configuraci贸n. @@ -11,14 +10,14 @@ como son: * [Fluent templates](https://github.com/XAMPPRocky/fluent-templates), que integra [Fluent](https://projectfluent.org/) para internacionalizar las aplicaciones. * Adem谩s de otros *crates* adicionales que se pueden explorar en los archivos `Cargo.toml` de - `PageTop` y sus extensiones. + PageTop y sus extensiones. # 馃棜 FIGfonts -`PageTop` usa el *crate* [figlet-rs](https://crates.io/crates/figlet-rs) desarrollado por -*yuanbohan* para mostrar un banner de presentaci贸n en el terminal con el nombre de la aplicaci贸n en -caracteres [FIGlet](http://www.figlet.org). Las fuentes incluidas en `pagetop/src/app` son: +PageTop usa el *crate* [figlet-rs](https://crates.io/crates/figlet-rs) desarrollado por *yuanbohan* +para mostrar un banner de presentaci贸n en el terminal con el nombre de la aplicaci贸n en caracteres +[FIGlet](http://www.figlet.org). Las fuentes incluidas en `pagetop/src/app` son: * [slant.flf](http://www.figlet.org/fontdb_example.cgi?font=slant.flf) de *Glenn Chappell* * [small.flf](http://www.figlet.org/fontdb_example.cgi?font=small.flf) de *Glenn Chappell* diff --git a/README.md b/README.md index e7fab94..9d5efc8 100644 --- a/README.md +++ b/README.md @@ -14,8 +14,8 @@
-`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. +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: @@ -24,14 +24,14 @@ seg煤n las necesidades de cada proyecto, incluyendo: * **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. + 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铆: +La aplicaci贸n m谩s sencilla de PageTop se ve as铆: ```rust,no_run use pagetop::prelude::*; @@ -42,10 +42,10 @@ async fn main() -> std::io::Result<()> { } ``` -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`. +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: +Para personalizar el servicio, se puede crear una extensi贸n de PageTop de la siguiente manera: ```rust,no_run use pagetop::prelude::*; @@ -86,15 +86,15 @@ El c贸digo se organiza en un *workspace* donde actualmente se incluyen los sigui * **[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 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)**, 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. + 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`. + proporciona una colecci贸n de macros que mejoran la experiencia de desarrollo con PageTop. # 馃И Pruebas @@ -116,7 +116,7 @@ Para simplificar el flujo de trabajo, el repositorio incluye varios **alias de C # 馃毀 Advertencia -`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su +**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su ecosistema. Su API est谩 sujeta a cambios frecuentes. No se recomienda su uso en producci贸n, al menos hasta que se libere la versi贸n **1.0.0**. diff --git a/helpers/pagetop-build/README.md b/helpers/pagetop-build/README.md index 80d6bba..57273e8 100644 --- a/helpers/pagetop-build/README.md +++ b/helpers/pagetop-build/README.md @@ -113,7 +113,7 @@ impl Extension for MyExtension { # 馃毀 Advertencia -`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su +**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su ecosistema. Su API est谩 sujeta a cambios frecuentes. No se recomienda su uso en producci贸n, al menos hasta que se libere la versi贸n **1.0.0**. diff --git a/helpers/pagetop-macros/README.md b/helpers/pagetop-macros/README.md index e58d24c..7c9c2e8 100644 --- a/helpers/pagetop-macros/README.md +++ b/helpers/pagetop-macros/README.md @@ -26,12 +26,12 @@ Esta librer铆a incluye entre sus macros una adaptaci贸n 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`. +cada proyecto PageTop. # 馃毀 Advertencia -`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su +**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su ecosistema. Su API est谩 sujeta a cambios frecuentes. No se recomienda su uso en producci贸n, al menos hasta que se libere la versi贸n **1.0.0**. diff --git a/helpers/pagetop-macros/src/lib.rs b/helpers/pagetop-macros/src/lib.rs index 6421ca6..b462ea1 100644 --- a/helpers/pagetop-macros/src/lib.rs +++ b/helpers/pagetop-macros/src/lib.rs @@ -27,7 +27,7 @@ Esta librer铆a incluye entre sus macros una adaptaci贸n 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`. +cada proyecto PageTop. */ #![doc( @@ -219,7 +219,7 @@ pub fn builder_fn(_: TokenStream, item: TokenStream) -> TokenStream { expanded.into() } -/// Define una funci贸n `main` as铆ncrona como punto de entrada de `PageTop`. +/// Define una funci贸n `main` as铆ncrona como punto de entrada de PageTop. /// /// # Ejemplo /// @@ -240,7 +240,7 @@ pub fn main(_: TokenStream, item: TokenStream) -> TokenStream { output } -/// Define funciones de prueba as铆ncronas para usar con `PageTop`. +/// Define funciones de prueba as铆ncronas para usar con PageTop. /// /// # Ejemplo /// diff --git a/helpers/pagetop-statics/README.md b/helpers/pagetop-statics/README.md index 92999c0..4168cd4 100644 --- a/helpers/pagetop-statics/README.md +++ b/helpers/pagetop-statics/README.md @@ -16,7 +16,7 @@ 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 +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. @@ -28,13 +28,13 @@ Para ello, adapta el c贸digo de los *crates* [static-files](https://crates.io/cr [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 +Estas implementaciones se integran en PageTop para evitar que cada proyecto tenga que declarar `static-files` manualmente como dependencia en su `Cargo.toml`. # 馃毀 Advertencia -`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su +**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su ecosistema. Su API est谩 sujeta a cambios frecuentes. No se recomienda su uso en producci贸n, al menos hasta que se libere la versi贸n **1.0.0**. diff --git a/helpers/pagetop-statics/src/lib.rs b/helpers/pagetop-statics/src/lib.rs index dab50d9..201d90e 100644 --- a/helpers/pagetop-statics/src/lib.rs +++ b/helpers/pagetop-statics/src/lib.rs @@ -17,7 +17,7 @@ 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 +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. @@ -29,7 +29,7 @@ Para ello, adapta el c贸digo de los *crates* [static-files](https://crates.io/cr [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 +Estas implementaciones se integran en PageTop para evitar que cada proyecto tenga que declarar `static-files` manualmente como dependencia en su `Cargo.toml`. */ diff --git a/src/app.rs b/src/app.rs index 400b0cd..94d901f 100644 --- a/src/app.rs +++ b/src/app.rs @@ -1,4 +1,4 @@ -//! Prepara y ejecuta una aplicaci贸n creada con `Pagetop`. +//! Prepara y ejecuta una aplicaci贸n creada con PageTop. mod figfont; @@ -17,7 +17,7 @@ use substring::Substring; use std::io::Error; use std::sync::LazyLock; -/// Punto de entrada de una aplicaci贸n `PageTop`. +/// Punto de entrada de una aplicaci贸n PageTop. /// /// No almacena datos, **encapsula** el inicio completo de configuraci贸n y puesta en marcha. Para /// instanciarla se puede usar [`new()`](Application::new) o [`prepare()`](Application::prepare). diff --git a/src/base/action.rs b/src/base/action.rs index be35e92..977ae9e 100644 --- a/src/base/action.rs +++ b/src/base/action.rs @@ -1,4 +1,4 @@ -//! Acciones predefinidas para alterar el funcionamiento interno de `PageTop`. +//! Acciones predefinidas para alterar el funcionamiento interno de PageTop. use crate::prelude::*; diff --git a/src/base/component.rs b/src/base/component.rs index 1bb160b..30cb686 100644 --- a/src/base/component.rs +++ b/src/base/component.rs @@ -1,4 +1,4 @@ -//! Componentes nativos proporcionados por `PageTop`. +//! Componentes nativos proporcionados por PageTop. mod html; pub use html::Html; diff --git a/src/base/extension.rs b/src/base/extension.rs index 49e408d..1f94fe2 100644 --- a/src/base/extension.rs +++ b/src/base/extension.rs @@ -1,4 +1,4 @@ -//! Extensiones para funcionalidades avanzadas de `PageTop`. +//! Extensiones para funcionalidades avanzadas de PageTop. mod welcome; pub use welcome::Welcome; diff --git a/src/base/extension/welcome.rs b/src/base/extension/welcome.rs index f768210..0252cff 100644 --- a/src/base/extension/welcome.rs +++ b/src/base/extension/welcome.rs @@ -1,6 +1,6 @@ use crate::prelude::*; -/// P谩gina de bienvenida predeterminada de `PageTop`. +/// P谩gina de bienvenida predeterminada de PageTop. /// /// Esta extensi贸n se instala por defecto y muestra una p谩gina en la ruta ra铆z (`/`) cuando no se ha /// configurado ninguna p谩gina de inicio personalizada. Permite confirmar que el servidor est谩 diff --git a/src/base/theme.rs b/src/base/theme.rs index ea9eeb6..40129bf 100644 --- a/src/base/theme.rs +++ b/src/base/theme.rs @@ -1,4 +1,4 @@ -//! Temas b谩sicos soportados por `PageTop`. +//! Temas b谩sicos soportados por PageTop. mod basic; pub use basic::Basic; diff --git a/src/base/theme/basic.rs b/src/base/theme/basic.rs index bc380ac..961864b 100644 --- a/src/base/theme/basic.rs +++ b/src/base/theme/basic.rs @@ -1,4 +1,4 @@ -//! Es el tema b谩sico que incluye `PageTop` por defecto. +//! Es el tema b谩sico que incluye PageTop por defecto. use crate::prelude::*; diff --git a/src/config.rs b/src/config.rs index 27cf630..f2fb9f7 100644 --- a/src/config.rs +++ b/src/config.rs @@ -3,7 +3,7 @@ //! Estos ajustes se obtienen de archivos [TOML](https://toml.io) como pares `clave = valor` que se //! mapean a estructuras **fuertemente tipadas** y valores predefinidos. //! -//! Siguiendo la metodolog铆a [Twelve-Factor App](https://12factor.net/config), `PageTop` separa el +//! Siguiendo la metodolog铆a [Twelve-Factor App](https://12factor.net/config), PageTop separa el //! **c贸digo** de la **configuraci贸n**, lo que permite tener configuraciones diferentes para cada //! despliegue, como *dev*, *staging* o *production*, sin modificar el c贸digo fuente. //! @@ -13,14 +13,14 @@ //! Si tu aplicaci贸n necesita archivos de configuraci贸n, crea un directorio `config` en la ra铆z del //! proyecto, al mismo nivel que el archivo *Cargo.toml* o que el binario de la aplicaci贸n. //! -//! `PageTop` carga en este orden, y siempre de forma opcional, los siguientes archivos TOML: +//! PageTop carga en este orden, y siempre de forma opcional, los siguientes archivos TOML: //! //! 1. **config/common.toml**, para ajustes comunes a todos los entornos. Este enfoque simplifica el //! mantenimiento al centralizar los valores de configuraci贸n comunes. //! //! 2. **config/{rm}.toml**, donde `{rm}` es el valor de la variable de entorno `PAGETOP_RUN_MODE`: //! -//! * Si `PAGETOP_RUN_MODE` no est谩 definida, se asume el valor `default`, y `PageTop` intentar谩 +//! * Si `PAGETOP_RUN_MODE` no est谩 definida, se asume el valor `default`, y PageTop intentar谩 //! cargar *config/default.toml* si el archivo existe. //! //! * 脷til para definir configuraciones espec铆ficas por entorno, garantizando que cada uno (p.ej. diff --git a/src/core.rs b/src/core.rs index 0c8aa21..79d9207 100644 --- a/src/core.rs +++ b/src/core.rs @@ -117,7 +117,7 @@ impl TypeInfo { /// /// Este *trait* se implementa autom谩ticamente para **todos** los tipos que implementen [`Any`], de /// modo que basta con traer [`AnyInfo`] al 谩mbito (`use crate::AnyInfo;`) para disponer de estos -/// m茅todos adicionales, o usar el [`prelude`](crate::prelude) de `PageTop`. +/// m茅todos adicionales, o usar el [`prelude`](crate::prelude) de PageTop. /// /// # Ejemplo /// diff --git a/src/core/component/definition.rs b/src/core/component/definition.rs index e9a792d..c43dfb0 100644 --- a/src/core/component/definition.rs +++ b/src/core/component/definition.rs @@ -11,7 +11,7 @@ pub trait ComponentRender { fn render(&mut self, cx: &mut Context) -> Markup; } -/// Interfaz com煤n que debe implementar un componente renderizable en `PageTop`. +/// Interfaz com煤n que debe implementar un componente renderizable en PageTop. /// /// Se recomienda que los componentes deriven [`AutoDefault`](crate::AutoDefault). Tambi茅n deben /// implementar expl铆citamente el m茅todo [`new()`](Self::new) y pueden sobrescribir los otros diff --git a/src/core/extension.rs b/src/core/extension.rs index cabae5c..6ae6d33 100644 --- a/src/core/extension.rs +++ b/src/core/extension.rs @@ -1,6 +1,6 @@ //! API para a帽adir nuevas funcionalidades usando extensiones. //! -//! Cada funcionalidad adicional que quiera incorporarse a una aplicaci贸n `PageTop` se debe modelar +//! Cada funcionalidad adicional que quiera incorporarse a una aplicaci贸n PageTop se debe modelar //! como una **extensi贸n**. Todas comparten la misma interfaz declarada en [`Extension`]. mod definition; diff --git a/src/core/extension/definition.rs b/src/core/extension/definition.rs index 6df7042..90bdbad 100644 --- a/src/core/extension/definition.rs +++ b/src/core/extension/definition.rs @@ -10,7 +10,7 @@ use crate::{actions_boxed, service}; /// cualquier hilo de la ejecuci贸n sin necesidad de sincronizaci贸n adicional. pub type ExtensionRef = &'static dyn Extension; -/// Interfaz com煤n que debe implementar cualquier extensi贸n de `PageTop`. +/// Interfaz com煤n que debe implementar cualquier extensi贸n de PageTop. /// /// Este *trait* es f谩cil de implementar, basta con declarar una estructura de tama帽o cero para la /// extensi贸n y sobreescribir los m茅todos que sea necesario. @@ -63,7 +63,7 @@ pub trait Extension: AnyInfo + Send + Sync { /// Otras extensiones que deben habilitarse **antes** de esta. /// - /// `PageTop` las resolver谩 autom谩ticamente respetando el orden durante el arranque de la + /// PageTop las resolver谩 autom谩ticamente respetando el orden durante el arranque de la /// aplicaci贸n. fn dependencies(&self) -> Vec { vec![] diff --git a/src/core/theme.rs b/src/core/theme.rs index aa526f1..e0c3008 100644 --- a/src/core/theme.rs +++ b/src/core/theme.rs @@ -1,6 +1,6 @@ //! API para a帽adir y gestionar nuevos temas. //! -//! En `PageTop` un tema es la *piel* de la aplicaci贸n, decide c贸mo se muestra cada documento HTML, +//! En PageTop un tema es la *piel* de la aplicaci贸n, decide c贸mo se muestra cada documento HTML, //! especialmente las p谩ginas de contenido ([`Page`](crate::response::page::Page)), sin alterar la //! l贸gica interna de sus componentes. //! diff --git a/src/global.rs b/src/global.rs index 8a03589..6be0774 100644 --- a/src/global.rs +++ b/src/global.rs @@ -68,7 +68,7 @@ pub struct App { #[derive(Debug, Deserialize)] /// Secci贸n `[Dev]` de la configuraci贸n. Forma parte de [`Settings`]. pub struct Dev { - /// Directorio desde el que servir los archivos est谩ticos de `PageTop`. + /// Directorio desde el que servir los archivos est谩ticos de PageTop. /// /// Por defecto, los archivos se integran en el binario de la aplicaci贸n. Si aqu铆 se indica una /// ruta v谩lida, ya sea absoluta o relativa al directorio del proyecto o del binario en diff --git a/src/lib.rs b/src/lib.rs index 90ea462..e43da2f 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -15,8 +15,8 @@
-`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. +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: @@ -25,14 +25,14 @@ seg煤n las necesidades de cada proyecto, incluyendo: * **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. + 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铆: +La aplicaci贸n m谩s sencilla de PageTop se ve as铆: ```rust,no_run use pagetop::prelude::*; @@ -43,10 +43,10 @@ async fn main() -> std::io::Result<()> { } ``` -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`. +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: +Para personalizar el servicio, se puede crear una extensi贸n de PageTop de la siguiente manera: ```rust,no_run use pagetop::prelude::*; @@ -77,11 +77,11 @@ Este programa implementa una extensi贸n llamada `HelloWorld` que sirve una p谩gi # 馃З Gesti贸n de Dependencias -Los proyectos que utilizan `PageTop` gestionan las dependencias con `cargo`, como cualquier otro +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 +[dependencias](core::extension::Extension::dependencies), si las tiene, para que PageTop pueda estructurar e inicializar la aplicaci贸n de forma modular. */ diff --git a/src/locale.rs b/src/locale.rs index f23f51e..43612bd 100644 --- a/src/locale.rs +++ b/src/locale.rs @@ -1,6 +1,6 @@ //! Localizaci贸n (L10n). //! -//! `PageTop` utiliza las especificaciones de [Fluent](https://www.projectfluent.org/) para la +//! PageTop utiliza las especificaciones de [Fluent](https://www.projectfluent.org/) para la //! localizaci贸n de aplicaciones, y aprovecha [fluent-templates](https://docs.rs/fluent-templates/) //! para integrar los recursos de traducci贸n directamente en el binario de la aplicaci贸n. //! @@ -87,7 +87,7 @@ //! include_locales!(LOCALES_SAMPLE from "ruta/a/las/traducciones"); //! ``` //! -//! Y *voil脿*, s贸lo queda operar con los idiomas soportados por `PageTop` usando [`LangMatch`] y +//! Y *voil脿*, s贸lo queda operar con los idiomas soportados por PageTop usando [`LangMatch`] y //! traducir textos con [`L10n`]. use crate::html::{Markup, PreEscaped}; @@ -141,10 +141,10 @@ pub trait LangId { fn langid(&self) -> &'static LanguageIdentifier; } -/// Operaciones con los idiomas soportados por `PageTop`. +/// Operaciones con los idiomas soportados por PageTop. /// /// Utiliza [`LangMatch`] para transformar un identificador de idioma en un [`LanguageIdentifier`] -/// soportado por `PageTop`. +/// soportado por PageTop. /// /// # Ejemplos /// @@ -183,11 +183,11 @@ pub trait LangId { pub enum LangMatch { /// Cuando el identificador de idioma es una cadena vac铆a. Unspecified, - /// Si encuentra un [`LanguageIdentifier`] en la lista de idiomas soportados por `PageTop` que + /// Si encuentra un [`LanguageIdentifier`] en la lista de idiomas soportados por PageTop que /// coincide exactamente con el identificador de idioma (p.ej. "es-ES"), o con el identificador /// del idioma base (p.ej. "es"). Found(&'static LanguageIdentifier), - /// Si el identificador de idioma no est谩 entre los soportados por `PageTop`. + /// Si el identificador de idioma no est谩 entre los soportados por PageTop. Unsupported(String), } @@ -319,7 +319,7 @@ enum L10nOp { /// Cada instancia puede representar: /// /// - Un texto puro (`n()`) que no requiere traducci贸n. -/// - Una clave para traducir un texto de las traducciones predefinidas de `PageTop` (`l()`). +/// - Una clave para traducir un texto de las traducciones predefinidas de PageTop (`l()`). /// - Una clave para traducir de un conjunto concreto de traducciones (`t()`). /// /// # Ejemplo diff --git a/src/prelude.rs b/src/prelude.rs index 9072dec..484e53c 100644 --- a/src/prelude.rs +++ b/src/prelude.rs @@ -1,4 +1,4 @@ -//! *Prelude* de `PageTop`. +//! *Prelude* de PageTop. // RE-EXPORTED. diff --git a/src/trace.rs b/src/trace.rs index c57c6a3..12e428a 100644 --- a/src/trace.rs +++ b/src/trace.rs @@ -1,13 +1,13 @@ //! Gesti贸n de trazas y registro de eventos de la aplicaci贸n. //! -//! `PageTop` recopila informaci贸n de diagn贸stico de la aplicaci贸n de forma estructurada y basada en +//! PageTop recopila informaci贸n de diagn贸stico de la aplicaci贸n de forma estructurada y basada en //! eventos. //! //! En los sistemas as铆ncronos, interpretar los mensajes de log tradicionales suele volverse //! complicado. Las tareas individuales se multiplexan en el mismo hilo y los eventos y registros //! asociados se entremezclan, lo que dificulta seguir la secuencia l贸gica. //! -//! `PageTop` usa [`tracing`](https://docs.rs/tracing) para registrar eventos estructurados y con +//! PageTop usa [`tracing`](https://docs.rs/tracing) para registrar eventos estructurados y con //! informaci贸n adicional sobre la *temporalidad* y la *causalidad*. A diferencia de un mensaje de //! log, un *span* (intervalo) tiene un momento de inicio y de fin, puede entrar y salir del flujo //! de ejecuci贸n y puede existir dentro de un 谩rbol anidado de *spans* similares. Adem谩s, estos