diff --git a/src/core.rs b/src/core.rs index 5aebd1f..4541fae 100644 --- a/src/core.rs +++ b/src/core.rs @@ -201,5 +201,5 @@ pub trait AnyCast: AnyInfo { /// Implementación automática para cualquier tipo que ya cumpla [`AnyInfo`]. impl AnyCast for T {} -// Infraestructura para ampliar funcionalidades mediante extensiones. +// API para añadir nuevas funcionalidades usando extensiones. pub mod extension; diff --git a/src/core/extension.rs b/src/core/extension.rs index 9eb3bd2..c493cf5 100644 --- a/src/core/extension.rs +++ b/src/core/extension.rs @@ -1,4 +1,4 @@ -//! Infraestructura para ampliar funcionalidades mediante extensiones. +//! API para añadir nuevas funcionalidades usando extensiones. //! //! 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 [`ExtensionTrait`]. diff --git a/src/core/extension/definition.rs b/src/core/extension/definition.rs index 761fcee..625beba 100644 --- a/src/core/extension/definition.rs +++ b/src/core/extension/definition.rs @@ -10,8 +10,8 @@ pub type ExtensionRef = &'static dyn ExtensionTrait; /// Interfaz común que debe implementar cualquier extensión de `PageTop`. /// -/// Este *trait* es fácil de implementar, basta con declarar la estructura de la extensión y -/// sobreescribir los métodos que sea necesario. +/// 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. /// /// ```rust /// use pagetop::prelude::*; diff --git a/src/lib.rs b/src/lib.rs index f312621..edc791c 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -29,7 +29,6 @@ //! ``` #![cfg_attr(docsrs, feature(doc_cfg))] - #![doc( html_favicon_url = "https://git.cillero.es/manuelcillero/pagetop/raw/branch/main/static/favicon.ico" )] diff --git a/src/locale.rs b/src/locale.rs index ab1f5ef..2dcf27e 100644 --- a/src/locale.rs +++ b/src/locale.rs @@ -107,8 +107,8 @@ use std::sync::LazyLock; use std::fmt; -// Asocia cada código de idioma (como "en-US") con su respectivo [`LanguageIdentifier`] y la clave -// en *locale/.../languages.ftl* para obtener el nombre del idioma según la localización. +// Asocia cada identificador de idioma (como "en-US") con su respectivo [`LanguageIdentifier`] y la +// clave en *locale/.../languages.ftl* para obtener el nombre del idioma según la localización. static LANGUAGES: LazyLock> = LazyLock::new(|| { hm![ "en" => ( langid!("en-US"), "english" ), @@ -121,20 +121,20 @@ static LANGUAGES: LazyLock> = LazyLock // Identificador del idioma de **respaldo** (predefinido a `en-US`). // -// Se usa cuando el valor del código de idioma en las traducciones no corresponde con ningún idioma -// soportado por la aplicación. +// Se usa cuando el valor del identificador de idioma en las traducciones no corresponde con ningún +// idioma soportado por la aplicación. static FALLBACK_LANGID: LazyLock = LazyLock::new(|| langid!("en-US")); // Identificador del idioma **por defecto** para la aplicación. // -// Se resuelve a partir de [`global::SETTINGS.app.language`](global::SETTINGS). Si el código de -// idioma configurado no es válido o no está disponible entonces resuelve como [`FALLBACK_LANGID`]. +// Se resuelve a partir de [`global::SETTINGS.app.language`](global::SETTINGS). Si el identificador +// de idioma no es válido o no está disponible entonces resuelve como [`FALLBACK_LANGID`]. pub(crate) static DEFAULT_LANGID: LazyLock<&LanguageIdentifier> = LazyLock::new(|| LangMatch::langid_or_fallback(&global::SETTINGS.app.language)); /// Operaciones con los idiomas soportados por `PageTop`. /// -/// Utiliza [`LangMatch`] para transformar un código de idioma en un [`LanguageIdentifier`] +/// Utiliza [`LangMatch`] para transformar un identificador de idioma en un [`LanguageIdentifier`] /// soportado por `PageTop`. /// /// # Ejemplos @@ -156,10 +156,10 @@ pub(crate) static DEFAULT_LANGID: LazyLock<&LanguageIdentifier> = /// /// // Idioma no soportado. /// let lang = LangMatch::resolve("ja-JP"); -/// assert_eq!(lang, LangMatch::Unsupported("ja-JP".to_string())); +/// assert_eq!(lang, LangMatch::Unsupported(String::from("ja-JP"))); /// ``` /// -/// Las siguientes instrucciones devuelven siempre un [`LanguageIdentifier`] válido, ya sea porque +/// Las siguientes líneas devuelven siempre un [`LanguageIdentifier`] válido, ya sea porque /// resuelven un idioma soportado o porque aplican el idioma por defecto o de respaldo: /// /// ```rust @@ -177,13 +177,13 @@ pub(crate) static DEFAULT_LANGID: LazyLock<&LanguageIdentifier> = /// ``` #[derive(Clone, Debug, Eq, PartialEq)] pub enum LangMatch { - /// Cuando el código del idioma es una cadena vacía. + /// Cuando el identificador del idioma es una cadena vacía. Unspecified, /// Si encuentra un [`LanguageIdentifier`] en la lista de idiomas soportados por `PageTop` que - /// coincide exactamente con el código del idioma (p.ej. "es-ES"), o con el código del idioma - /// base (p.ej. "es"). + /// coincide exactamente con el identificador del idioma (p.ej. "es-ES"), o con el identificador + /// del idioma base (p.ej. "es"). Found(&'static LanguageIdentifier), - /// Si el código del idioma no está entre los soportados por `PageTop`. + /// Si el identificador del idioma no está entre los soportados por `PageTop`. Unsupported(String), } @@ -210,7 +210,7 @@ impl LangMatch { } // En otro caso indica que el idioma no está soportado. - Self::Unsupported(language.to_string()) + Self::Unsupported(String::from(language)) } /// Devuelve el idioma de la variante de la instancia, o el idioma por defecto si no está @@ -319,7 +319,7 @@ enum L10nOp { /// También para traducciones a idiomas concretos. /// /// ```rust,ignore -/// // Traducción con clave, conjunto de traducciones y código de idioma a usar. +/// // Traducción con clave, conjunto de traducciones e identificador de idioma a usar. /// let bye = L10n::t("goodbye", &LOCALES_CUSTOM).using(LangMatch::langid_or_default("it")); /// ``` #[derive(AutoDefault)]