✨ 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:
Manuel Cillero 2026-10-17 08:06:02 +02:00
parent e41e71cc78
commit 1a41a456d4
80 changed files with 14112 additions and 1218 deletions

View 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).