Primeros Pasos

Todo lo que necesitas para ir de cero a una página publicada: qué es Chinaski, qué máquina necesita, cómo funciona la instalación y las primeras cosas que tocar una vez que estás en el admin. Cada sección es corta y apunta al paso que cubre: la referencia más profunda vive en las páginas enlazadas.

El camino de lectura

1. Qué Es Chinaski: la versión de un párrafo: un CMS autoalojado + constructor de sitios estáticos. Contenido en SQLite, admin en Perl, el sitio público en HTML plano servido por un servidor web.
2. Cómo Funciona: el modelo de dos programas (aplicación CMS + builder estático), por qué los builds son explícitos, y por qué el servidor web nunca habla con el CMS en la ruta pública.
3. Requisitos: la lista honesta: un servidor Debian/Ubuntu, Perl 5.26+, SQLite; orientación de dimensionamiento y las dos rutas de instalación (una línea en línea o bundle sin conexión).
4. Instalación: los pasos reales de instalación.
5. Quickstart: el camino de cinco minutos: instalar, cambiar la contraseña del setup, crear una página, compilar, publicar.
6. Tour del Admin: un mapa del área de administración: dónde viven las páginas, posts, bloques, stacks, formularios, medios, documentos, ajustes y las pantallas de salud.
7. Tu Primera Página: caminar desde una lista de páginas vacía hasta una página publicada en el sitio compilado (borrador → publicar → compilar → verificar).
8. Glosario: el vocabulario (bloques, stacks, snippets, promotion guard, papelera vs eliminar) para que el resto de los docs se lean más rápido.

Las tres decisiones antes de empezar

Unos minutos de elección ahorran retrabajo después. Estas son las únicas decisiones de configuración que realmente moldean una instancia nueva:

• Nombre de instancia: un servidor puede ejecutar varias instancias Chinaski una al lado de la otra (chinaski@1, chinaski@prod, ...). El nombre aparece en las rutas de instalación, los nombres de servicio y los destinos de respaldo para siempre.
• Idiomas: la lista de idiomas configurada dirige las formas de URL (path vs none vs subdomain) y los árboles por idioma. Define el conjunto de idiomas antes de la importación de contenido: cada fila de contenido pertenece exactamente a un idioma.
• Sin conexión o conectado: el interruptor de air-gap viene activado por defecto en las instalaciones frescas. Decide antes del primer arranque si se espera que la instancia alcance internet (correo, webhooks, verificaciones de actualización, Spaces) o que nunca deba hacerlo; el modo air-gap viene habilitado por defecto por una razón, y deshabilitarlo es una decisión deliberada.

Qué significa "instalado" aquí

Chinaski es autoalojado por diseño: tú posees el servidor, la base de datos y los respaldos. El instalador hace el trabajo pesado (paquetes del sistema, dependencias, un usuario del sistema chinaski, una base de datos SQLite inicializada, un archivo env con un secreto generado y una unidad de systemd), y la primera solicitud te aterriza en una página de setup obligatoria donde reemplazas la contraseña placeholder del admin (obligatoria: 12+ caracteres con mayúsculas, minúsculas y dígitos). Después de eso, la interfaz de administración es tuya; nada llama a casa, y no se requiere ningún otro paso de instalación.

Dónde continúan los docs

• Concepts: la arquitectura y el modelo de contenido detrás del builder.
• Authoring: el trabajo de contenido diario: páginas, posts, bloques, stacks, formularios, medios, documentos.
• Deploy & Backup: servir el sitio público (nginx/Caddy), mantenerlo al día y mantenerlo recuperable.
• Troubleshooting & API: referencias operativas cuando algo no cuadra, y la interfaz de máquina para scripts y herramientas de IA.