Documentación
Todo lo necesario para entender Boat Rudder, usarlo y modificarlo. Las páginas están agrupadas según a qué viniste: arrancar, entender cómo funciona, usarlo en el día a día, modificar el código o consultar un dato puntual.
Empezar aquí
¿Recién llegás a Boat Rudder? Estas tres páginas te llevan de cero a un servidor funcionando.
La idea del CMS retrocompatible: un solo sitio servido a todos los navegadores jamás hechos, desde teléfonos WAP hasta HTML5.
Clonar, instalar las dependencias, compilar y dejar el servidor respondiendo en tu máquina.
C17, libsodium, el driver C de MongoDB, ImageMagick y las plataformas donde Boat Rudder compila.
Entender
Los conceptos detrás del código. Leelos antes de cambiar nada.
Los cinco epochs, cómo se detecta el navegador desde su User-Agent y cómo cada bloque de contenido degrada en vez de desaparecer.
Capas, el modelo de hilos, el árbol de directorios y las decisiones de seguridad que dan forma al servidor.
De accept() al último byte escrito: listener, hilo de conexión, router, renderizador.
Entradas, bloques de contenido tipados, categorías, menú, idiomas y medios, y cómo encajan entre sí.
La convención de plantillas por epoch, el namespace CSS boat-rudder- y cómo se compone una página.
Usar
Poner el servidor a andar y publicar contenido: para operadores y editores.
Cada clave de configs/settings.conf, qué hace y qué pasa si la omitís.
Las acciones de boat_rudder_builder.sh, los modos debug y producción, y la instalación como servicio systemd.
Generar un certificado local para desarrollo y conectar uno real en producción.
Arrancar la base, volcarla y restaurarla con los scripts incluidos.
Login, sesiones, los roles Administrador y Autor, y un recorrido por cada pantalla de administración.
El editor de entradas: metadatos, cabecera, bloques, reordenamiento arrastrando, autoguardado y publicación.
Qué hace cada bloque, el campo extra que lleva y cómo se ve en cada epoch.
Subir, organizar en directorios, el optimizador de imágenes y la ruta pública de galerías.
Las cuatro pantallas mantenedoras que definen la navegación, la traducción y quién puede entrar.
Modificar
Trabajar sobre el código fuente. Recetas y las reglas que no se discuten.
Qué vive en cada carpeta de src/ y por qué vive ahí.
Nombres, formato, memoria, cadenas, enteros y el checklist CERT con el que se revisa cada cambio.
Paso a paso: el renderizador público, el formulario del editor y una plantilla para cada uno de los cinco epochs.
Registrarla en el router, protegerla con un rol de sesión y devolver errores conscientes del epoch.
Editar marcado y CSS sin romper los epochs retro que no tienen ni lo uno ni lo otro.
Referencia
Tablas de consulta para cuando ya sabés lo que estás haciendo.
Toda ruta pública y de panel, su método y la guarda que la protege.
La forma de cada colección de MongoDB que Boat Rudder lee y escribe.
Qué está implementado hoy y qué queda por delante.
