pagetop/README.md

60 lines
2.9 KiB
Markdown

**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. Ahora mismo sólo se
liberan versiones de desarrollo. En este contexto la API no tiene ninguna estabilidad y los cambios
son constantes. No puede considerarse listo para probar 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*).
* [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.
* [pagetop-mdbook](https://github.com/manuelcillero/pagetop/tree/main/pagetop-mdbook), módulo para
integrar los archivos generados por la herramienta [mdBook](https://rust-lang.github.io/mdBook/)
en un proyecto web creado con PageTop.
* [website](https://github.com/manuelcillero/pagetop/tree/main/website), es una aplicación creada
con PageTop para presentar el entorno a la comunidad y publicar la documentación de usuario
([pagetop.cillero.es](https://pagetop.cillero.es)).
* [drust](https://github.com/manuelcillero/pagetop/tree/main/drust), es una aplicación modestamente
inspirada 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 usarlo en tus propios proyectos si aplicas
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]).