Las palabras también pueden tender puentes
No necesitas aprender estos términos de memoria. Están aquí para acompañarte cuando una instrucción use una palabra que todavía no conoces. Puedes llegar desde el texto, leer la explicación y volver al apartado en el que estabas.
- HTML
Es el lenguaje que organiza una página: señala qué es un título, un párrafo, una imagen o un enlace. Podemos imaginarlo como la estructura de una casa. En roscaille, el servidor prepara ese contenido para que el navegador pueda mostrarlo.
← Volver a Nuestro recorrido- CSS
Define cómo se ve la estructura: colores, tipografías, espacios y distribución. Es lo que ayuda a mantener nuestra identidad en una pantalla grande y en un teléfono. Cambiar CSS no debería cambiar lo que alguien escribió en una publicación.
← Volver a Nuestro recorrido- JavaScript
Es un lenguaje para indicar acciones a un programa. En el navegador permite abrir menús, ordenar bloques y enviar formularios. En nuestro servidor también se utiliza para atender peticiones y preparar páginas, mediante Node.js.
← Volver a Nuestro recorrido- Node.js
Es el programa que permite ejecutar JavaScript en el servidor. Nuestra aplicación necesita Node.js 24 para funcionar, recibir formularios y consultar los datos. No es algo que deba instalar una persona para visitar la página.
← Volver a Nuestro recorrido- SQLite
Es el sistema que guarda nuestra base de datos en un archivo. Allí permanecen las entradas, las cuentas y las postulaciones. No se modifica como un documento de texto: la aplicación lo consulta y actualiza de forma organizada.
← Volver a Nuestro recorrido- Base de datos
Es una colección organizada de información que la página necesita recordar. En nuestro caso usa SQLite. Conservarla durante una actualización permite que sigan disponibles las publicaciones, los accesos y las postulaciones anteriores.
← Volver a Nuestro recorrido- Navegador
Es la aplicación con la que visitas páginas, como Chrome, Safari o Firefox. Muestra lo que envía el servidor y permite interactuar. El navegador y el hosting son lugares distintos; guardar algo solo en el navegador no equivale a guardarlo en el servidor.
← Volver a Nuestro recorrido- Servidor
Es el equipo que mantiene disponible nuestra aplicación y responde cuando alguien abre una página o envía un formulario. No es el computador personal de quien visita. El hosting nos ofrece ese espacio y sus recursos.
← Volver a Nuestro recorrido- Hosting
Es el servicio donde vive nuestra página para que otras personas puedan visitarla. roscaille utiliza Spaceship. Incluye un espacio para el código y los datos, pero configurar un servicio de envío de correo es una tarea aparte.
← Volver a Nuestro recorrido- Spaceship
Es el proveedor elegido para nuestro dominio y hosting. Su panel permite llegar a las herramientas con las que se administra la instalación. En esta guía, las instrucciones de arranque se refieren a nuestra aplicación Node.js en ese entorno.
← Volver a Nuestro recorrido- cPanel
Es el panel de control del hosting. Desde allí podemos gestionar archivos y la aplicación Node.js, entre otras tareas. No es el editor de roscaille: las publicaciones y las cuentas de la web se gestionan dentro de nuestra propia página.
← Volver a Nuestro recorrido- Dominio
Es el nombre con el que encontramos una página en internet. El nuestro es roscaillefoundation.lat. Es diferente del hosting: el dominio da la dirección y el hosting guarda y ejecuta la página.
← Volver a Nuestro recorrido- URL
Es la dirección completa de una página o recurso. Puede incluir el dominio y una ruta, como /blog/. También puede señalar un apartado concreto mediante un fragmento que empieza con #. Es lo que copiamos al compartir un enlace.
← Volver a Nuestro recorrido- HTTPS
Indica que la conexión entre el navegador y el sitio está cifrada. Es importante al iniciar sesión o enviar datos personales. No reemplaza las contraseñas ni los permisos; acompaña esas otras medidas.
← Volver a Nuestro recorrido- Raíz de la aplicación
Es la carpeta principal de esta instalación: contiene app.cjs, package.json y las demás carpetas del sitio. Extraer un ZIP en la raíz significa colocar sus archivos allí, sin esconderlos dentro de otra carpeta nueva.
← Volver a Nuestro recorrido- app.cjs
Es el archivo de inicio de nuestra aplicación: la puerta por la que el hosting la pone en marcha. Su nombre se mantiene exactamente así en la configuración, aunque cambie el nombre del ZIP que entregamos.
← Volver a Nuestro recorrido- Variables de entorno
Son opciones que le dicen a la aplicación dónde funciona y qué servicios tiene disponibles. Por ejemplo, PUBLIC_ORIGIN indica el dominio y ROSCAILLE_DATA_DIR la carpeta de datos. Algunas pueden contener claves privadas: no se copian en páginas públicas.
← Volver a Nuestro recorrido- PUBLIC_ORIGIN
Es la opción que guarda la dirección pública principal del sitio, por ejemplo https://roscaillefoundation.lat. Ayuda a preparar enlaces correctos y a reconocer las peticiones de nuestra propia página. Debe coincidir con el dominio en uso.
← Volver a Nuestro recorrido- ROSCAILLE_DATA_DIR
Es la opción que señala dónde se guardan los datos privados de la instalación. Si está configurada, utiliza esa carpeta en lugar de la carpeta data habitual. Al actualizar, conservar esta ruta evita que la web parezca una instalación vacía.
← Volver a Nuestro recorrido- Respaldo
Es una copia que nos permite recuperar la instalación si algo falla. Para roscaille debe incluir código, base de datos, imágenes subidas y configuración. Como puede contener datos personales y claves, se guarda fuera de las carpetas públicas.
← Volver a Nuestro recorrido- ZIP
Es un archivo que reúne otros archivos y carpetas, normalmente ocupando menos espacio. Hay que extraer su contenido para instalarlo. El paquete completo contiene la aplicación; el paquete de actualización contiene solo los archivos que cambiaron respecto a la base indicada.
← Volver a Nuestro recorrido- CSV
Es un formato sencillo para llevar datos a una hoja de cálculo. Cada fila corresponde a un registro y cada columna a un dato. La descarga de postulaciones incluye las respuestas y sus fechas; no cambia ni elimina los registros guardados en la web.
← Volver a Nuestro recorrido- API
Es una forma organizada de comunicación entre programas. Por ejemplo, nuestra página puede pedir una traducción a Google mediante su API. Esa integración puede necesitar una clave y una cuenta del servicio; no es lo mismo que abrir su página con un enlace.
← Volver a Nuestro recorrido- Cloud Translation API Basic v2
Es el servicio de Google que podemos conectar para obtener traducciones dentro de la web. Requiere configuración y facturación en Google Cloud. Si no se conecta, la página puede seguir ofreciendo el enlace externo de Google Translate.
← Volver a Nuestro recorrido- Google Translate
Es el traductor de Google. Nuestro botón abre la publicación allí e indica los idiomas de origen y destino cuando se conocen. Es una lectura en un servicio externo; no reemplaza el texto original guardado en roscaille.
← Volver a Nuestro recorrido- Zulip
Es la plataforma de conversación que apoya a nuestra comunidad. Permite compartir lo que estamos creando y organizar equipos mediante canales y temas. El enlace de roscaille lleva a nuestro espacio allí; no es la base de datos ni el panel de administración de la web.
← Volver a Nuestro recorrido- Owner
Es el nombre del permiso de la persona responsable de toda la instalación. Puede administrar las demás cuentas y consultar las postulaciones. Un manager no puede modificar ni eliminar esta cuenta. No es una contraseña compartida: es un rol asignado a un usuario.
← Volver a Nuestro recorrido- Manager
Es un permiso de administración para acompañar el trabajo cotidiano. Permite gestionar publicaciones, otras cuentas y consultar postulaciones, pero mantiene protegida la cuenta owner. Conviene asignarlo solo a quienes necesiten esas tareas.
← Volver a Nuestro recorrido- Sesión
Es el acceso temporal que queda abierto después de entrar con usuario y contraseña. Permite pasar de una herramienta a otra sin identificarse cada vez. Cerrar sesión termina ese acceso en el navegador; desactivar una cuenta invalida sus sesiones.
← Volver a Nuestro recorrido- Editor por bloques
Es el espacio donde organizamos una publicación en partes, como párrafos e imágenes. Podemos mover los bloques, dar formato al texto y revisar el resultado. Es diferente del permiso Editor, que indica quién puede modificar publicaciones de otras personas.
← Volver a Nuestro recorrido- Caché
Es una copia temporal que ayuda a cargar contenido sin volver a pedirlo todo. A veces conserva una versión anterior de un recurso. Recargar puede ayudar a comprobar una actualización. La caché no sustituye un respaldo; las páginas privadas de postulaciones se envían con instrucciones para no almacenarse.
← Volver a Nuestro recorrido- SEO
Es el conjunto de cuidados que ayudan a los buscadores a entender el sitio y mostrarlo cuando es relevante. Incluye títulos, descripciones y direcciones claras. No garantiza una posición en Google ni que un cambio aparezca de inmediato.
← Volver a Nuestro recorrido- Metadatos
Son datos que describen una página, como su título y descripción para buscadores o enlaces compartidos. No siempre se ven dentro del texto principal. Allí mantenemos el nombre roscaille foundation en minúscula.
← Volver a Nuestro recorrido- Sitemap
Es una lista de direcciones públicas que ayuda a los buscadores a recorrer el sitio. No es el mapa de La Estrella ni el menú que ve una persona. Las herramientas privadas de administración no deben presentarse allí como contenido público.
← Volver a Nuestro recorrido- Compilar
Es preparar los archivos de trabajo para que la aplicación pueda ejecutarlos. En este proyecto, npm run build genera la distribución en dist desde src y public. El paquete de entrega ya contiene esa distribución: no hace falta compilar para instalarlo.
← Volver a Nuestro recorrido- Alpha
Es el nombre que damos a la base desde la que seguimos mejorando la página. El número permite reconocer una entrega concreta. Alpha 1.1.0 continúa lo reunido en Alpha 1.0.0 y añade las postulaciones y esta guía ampliada; no significa que debamos borrar la instalación anterior.
← Volver a Nuestro recorrido- Terminal
Es una herramienta donde se escriben instrucciones para el servidor. Por ejemplo, quien instala puede ejecutar allí npm run activate. No es necesario usarla para escribir publicaciones o consultar postulaciones: esas tareas ya tienen su pantalla en la web.
← Volver a Nuestro recorrido- npm
Es una herramienta que acompaña Node.js y permite ejecutar tareas con nombres cortos. En esta aplicación, npm run activate prepara el primer acceso, npm run backup crea un respaldo y npm run build prepara la distribución. Los comandos se ejecutan desde la raíz de la aplicación.
← Volver a Nuestro recorrido- .env
Es un archivo opcional de configuración privada. Puede guardar variables de entorno que la aplicación lee al arrancar. Si ya existe en el hosting, se conserva al actualizar. No debe publicarse ni incluirse en un ZIP de distribución con sus claves reales.
← Volver a Nuestro recorrido- .htaccess
Es un archivo de configuración que el hosting puede utilizar para dirigir las visitas a la aplicación. No es una página visible. Conservamos el que ya funciona en Spaceship para evitar alterar el acceso al dominio durante una actualización.
← Volver a Nuestro recorrido
Alpha 1.5.3 · Un nuevo paso sobre la base de septiembre de 2026