✨ [pagetop] Añade la librería principal de PageTop

El crate pagetop reúne algunos de los crates más estables y populares
del ecosistema Rust para proporcionar un conjunto completo de
funcionalidades que pueden extenderse y adaptarse a las necesidades
específicas de cada aplicación para crear soluciones web modulares,
extensibles y configurables.

README.md

@@ -1 +1,114 @@
-# Un nuevo comienzo
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/manuelcillero/pagetop/main/static/banner.png" />
+
+<h1>PageTop</h1>
+
+<p>Entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.</p>
+
+[![Licencia](https://img.shields.io/badge/license-MIT%2FApache-blue.svg?label=Licencia&style=for-the-badge)](#-license)
+[![Doc API](https://img.shields.io/docsrs/pagetop?label=Doc%20API&style=for-the-badge&logo=Docs.rs)](https://docs.rs/pagetop)
+[![Crates.io](https://img.shields.io/crates/v/pagetop.svg?style=for-the-badge&logo=ipfs)](https://crates.io/crates/pagetop)
+[![Descargas](https://img.shields.io/crates/d/pagetop.svg?label=Descargas&style=for-the-badge&logo=transmission)](https://crates.io/crates/pagetop)
+
+</div>
+
+## Presentación
+
+**PageTop** reúne algunos de los *crates* más estables y populares del ecosistema Rust para
+proporcionar un conjunto completo de funcionalidades que pueden extenderse y adaptarse a las
+necesidades específicas de cada aplicación web.
+
+PageTop reivindica la sencillez de la web clásica aplicando *renderizado en el servidor* (SSR),
+HTML, CSS y JS, mediante acciones, componentes, paquetes y temas:
+
+  * **Acciones**. Las funciones y procedimientos que incorporen *acciones* en su lógica de programa
+    estarán proporcionando a los desarrolladores herramientas para alterar su comportamiento interno
+    interceptando su flujo de ejecución.
+  * **Componentes**. Encapsulan HTML, CSS y JavaScript en unidades funcionales, configurables y bien
+    definidas.
+  * **Paquetes**. Extienden o personalizan funcionalidades existentes interactuando con las APIs de
+    PageTop o de paquetes de terceros.
+  * **Temas**. Permiten a los desarrolladores alterar la apariencia de las páginas y componentes sin
+    afectar su funcionalidad.
+
+
+# ⚡️ Inicio rápido
+
+La aplicación más sencilla de PageTop se ve así:
+
+```rust
+use pagetop::prelude::*;
+
+#[pagetop::main]
+async fn main() -> std::io::Result<()> {
+    Application::new().run()?.await
+}
+```
+
+Proporciona una página de bienvenida en `http://localhost:8088` según la configuración predefinida.
+Para personalizar el servicio puedes crear un paquete de PageTop:
+
+```rust
+use pagetop::prelude::*;
+
+struct HelloWorld;
+
+impl PackageTrait 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(request)
+        .with_component(Html::with(html! { h1 { "Hello world!" } }))
+        .render()
+}
+
+#[pagetop::main]
+async fn main() -> std::io::Result<()> {
+    Application::prepare(&HelloWorld).run()?.await
+}
+```
+
+Este programa prepara un paquete personalizado llamado `HelloWorld` que sirve una página web en la
+ruta raíz (`/`) mostrando el mensaje "Hello world!" en un elemento HTML `<h1>`.
+
+
+# 📂 Crates de ayuda
+
+  * [pagetop-macros](https://github.com/manuelcillero/pagetop/tree/latest/helpers/pagetop-macros):
+    Proporciona una colección de macros que mejoran la experiencia de desarrollo con PageTop.
+
+  * [pagetop-build](https://github.com/manuelcillero/pagetop/tree/latest/helpers/pagetop-build):
+    Permite incluir fácilmente archivos estáticos o archivos SCSS compilados, directamente en el
+    binario de las aplicaciones PageTop.
+
+
+# 🚧 Advertencia
+
+**PageTop** es un proyecto personal que se encuentra en desarrollo activo. Actualmente su API es
+inestable y está sujeta a cambios frecuentes. No se recomienda su uso en producción, al menos hasta
+que alcance la versión **0.1.0**.
+
+
+# 📜 Licencia
+
+El código está disponible bajo una doble licencia:
+
+  * **Licencia MIT**
+    ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/licenses/MIT)
+
+  * **Licencia Apache, Versión 2.0**
+    ([LICENSE-APACHE](LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)
+
+Puedes elegir la licencia que prefieras. Este enfoque de doble licencia es el estándar de facto en
+el ecosistema Rust.
+
+
+# ✨ Contribuciones
+
+Cualquier contribución para añadir al proyecto se considerará automáticamente bajo la doble licencia
+indicada arriba (MIT o Apache v2.0), sin términos o condiciones adicionales, tal y como permite la
+licencia *Apache v2.0*.