imba static site

REMARQUE : le plus récent https://github.com/imba/imba-vite-template est recommandé pour les nouveaux projets. Ce référentiel restera disponible en tant qu'alternative au bundle ESBuild, mais ne verra peut-être pas beaucoup de mises à jour alors que nous nous concentrons sur Vite à l'avenir.

Construire Imba pour l'hébergement statique

C'est un point de départ pour créer Imba qui doit être hébergé de manière statique. Il peut également être utilisé pour intégrer Imba dans une application native avec imbutter.

Le script build.js original est ici : https://gist.github.com/trafnar/05ebbf0f5193e69f998f41b154d18190

Scripts disponibles

Dans le répertoire du projet, vous pouvez exécuter :

npm start

Exécute l'application en mode développement. Ouvrez http://localhost:3000 pour l'afficher dans le navigateur.

La page se rechargera si vous apportez des modifications. Vous verrez également des erreurs de charpie dans la console.

npm run build

Construit l'application pour la production dans le dossier dist .

Notez que dist/html est la version statique.

Déploiement

Pages GitHub

TLDR

Créez un nouveau référentiel github et remplacez YOUR_NEW_GITHUB_REPO_URL par l'URL de votre nouveau dépôt.

 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

Pour trouver l'URL sur laquelle votre projet a été déployé, accédez à l'onglet Pages des paramètres de votre dépôt.

Explication

Pour l'hébergement statique, nous construisons en utilisant . comme le baseurl.

 npx imba build --baseurl . server.imba

Oui, nous construisons toujours en utilisant le fichier server.imba même si nous n'utiliserons aucun des fichiers côté serveur.

Étant donné que Github Pages utilise Jekyll par défaut, les chemins commençant par des traits de soulignement (comme __assets__ ) ne se chargeront pas, nous devons donc préciser que nous ne voulons pas utiliser Jekyll en faisant :

 npx touch dist/public/.nojekyll

Une fois que tout cela est réglé, le déploiement sur les pages github est vraiment simple avec npx gh-pages , qui créera une nouvelle branche git nommée gh-pages et servira nos fichiers à partir de là par défaut.

• Pour nos besoins, il est important de spécifier --dotfiles en raison du fichier .nojekyll nécessaire.
• Nous souhaitons également utiliser dist/public comme répertoire de base.
• Puisque nous n'avons pas besoin de la branche gh-pages pour le contrôle de version réel, je préfère également utiliser l'indicateur --no-history .

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