🚧 Normaliza versiones a las últimas publicaciones
Revisa y completa la documentación general.
This commit is contained in:
parent
fe81ed1cd7
commit
605675af1a
10 changed files with 80 additions and 14 deletions
4
Cargo.lock
generated
4
Cargo.lock
generated
|
|
@ -1600,7 +1600,7 @@ dependencies = [
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "pagetop-build"
|
name = "pagetop-build"
|
||||||
version = "0.0.1"
|
version = "0.0.16"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"grass",
|
"grass",
|
||||||
"static-files",
|
"static-files",
|
||||||
|
|
@ -1608,7 +1608,7 @@ dependencies = [
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "pagetop-macros"
|
name = "pagetop-macros"
|
||||||
version = "0.0.5"
|
version = "0.0.18"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"proc-macro2",
|
"proc-macro2",
|
||||||
"proc-macro2-diagnostics",
|
"proc-macro2-diagnostics",
|
||||||
|
|
|
||||||
|
|
@ -3,8 +3,8 @@ name = "pagetop"
|
||||||
version = "0.0.61"
|
version = "0.0.61"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
|
|
||||||
description = """\
|
description = """
|
||||||
Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.\
|
Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.
|
||||||
"""
|
"""
|
||||||
categories = ["web-programming", "gui", "development-tools", "asynchronous"]
|
categories = ["web-programming", "gui", "development-tools", "asynchronous"]
|
||||||
keywords = ["pagetop", "web", "framework", "frontend", "ssr"]
|
keywords = ["pagetop", "web", "framework", "frontend", "ssr"]
|
||||||
|
|
|
||||||
|
|
@ -41,8 +41,8 @@ async fn main() -> std::io::Result<()> {
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Sólo con esto, este código sirve por defecto una página web de bienvenida accesible desde un
|
Este código arranca el servidor de `PageTop` que, con la configuración por defecto, muestra una
|
||||||
navegador en la dirección `http://localhost:8080` con la configuración predeterminada.
|
página de bienvenida accesible desde un navegador local en `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:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,11 +1,11 @@
|
||||||
[package]
|
[package]
|
||||||
name = "pagetop-build"
|
name = "pagetop-build"
|
||||||
version = "0.0.1"
|
version = "0.0.16"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
|
|
||||||
description = """\
|
description = """
|
||||||
Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el \
|
Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el
|
||||||
binario de un proyecto PageTop.\
|
binario de un proyecto PageTop.
|
||||||
"""
|
"""
|
||||||
categories = ["development-tools::build-utils", "web-programming"]
|
categories = ["development-tools::build-utils", "web-programming"]
|
||||||
keywords = ["pagetop", "build", "assets", "resources", "static"]
|
keywords = ["pagetop", "build", "assets", "resources", "static"]
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,9 @@
|
||||||
<p>Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto <strong>PageTop</strong>.</p>
|
<p>Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto <strong>PageTop</strong>.</p>
|
||||||
|
|
||||||
[](#-license)
|
[](#-license)
|
||||||
|
[](https://docs.rs/pagetop-build)
|
||||||
|
[](https://crates.io/crates/pagetop-build)
|
||||||
|
[](https://crates.io/crates/pagetop-build)
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,9 @@
|
||||||
//! <p>Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto <strong>PageTop</strong>.</p>
|
//! <p>Prepara un conjunto de archivos estáticos o archivos SCSS compilados para ser incluidos en el binario de un proyecto <strong>PageTop</strong>.</p>
|
||||||
//!
|
//!
|
||||||
//! [](#-license)
|
//! [](#-license)
|
||||||
|
//! [](https://docs.rs/pagetop-build)
|
||||||
|
//! [](https://crates.io/crates/pagetop-build)
|
||||||
|
//! [](https://crates.io/crates/pagetop-build)
|
||||||
//!
|
//!
|
||||||
//! </div>
|
//! </div>
|
||||||
//!
|
//!
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
[package]
|
[package]
|
||||||
name = "pagetop-macros"
|
name = "pagetop-macros"
|
||||||
version = "0.0.5"
|
version = "0.0.18"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
|
|
||||||
description = """\
|
description = """
|
||||||
Una colección de macros que mejoran la experiencia de desarrollo con PageTop.\
|
Una colección de macros que mejoran la experiencia de desarrollo con PageTop.
|
||||||
"""
|
"""
|
||||||
categories = ["development-tools::procedural-macro-helpers", "web-programming"]
|
categories = ["development-tools::procedural-macro-helpers", "web-programming"]
|
||||||
keywords = ["pagetop", "macros", "proc-macros", "codegen"]
|
keywords = ["pagetop", "macros", "proc-macros", "codegen"]
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,9 @@
|
||||||
<p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
|
<p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
|
||||||
|
|
||||||
[](#-license)
|
[](#-license)
|
||||||
|
[](https://docs.rs/pagetop-macros)
|
||||||
|
[](https://crates.io/crates/pagetop-macros)
|
||||||
|
[](https://crates.io/crates/pagetop-macros)
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,9 @@
|
||||||
//! <p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
|
//! <p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
|
||||||
//!
|
//!
|
||||||
//! [](#-license)
|
//! [](#-license)
|
||||||
|
//! [](https://docs.rs/pagetop-macros)
|
||||||
|
//! [](https://crates.io/crates/pagetop-macros)
|
||||||
|
//! [](https://crates.io/crates/pagetop-macros)
|
||||||
//!
|
//!
|
||||||
//! </div>
|
//! </div>
|
||||||
//!
|
//!
|
||||||
|
|
|
||||||
56
src/lib.rs
56
src/lib.rs
|
|
@ -7,13 +7,26 @@
|
||||||
//! <p>Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.</p>
|
//! <p>Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.</p>
|
||||||
//!
|
//!
|
||||||
//! [](#-license)
|
//! [](#-license)
|
||||||
|
//! [](https://docs.rs/pagetop)
|
||||||
|
//! [](https://crates.io/crates/pagetop)
|
||||||
|
//! [](https://crates.io/crates/pagetop)
|
||||||
//!
|
//!
|
||||||
//! <br>
|
//! <br>
|
||||||
//! </div>
|
//! </div>
|
||||||
//!
|
//!
|
||||||
//! `PageTop` reivindica la esencia de la web clásica usando [Rust](https://www.rust-lang.org/es)
|
//! `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
|
//! para la creación de soluciones web SSR (*renderizadas en el servidor*) basadas en HTML, CSS y
|
||||||
//! JavaScript.
|
//! JavaScript. Ofrece un conjunto de herramientas que los desarrolladores pueden implementar,
|
||||||
|
//! extender o adaptar según las necesidades de cada proyecto, incluyendo:
|
||||||
|
//!
|
||||||
|
//! * **Acciones** (*actions*): alteran la lógica interna de una funcionalidad interceptando su
|
||||||
|
//! flujo de ejecución.
|
||||||
|
//! * **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.
|
||||||
|
//! * **Temas** (*themes*): son extensiones que permiten modificar la apariencia de páginas y
|
||||||
|
//! componentes sin comprometer su funcionalidad.
|
||||||
//!
|
//!
|
||||||
//! # ⚡️ Guía rápida
|
//! # ⚡️ Guía rápida
|
||||||
//!
|
//!
|
||||||
|
|
@ -27,6 +40,47 @@
|
||||||
//! Application::new().run()?.await
|
//! Application::new().run()?.await
|
||||||
//! }
|
//! }
|
||||||
//! ```
|
//! ```
|
||||||
|
//!
|
||||||
|
//! Este código arranca el servidor de `PageTop` que, con la
|
||||||
|
//! [configuración por defecto](crate::global::SETTINGS), muestra una página de bienvenida accesible
|
||||||
|
//! desde un navegador local en `http://localhost:8080`.
|
||||||
|
//!
|
||||||
|
//! Para personalizar el servicio, se puede crear una extensión de `PageTop` de la siguiente manera:
|
||||||
|
//!
|
||||||
|
//! ```rust,no_run
|
||||||
|
//! use pagetop::prelude::*;
|
||||||
|
//!
|
||||||
|
//! struct HelloWorld;
|
||||||
|
//!
|
||||||
|
//! impl Extension for HelloWorld {
|
||||||
|
//! fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
|
||||||
|
//! scfg.route("/", service::web::get().to(hello_world));
|
||||||
|
//! }
|
||||||
|
//! }
|
||||||
|
//!
|
||||||
|
//! async fn hello_world(request: HttpRequest) -> ResultPage<Markup, ErrorPage> {
|
||||||
|
//! Page::new(Some(request))
|
||||||
|
//! .with_component(Html::with(move |_| html! { h1 { "Hello world!" } }))
|
||||||
|
//! .render()
|
||||||
|
//! }
|
||||||
|
//!
|
||||||
|
//! #[pagetop::main]
|
||||||
|
//! async fn main() -> std::io::Result<()> {
|
||||||
|
//! Application::prepare(&HelloWorld).run()?.await
|
||||||
|
//! }
|
||||||
|
//! ```
|
||||||
|
//!
|
||||||
|
//! Este programa implementa una extensión llamada `HelloWorld` que sirve una página web en la ruta
|
||||||
|
//! raíz (`/`) mostrando el texto "Hello world!" dentro de un elemento HTML `<h1>`.
|
||||||
|
//!
|
||||||
|
//! # 🧩 Gestión de Dependencias
|
||||||
|
//!
|
||||||
|
//! 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
|
||||||
|
//! estructurar e inicializar la aplicación de forma modular.
|
||||||
|
|
||||||
#![cfg_attr(docsrs, feature(doc_cfg))]
|
#![cfg_attr(docsrs, feature(doc_cfg))]
|
||||||
#![doc(
|
#![doc(
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue