Primeiros Passos

Tudo o que você precisa para ir do zero até uma página publicada: o que é o Chinaski, que máquina ele precisa, como a instalação funciona e as primeiras coisas a clicar assim que você entrar no admin. Cada seção é curta e voltada para a etapa que cobre; a referência mais profunda fica nas páginas linkadas.

O caminho de leitura

1. O Que É o Chinaski: a versão de um parágrafo: um CMS auto-hospedado + construtor de sites estáticos. Conteúdo em SQLite, admin em Perl, o site público em HTML puro servido por um servidor web.

2. Como Funciona: o modelo de dois programas (aplicação CMS + construtor estático), por que os builds são explícitos e por que o servidor web nunca conversa com o CMS no caminho público.

3. Requisitos: a checklist honesta: um servidor Debian/Ubuntu, Perl 5.26+, SQLite; orientações de dimensionamento e os dois caminhos de instalação (one-liner online ou bundle offline).

4. Instalação: os passos reais de instalação.

5. Quickstart: o caminho de cinco minutos: instalar, trocar a senha de setup, criar uma página, fazer build, publicar.

6. Tour pelo Admin: um mapa da área de administração: onde ficam páginas, posts, blocos, stacks, formulários, mídia, documentos, configurações e as telas de saúde.

7. Sua Primeira Página: caminhando de uma lista de páginas em branco até uma página publicada no site construído (rascunho → publicar → build → verificar).

8. Glossário: o vocabulário (blocos, stacks, snippets, promotion guard, trash vs. delete) para que o resto da documentação seja lido mais rápido.

As três decisões antes de começar

Alguns minutos de escolhas evitam retrabalho depois. Estas são as únicas decisões de configuração que realmente moldam uma nova instância:

• Nome da instância: um servidor pode rodar várias instâncias do Chinaski lado a lado (chinaski@1, chinaski@prod, ...). O nome aparece para sempre nos caminhos de instalação, nos nomes de serviço e nos destinos de backup.
• Idiomas: a lista de idiomas configurada define os formatos de URL (path vs. none vs. subdomain) e as árvores por idioma. Defina o conjunto de idiomas antes da importação de conteúdo: cada linha de conteúdo pertence a exatamente um idioma.
• Offline ou conectado: a chave de air-gap vem ativada por padrão em instalações novas. Decida antes da primeira inicialização se a instância deve alcançar a internet (e-mail, webhooks, verificações de atualização, Spaces) ou nunca deve; o modo air-gap vem habilitado por padrão por um motivo, e desativá-lo é uma escolha deliberada.

O que "instalado" significa aqui

O Chinaski é auto-hospedado por design: você é dono do servidor, do banco de dados e dos backups. O instalador faz o trabalho pesado (pacotes do sistema, dependências, um usuário de sistema chinaski, um banco de dados SQLite inicializado, um arquivo env com um segredo gerado e uma unit do systemd), e a primeira requisição leva você a uma página de setup obrigatória, onde você substitui a senha provisória de admin (com exigência: 12+ caracteres com maiúsculas, minúsculas e dígitos). Depois disso, a interface de administração é sua; nada envia dados para fora, e nenhum outro passo de instalação é necessário.

Onde a documentação continua

• Concepts: a arquitetura e o modelo de conteúdo por trás do builder.
• Authoring: o trabalho de conteúdo do dia a dia: páginas, posts, blocos, stacks, formulários, mídia, documentos.
• Deploy & Backup: servir o site público (nginx/Caddy), mantê-lo atualizado e mantê-lo recuperável.
• Troubleshooting & API: referências operacionais para quando algo não se encaixa, e a interface de máquina para scripts e ferramentas de IA.