imba static site

NOTA: O https://github.com/imba/imba-vite-template mais recente é recomendado para novos projetos. Este repositório permanecerá como uma alternativa ao empacotador ESBuild, mas poderá não ver muitas atualizações à medida que nos concentramos no futuro do Vite.

Construindo Imba para hospedagem estática

Este é um ponto de partida para a construção do Imba ser hospedado estaticamente. Ele também pode ser usado para transformar o Imba em um aplicativo nativo com imbutter.

O script build.js original está aqui: https://gist.github.com/trafnar/05ebbf0f5193e69f998f41b154d18190

Scripts Disponíveis

No diretório do projeto, você pode executar:

npm start

Executa o aplicativo no modo de desenvolvimento. Abra http://localhost:3000 para visualizá-lo no navegador.

A página será recarregada se você fizer edições. Você também verá erros de lint no console.

npm run build

Cria o aplicativo para produção na pasta dist .

Observe que dist/html é a versão estática.

Implantação

Páginas do GitHub

TLDR

Crie um novo repositório github e substitua YOUR_NEW_GITHUB_REPO_URL pelo URL do seu novo repositório.

 npx imba create project_name
cd project_name
git add --all
git commit -m "initial commit"
git remote add origin YOUR_NEW_GITHUB_REPO_URL
git push -u origin main

npx imba build --baseurl . server.imba
npx touch dist/public/.nojekyll
npx gh-pages --no-history --dotfiles --dist dist/public

Para encontrar a URL na qual seu projeto foi implantado, navegue até a guia Pages nas configurações do seu repositório.

Explicação

Para hospedagem estática, construímos usando . como o URL base.

 npx imba build --baseurl . server.imba

Sim, ainda construímos usando o arquivo server.imba mesmo que não usemos nenhum dos arquivos do lado do servidor.

Como o Github Pages usa Jekyll por padrão, os caminhos que começam com sublinhados (como __assets__ ) não serão carregados, então precisamos especificar que não queremos usar Jekyll fazendo:

 npx touch dist/public/.nojekyll

Depois que tudo isso for resolvido, a implantação nas páginas do github é realmente fácil com npx gh-pages , que criará uma nova ramificação git chamada gh-pages e servirá nossos arquivos a partir daí por padrão.

• Para nossos propósitos, é importante especificar --dotfiles por causa do arquivo .nojekyll necessário.
• Também queremos usar dist/public como diretório base.
• Como não precisamos do branch gh-pages para o controle de versão real, prefiro usar o sinalizador --no-history também.

 npx gh-pages --no-history --dotfiles --dist dist/public