🌐 Normaliza textos y localización a *snake_case*

src/core/extension/definition.rs

@@ -24,7 +24,7 @@ use crate::{actions_boxed, service};
 /// }
 /// ```
 pub trait Extension: AnyInfo + Send + Sync {
-    /// Nombre localizado de la extensión legible para el usuario.
+    /// Nombre de la extensión como *texto localizado* legible para el usuario.
     ///
     /// Predeterminado por el [`short_name()`](AnyInfo::short_name) del tipo asociado a la
     /// extensión.
@@ -32,7 +32,7 @@ pub trait Extension: AnyInfo + Send + Sync {
         L10n::n(self.short_name())
     }
 
-    /// Descripción corta localizada de la extensión para paneles, listados, etc.
+    /// Descripción corta de la extensión como *texto localizado* para paneles, listados, etc.
     ///
     /// Por defecto devuelve un valor vacío (`L10n::default()`).
     fn description(&self) -> L10n {

src/core/theme.rs

@@ -55,7 +55,7 @@ pub trait Region {
     /// las clases del contenedor de la región (`"region region-<name>"`).
     fn name(&self) -> &'static str;
 
-    /// Devuelve la etiqueta de accesibilidad localizada asociada a la región.
+    /// Devuelve un *texto localizado* como etiqueta de accesibilidad asociada a la región.
     ///
     /// En la implementación predeterminada de [`Self::render()`], este valor se usa como
     /// `aria-label` del contenedor de la región.
@@ -64,8 +64,8 @@ pub trait Region {
     /// Renderiza el contenedor de la región.
     ///
     /// Por defecto, recupera del [`Context`] el contenido de la región y, si no está vacío, lo
-    /// envuelve en un `<div>` con clases `"region region-<name>"` y un `aria-label` basado en la
-    /// etiqueta localizada de la región:
+    /// envuelve en un `<div>` con clases `"region region-<name>"` y un `aria-label` basado en el
+    /// *texto localizado* de la etiqueta asociada a la región:
     ///
     /// ```html
     /// <div class="region region-<name>" role="region" aria-label="<label>">

src/core/theme/definition.rs

@@ -158,7 +158,7 @@ pub trait Theme: Extension + Send + Sync {
     /// Contenido predeterminado para la página de error "*403 - Forbidden*".
     ///
     /// Los temas pueden sobrescribir este método para personalizar el diseño y el contenido de la
-    /// página de error, manteniendo o no el mensaje de los textos localizados.
+    /// página de error, manteniendo o no el mensaje de los *textos localizados*.
     fn error403(&self, page: &mut Page) -> Markup {
         html! { div { h1 { (L10n::l("error403_notice").using(page)) } } }
     }
@@ -166,7 +166,7 @@ pub trait Theme: Extension + Send + Sync {
     /// Contenido predeterminado para la página de error "*404 - Not Found*".
     ///
     /// Los temas pueden sobrescribir este método para personalizar el diseño y el contenido de la
-    /// página de error, manteniendo o no el mensaje de los textos localizados.
+    /// página de error, manteniendo o no el mensaje de los *textos localizados*.
     fn error404(&self, page: &mut Page) -> Markup {
         html! { div { h1 { (L10n::l("error404_notice").using(page)) } } }
     }

src/html/attr_l10n.rs

@@ -10,7 +10,7 @@ use crate::{builder_fn, AutoDefault};
 /// ```rust
 /// # use pagetop::prelude::*;
 /// // Traducción por clave en las locales por defecto de PageTop.
-/// let hello = AttrL10n::new(L10n::l("test-hello-world"));
+/// let hello = AttrL10n::new(L10n::l("test_hello_world"));
 ///
 /// // Español disponible.
 /// assert_eq!(

src/locale.rs

@@ -310,7 +310,7 @@ enum L10nOp {
     Translate(Cow<'static, str>),
 }
 
-/// Crea instancias para traducir textos localizados.
+/// Crea instancias para traducir *textos localizados*.
 ///
 /// Cada instancia puede representar:
 ///

src/locale/en-US/test.ftl

@@ -1,6 +1,6 @@
-test-hello-world = Hello world!
-test-hello-user  = Hello, { $userName }!
-test-shared-photos =
+test_hello_world = Hello world!
+test_hello_user  = Hello, { $userName }!
+test_shared_photos =
     { $userName } { $photoCount ->
         [one] added a new photo
        *[other] added { $photoCount } new photos

src/locale/es-ES/test.ftl

@@ -1,6 +1,6 @@
-test-hello-world = ¡Hola mundo!
-test-hello-user  = ¡Hola, { $userName }!
-test-shared-photos =
+test_hello_world = ¡Hola mundo!
+test_hello_user  = ¡Hola, { $userName }!
+test_shared_photos =
     { $userName } { $photoCount ->
         [one] ha añadido una nueva foto
        *[other] ha añadido { $photoCount } nuevas fotos