WIP: Preparando liberación de la versión 0.5 de PageTop #10

Draft
manuelcillero wants to merge 48 commits from preparing-release-zero-five into main
4 changed files with 16 additions and 18 deletions
Showing only changes of commit 6203a02b89 - Show all commits

View file

@ -85,7 +85,7 @@ pub fn html(input: TokenStream) -> TokenStream {
/// b: 0,
/// c: Some(0),
/// d: vec![1, 2, 3],
/// e: "four".to_owned(),
/// e: "four".to_string(),
/// });
/// # }
/// ```

View file

@ -8,17 +8,15 @@ use crate::{util, AutoDefault, CowStr, Weight};
/// Los distintos modos de carga permiten optimizar el rendimiento y controlar el comportamiento del
/// script en relación con el análisis del documento HTML y la ejecución del resto de scripts.
///
/// - [`From`] - Carga estándar con la etiqueta `<script src="...">`.
/// - [`Defer`] - Igual que [`From`], pero con el atributo `defer`, descarga en paralelo y se
/// ejecuta tras el análisis del documento HTML, respetando el orden de
/// aparición.
/// - [`Async`] - Igual que [`From`], pero con el atributo `async`, descarga en paralelo y se
/// ejecuta en cuanto esté listo, **sin garantizar** el orden relativo respecto
/// a otros scripts.
/// - [`Inline`] - Inserta el código directamente en la etiqueta `<script>`.
/// - [`OnLoad`] - Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
/// - [`From`] - Carga estándar con la etiqueta `<script src="...">`.
/// - [`Defer`] - Igual que [`From`], pero con el atributo `defer`, descarga en paralelo y se
/// ejecuta tras el análisis del documento HTML, respetando el orden de aparición.
/// - [`Async`] - Igual que [`From`], pero con el atributo `async`, descarga en paralelo y se
/// ejecuta en cuanto esté listo, **sin garantizar** el orden relativo respecto a otros scripts.
/// - [`Inline`] - Inserta el código directamente en la etiqueta `<script>`.
/// - [`OnLoad`] - Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
/// - [`OnLoadAsync`] - Igual que [`OnLoad`], pero con manejador asíncrono (`async`), útil si dentro
/// del código JavaScript se utiliza `await`.
/// del código JavaScript se utiliza `await`.
#[derive(AutoDefault)]
enum Source {
#[default]

View file

@ -8,8 +8,8 @@ use crate::{util, AutoDefault, CowStr, Weight};
/// Los estilos pueden cargarse desde un archivo externo o estar embebidos directamente en una
/// etiqueta `<style>`.
///
/// - [`From`] - Carga la hoja de estilos desde un archivo externo, insertándola mediante una
/// etiqueta `<link>` con `rel="stylesheet"`.
/// - [`From`] - Carga la hoja de estilos desde un archivo externo, insertándola mediante una
/// etiqueta `<link>` con `rel="stylesheet"`.
/// - [`Inline`] - Inserta directamente el contenido CSS dentro de una etiqueta `<style>`.
#[derive(AutoDefault)]
enum Source {

View file

@ -7,7 +7,7 @@ use std::str::FromStr;
/// Representa una **unidad CSS** lista para formatear o deserializar.
///
/// ## Unidades soportadas
/// # Unidades soportadas
///
/// - **Absolutas** *(valores enteros, `isize`)*:
/// - `Cm(isize)` - `cm` (centímetros)
@ -24,13 +24,13 @@ use std::str::FromStr;
/// - `RelVh(f32)` - `vh` (1% de la **altura** del viewport)
/// - `RelVw(f32)` - `vw` (1% del **ancho** del viewport)
///
/// ## Valores especiales
/// # Valores especiales
///
/// - `None` - equivale a un texto vacío (`""`), útil para atributos opcionales.
/// - `Auto` - equivale a `"auto"`.
/// - `Zero` - equivale a `"0"` (cero sin unidad).
///
/// ## Características
/// # Características
///
/// - Soporta unidades **absolutas** (`cm`, `in`, `mm`, `pc`, `pt`, `px`) y **relativas** (`em`,
/// `rem`, `%`, `vh`, `vw`).
@ -38,7 +38,7 @@ use std::str::FromStr;
/// - `Display` para formatear a cadena (p. ej., `UnitValue::Px(12)` genera `"12px"`).
/// - `Deserialize` delega en `FromStr`, garantizando una gramática única.
///
/// ## Ejemplos
/// # Ejemplos
///
/// ```rust
/// # use pagetop::prelude::*;
@ -52,7 +52,7 @@ use std::str::FromStr;
/// assert_eq!(UnitValue::from_str("0").unwrap(), UnitValue::Zero);
/// ```
///
/// ## Notas
/// # Notas
///
/// - Las absolutas **no aceptan** decimales (p. ej., `"1.5px"` sería erróneo).
/// - Se aceptan signos `+`/`-` en todas las unidades (p. ej., `"-12px"`, `"+0.5em"`).