105 lines
4.6 KiB
Markdown
105 lines
4.6 KiB
Markdown
<div align="center">
|
||
|
||
<img src="https://raw.githubusercontent.com/manuelcillero/pagetop/main/banner-pagetop.png" />
|
||
|
||
<h1>PageTop</h1>
|
||
|
||
[](https://crates.io/crates/pagetop)
|
||
[](https://docs.rs/pagetop)
|
||
|
||
</div>
|
||
|
||
**PageTop** es un entorno de desarrollo basado en [Rust](https://www.rust-lang.org/es/) que reúne
|
||
algunos de los crates más estables y populares para crear soluciones web modulares, extensibles y
|
||
configurables.
|
||
|
||
Incluye **Drust**, un sistema de gestión de contenidos basado en PageTop que permite crear, editar y
|
||
mantener sitios web dinámicos, rápidos y seguros.
|
||
|
||
|
||
# 🚧 Advertencia
|
||
|
||
**PageTop** es un proyecto personal para aprender Rust y conocer su ecosistema. Sólo se liberan
|
||
versiones de desarrollo. En este contexto la API no es estable y los cambios son constantes. No
|
||
puede considerarse preparado hasta que se libere la versión **0.1.0**.
|
||
|
||
|
||
# 📂 Estructura del código
|
||
|
||
El repositorio se organiza en un *workspace* con los siguientes subproyectos:
|
||
|
||
* **[pagetop](https://github.com/manuelcillero/pagetop/tree/main/pagetop)**, es la librería esencial
|
||
construida con *crates* estables y muy conocidos del ecosistema Rust para proporcionar APIs,
|
||
patrones de desarrollo y buenas prácticas para la creación avanzada de soluciones web SSR
|
||
(*Server-Side Rendering*).
|
||
|
||
## Auxiliares
|
||
|
||
* **[pagetop-macros](https://github.com/manuelcillero/pagetop/tree/main/pagetop-macros)**, agrupa
|
||
las principales macros procedurales para usar desde **PageTop**.
|
||
|
||
* **[pagetop-build](https://github.com/manuelcillero/pagetop/tree/main/pagetop-build)**, permite
|
||
incluir fácilmente recursos en los archivos binarios al compilar aplicaciones creadas con
|
||
**PageTop**.
|
||
|
||
## Componentes
|
||
|
||
* **[pagetop-minimal](https://github.com/manuelcillero/pagetop/tree/main/pagetop-minimal)**, módulo
|
||
que proporciona un conjunto básico de componentes para la composición de páginas.
|
||
|
||
* **[pagetop-jquery](https://github.com/manuelcillero/pagetop/tree/main/pagetop-jquery)**, módulo
|
||
que permite añadir jQuery en las páginas que incluyen componentes o temas que usen esta librería
|
||
JavaScript para interactuar con el documento HTML.
|
||
|
||
* **[pagetop-megamenu](https://github.com/manuelcillero/pagetop/tree/main/pagetop-megamenu)**,
|
||
módulo que proporciona un nuevo componente para incluir menús avanzados en las aplicaciones web
|
||
creadas con **PageTop**.
|
||
|
||
## Módulos
|
||
|
||
* **[pagetop-homedemo](https://github.com/manuelcillero/pagetop/tree/main/pagetop-homedemo)**,
|
||
módulo que muestra una página de inicio de demostración para presentar **PageTop**.
|
||
|
||
* **[pagetop-admin](https://github.com/manuelcillero/pagetop/tree/main/pagetop-admin)**, módulo que
|
||
proporciona a otros módulos un lugar común donde presentar a los administradores sus opciones de
|
||
configuración.
|
||
|
||
* **[pagetop-user](https://github.com/manuelcillero/pagetop/tree/main/pagetop-user)**, módulo para
|
||
añadir gestión de usuarios, roles, permisos y sesiones en aplicaciones desarrolladas con PageTop.
|
||
|
||
* **[pagetop-node](https://github.com/manuelcillero/pagetop/tree/main/pagetop-node)**, módulo para
|
||
crear, extender o personalizar los tipos de contenido que puede administrar un sitio web.
|
||
|
||
## Temas
|
||
|
||
* **[pagetop-aliner](https://github.com/manuelcillero/pagetop/tree/main/pagetop-aliner)**, tema que
|
||
delimita con cajas los elementos HTML para mostrar esquemáticamente la composición de las páginas.
|
||
|
||
* **[pagetop-bootsier](https://github.com/manuelcillero/pagetop/tree/main/pagetop-bootsier)**, tema
|
||
que utiliza el *framework* [Bootstrap](https://getbootstrap.com/) para la composición de páginas y
|
||
visualización de componentes.
|
||
|
||
* **[pagetop-bulmix](https://github.com/manuelcillero/pagetop/tree/main/pagetop-bulmix)**, tema que
|
||
utiliza el *framework* [Bulma](https://bulma.io/) para la composición de páginas y visualización
|
||
de componentes.
|
||
|
||
## Aplicación
|
||
|
||
* **[drust](https://github.com/manuelcillero/pagetop/tree/main/drust)**, es una aplicación
|
||
inspirada modestamente en [Drupal](https://www.drupal.org) que utiliza PageTop para crear un CMS
|
||
(*Content Management System* o sistema de gestión de contenidos) para construir sitios web
|
||
dinámicos, administrados y configurables.
|
||
|
||
|
||
# 📜 Licencia
|
||
|
||
Este proyecto tiene licencia, de hecho tiene dos, puedes aplicar cualquiera de las siguientes a tu
|
||
elección:
|
||
|
||
* Licencia Apache versión 2.0
|
||
([LICENSE-APACHE](https://github.com/manuelcillero/pagetop/blob/main/LICENSE-APACHE) o
|
||
[http://www.apache.org/licenses/LICENSE-2.0]).
|
||
|
||
* Licencia MIT
|
||
([LICENSE-MIT](https://github.com/manuelcillero/pagetop/blob/main/LICENSE-MIT) o
|
||
[http://opensource.org/licenses/MIT]).
|