Hospedagem para Eleventy (11ty)

O Eleventy (11ty) pega seus templates e seu Markdown e escreve HTML simples em _site/, sem framework no lado do cliente, a menos que você adicione um. Uma pasta de arquivos simples é a coisa mais fácil de hospedar: rode o build, depois npx lobsite, e o site fica no ar num endereço *.lobsite.app com HTTPS. Você também pode soltar _site/ na caixa acima.

Como funciona

1. Faça o build do site com npx @11ty/eleventy (ou o seu npm run build). O Eleventy o escreve em _site/.
2. Rode npx lobsite no projeto. Ele encontra _site/ e publica. O primeiro deploy não precisa de conta e dura 6 horas.
3. Mantenha-o com o link de resgate, numa conta gratuita. A pasta fica salva no lobsite.toml, então os próximos deploys vão para o mesmo site.

Configurações do Eleventy que importam no Lobsite

// eleventy.config.js
export default function (eleventyConfig) {
  eleventyConfig.addPassthroughCopy("img");
  eleventyConfig.addPassthroughCopy("css");
}

export const config = {
  dir: { input: "src", output: "_site" },
};

• A passthrough copy é como imagens, fontes e CSS chegam a _site/. Um arquivo que não é template e não é copiado não será publicado, então, se algo faltar no site no ar, confira primeiro se está em _site/.
• pathPrefix continua em /: o site é servido a partir da raiz do endereço.
• A pasta de saída pode continuar _site. Se mudar, informe a pasta uma vez (npx lobsite ./dist) e ela fica lembrada no lobsite.toml.

Permalinks, imagens e arquivos antigos

O Eleventy escreve about.md como about/index.html, que abre em /about/; um permalink terminado em .html abre sem a extensão. Imagens processadas pelo @11ty/eleventy-img são escritas durante o build, então são publicadas como qualquer outro arquivo, e as que não mudaram não são enviadas de novo. Como a maioria dos geradores, o Eleventy não esvazia _site/ antes de um build: uma página renomeada deixa o arquivo antigo para trás. Apague _site/ antes do build (muitos starters fazem isso no script build) para publicar só as páginas atuais.

Hospedagens para Eleventy comparadas

O Netlify é há muito tempo a casa padrão dos sites Eleventy e faz o build a partir do Git. O Lobsite serve para você quando faz o build localmente ou no CI e quer o resultado no ar com um comando, de um terminal ou de um agente de IA, sem nada para configurar.

Perguntas frequentes

11ty é o mesmo que Eleventy?

Sim. 11ty é o nome curto do Eleventy, e o pacote é @11ty/eleventy. Tudo nesta página vale para os dois nomes.

Por que minhas imagens não aparecem no site Eleventy publicado?

Provavelmente elas não estão em _site/. Adicione uma passthrough copy para a pasta (eleventyConfig.addPassthroughCopy("img")), faça o build de novo e publique.

A renderização serverless ou edge do Eleventy funciona no Lobsite?

Não. O Lobsite serve os arquivos em _site/; recursos que renderizam páginas a cada requisição precisam de uma hospedagem que rode funções. Páginas geradas antes, que são a maioria dos sites Eleventy, funcionam todas.

Posso dar ao meu site Eleventy uma página 404 própria?

Sim. Crie um template com permalink: 404.html; o Lobsite o serve com status 404 para qualquer endereço que não exista.