diff --git a/pagetop/src/lib.rs b/pagetop/src/lib.rs index 420b9a07..42554ba7 100644 --- a/pagetop/src/lib.rs +++ b/pagetop/src/lib.rs @@ -71,6 +71,31 @@ //! Este programa crea un m贸dulo llamado `HelloWorld` con un servicio que devuelve una p谩gina web //! saludando al mundo cada vez que se accede desde el navegador a `http://localhost:8088` (seg煤n //! los [ajustes de configuraci贸n](`config::Server`) predeterminados). +//! +//! # 馃П Extendiendo PageTop +//! +//! La API de PageTop no s贸lo sirve para crear aplicaciones, tambi茅n permite extender sus +//! funcionalidades con el desarrollo de acciones, componentes, m贸dulos o nuevos temas: +//! +//! * Las **acciones** permiten alterar el comportamiento del propio funcionamiento interno de +//! PageTop. Las acciones se ofrecen al desarrollador para interactuar con la ejecuci贸n de +//! procesos que pueden ser modificados. +//! * Los **componentes** incluyen c贸digo HTML, CSS y/o Javascript en unidades que tienen una +//! funcionalidad bien definida y configurable durante la creaci贸n de p谩ginas web. +//! * Los **m贸dulos** a帽aden funcionalidades o modifican las ya existentes usando las APIs globales +//! o las de otros m贸dulos de PageTop o de terceros. +//! * Los **temas** son m贸dulos que permiten cambiar la disposici贸n y el aspecto de las p谩ginas y +//! componentes sin necesidad de alterar su funcionamiento. Estructuran las p谩ginas en regiones +//! donde disponer los diferentes componentes. +//! +//! # 馃З Dependencias +//! +//! Las aplicaciones usar谩n `cargo` para resolver las dependencias entre PageTop y las extensiones +//! de terceros que implementen acciones, componentes, m贸dulos y/o temas; de la misma manera que se +//! hace en cualquier otro proyecto. +//! +//! Pero tambi茅n deber谩n declararse expl铆citamente estas dependencias en cada m贸dulo para ayudar a +//! PageTop a estructurar e inicializar modularmente la aplicaci贸n. // ************************************************************************************************* // GLOBAL.