✨ Serve the PageTop guides with pagetop-mdbook
Rebuild the website on the current PageTop API, with Bootsier as its
theme and edition 2024. Add the first Spanish guide (doc/v0.6/es) as an
mdBook book, built in build.rs and served with pagetop-mdbook, and the
/doc/latest/{lang} redirect.
Add `tools/doccheck.sh` to check the links of the guides and to compile,
run and test their examples against PageTop.
Move the configuration to config/common.toml and translate the README
to English.
This commit is contained in:
parent
e41e71cc78
commit
1a41a456d4
80 changed files with 14112 additions and 1218 deletions
108
doc/v0.6/es/src/explanation/comparison.md
Normal file
108
doc/v0.6/es/src/explanation/comparison.md
Normal file
|
|
@ -0,0 +1,108 @@
|
|||
# PageTop frente a otros *frameworks*
|
||||
|
||||
Rust tiene muy buenos *frameworks* web, y es justo preguntarse por qué elegir uno u otro. Esta
|
||||
página compara PageTop con los más conocidos, con sus puntos fuertes y también con lo que a PageTop
|
||||
todavía le falta.
|
||||
|
||||
A grandes rasgos hay dos familias. Los **modulares** (Axum, Actix Web) te dan las piezas básicas
|
||||
para atender peticiones y te dejan elegir el resto: base de datos, plantillas, usuarios. Los
|
||||
**completos** (Rocket en parte, Loco, Cot) traen de serie muchas de esas piezas y unas convenciones
|
||||
para encajarlas. PageTop está en la segunda familia, con un matiz: lo que trae lo organiza en
|
||||
**extensiones**, **componentes** y **temas**, y casi todo es opcional.
|
||||
|
||||
## Tabla comparativa
|
||||
|
||||
| | PageTop | Axum | Actix Web | Rocket | Loco | Cot |
|
||||
|:--|:--|:--|:--|:--|:--|:--|
|
||||
| **Enfoque** | Completo, por extensiones | Modular | Modular | Completo en parte | Completo (como Rails) | Completo (como Django) |
|
||||
| **Base** | Axum | Hyper y Tokio | Actix | Hyper y Tokio | Axum | Axum |
|
||||
| **HTML** | `html!` con componentes y temas | A tu elección | A tu elección | Tera o Handlebars | Tera | Askama |
|
||||
| **Interactividad** | HTMX (extensión) | A tu elección | A tu elección | A tu elección | A tu elección | A tu elección |
|
||||
| **Base de datos** | SeaORM (extensión) | A tu elección | A tu elección | Varias, con su integración | SeaORM | ORM propio |
|
||||
| **Migraciones** | Escritas en Rust, aplicadas al arrancar | Herramientas externas | Herramientas externas | Herramientas externas | Generadas con su CLI | Generadas a partir de los modelos |
|
||||
| **Usuarios y permisos** | Extensión (roles y permisos) | No | No | No | Autenticación con JWT | Autenticación |
|
||||
| **Panel de administración** | Extensible, con formularios de ajustes | No | No | No | No | Generado a partir de los modelos |
|
||||
| **Traducciones** | Fluent, de serie | No | No | No | Fluent, en su plantilla de proyecto | No |
|
||||
| **Tareas en segundo plano y correo** | Todavía no | No | No | No | Sí | Correo y caché |
|
||||
|
||||
## PageTop frente a Axum
|
||||
|
||||
PageTop **está construido sobre Axum**, así que comparten rutas, extractores y respuestas. Lo que
|
||||
sabes de Axum lo puedes usar en PageTop (lo cuenta [Si vienes de Axum](coming-from-axum.md)).
|
||||
|
||||
- **Elige Axum si** quieres controlar cada pieza, construyes una API o un microservicio sin
|
||||
interfaz, o prefieres montar tu propia pila.
|
||||
- **Elige PageTop si** vas a generar páginas: te ahorra el trabajo de juntar plantillas,
|
||||
traducciones, recursos estáticos, configuración y extensiones, y sigues teniendo Axum debajo
|
||||
cuando lo necesites.
|
||||
|
||||
## PageTop frente a Actix Web
|
||||
|
||||
Actix Web es maduro y uno de los más rápidos que existen.
|
||||
|
||||
- **Elige Actix Web si** el rendimiento bruto por petición es lo que más pesa, o ya tienes código
|
||||
sobre su ecosistema.
|
||||
- **Elige PageTop si** te importa más avanzar rápido en una aplicación con interfaz. Rust y Axum ya
|
||||
dan un rendimiento de sobra para la inmensa mayoría de aplicaciones de gestión.
|
||||
|
||||
## PageTop frente a Rocket
|
||||
|
||||
Rocket es conocido por lo agradable que resulta escribir rutas con sus macros y por sus guardas de
|
||||
petición.
|
||||
|
||||
- **Elige Rocket si** te gusta su estilo de API y no te importa elegir tú la capa de datos, los
|
||||
usuarios y la interfaz.
|
||||
- **Elige PageTop si** quieres que esas piezas vengan resueltas: usuarios y permisos, panel de
|
||||
administración, temas y traducciones.
|
||||
|
||||
## PageTop frente a Loco
|
||||
|
||||
Loco se presenta como «el Rails de Rust»: convenciones fuertes, una CLI que genera código y muchas
|
||||
piezas incluidas, también sobre Axum y SeaORM.
|
||||
|
||||
- **Elige Loco si** te gusta la filosofía de Rails, quieres generadores de código, o necesitas ya
|
||||
**tareas en segundo plano**, **tareas programadas** o **envío de correo**, que PageTop todavía no
|
||||
tiene.
|
||||
- **Elige PageTop si** tu aplicación es sobre todo interfaz: los componentes tipados, los temas que
|
||||
pueden cambiar cualquier componente y HTMX integrado no tienen equivalente en Loco, que deja la
|
||||
interfaz en manos de las plantillas.
|
||||
|
||||
## PageTop frente a Cot
|
||||
|
||||
Cot toma la filosofía de Django: un ORM propio que genera las migraciones a partir de los modelos y
|
||||
un panel de administración que se construye solo.
|
||||
|
||||
- **Elige Cot si** te gusta Django y quieres un panel de administración con altas, bajas y
|
||||
modificaciones de tus modelos sin escribir nada.
|
||||
- **Elige PageTop si** prefieres SeaORM, quieres construir la interfaz con componentes y temas en
|
||||
lugar de plantillas, o necesitas traducciones. El panel de PageTop no genera páginas a partir de
|
||||
los modelos, pero cada extensión le añade las suyas, con sus permisos (ve [Añadir páginas al panel
|
||||
de administración](../how-to/admin.md)).
|
||||
|
||||
## PageTop frente a summer-rs
|
||||
|
||||
[summer-rs](https://summer-rs.github.io) (antes spring-rs) se inspira en Spring Boot: un núcleo
|
||||
pequeño de *plugins* que integran piezas del ecosistema (Axum, SQLx, SeaORM, Redis, correo con
|
||||
lettre, tareas programadas, OpenTelemetry, gRPC...), configurados en TOML y con inyección de
|
||||
dependencias en tiempo de compilación.
|
||||
|
||||
- **Elige summer-rs si** construyes servicios o APIs y quieres tener ya integrados la caché, las
|
||||
colas, el correo, las tareas programadas o la observabilidad.
|
||||
- **Elige PageTop si** lo que construyes son páginas: summer-rs no trae plantillas, componentes,
|
||||
temas ni traducciones. La idea de los *plugins* es muy parecida a la de las extensiones; donde
|
||||
summer-rs inyecta componentes, PageTop guarda los servicios en estáticos (ve [Compartir un
|
||||
servicio entre rutas](../how-to/services.md)).
|
||||
|
||||
## ¿Y Leptos o Dioxus?
|
||||
|
||||
Leptos y Dioxus son *frameworks* **de pila completa** que compilan la interfaz a WebAssembly y la
|
||||
ejecutan en el navegador, con renderizado en el servidor como punto de partida. Es el modelo
|
||||
contrario al de PageTop: aquí la interfaz vive en el servidor y HTMX sólo intercambia fragmentos
|
||||
de HTML. Si tu aplicación necesita mucha lógica en el navegador o funcionar sin conexión, mira hacia
|
||||
ellos (lo explica también [Por qué PageTop](why.md#cuándo-no-es-la-mejor-opción)).
|
||||
|
||||
## Siguiente
|
||||
|
||||
- [Por qué PageTop](why.md): las ideas detrás del diseño.
|
||||
- [Si vienes de Axum](coming-from-axum.md): lo que ya sabes y lo que cambia.
|
||||
- [HTML por la red: por qué HTMX](htmx.md).
|
||||
Loading…
Add table
Add a link
Reference in a new issue