imba static site

HINWEIS: Für neue Projekte wird das neuere https://github.com/imba/imba-vite-template empfohlen. Dieses Repo bleibt als ESBuild-Bundler-Alternative bestehen, wird aber möglicherweise nicht viele Updates erhalten, da wir uns auf die Weiterentwicklung von Vite konzentrieren.

Erstellen von Imba für statisches Hosting

Dies ist ein Ausgangspunkt für den Aufbau von Imba, das statisch gehostet werden soll. Es kann auch verwendet werden, um Imba mit Imbutter in eine native App zu integrieren.

Das ursprüngliche build.js -Skript finden Sie hier: https://gist.github.com/trafnar/05ebbf0f5193e69f998f41b154d18190

Verfügbare Skripte

Im Projektverzeichnis können Sie Folgendes ausführen:

npm start

Führt die App im Entwicklungsmodus aus. Öffnen Sie http://localhost:3000, um es im Browser anzuzeigen.

Die Seite wird neu geladen, wenn Sie Änderungen vornehmen. Eventuelle Flusenfehler werden Ihnen auch in der Konsole angezeigt.

npm run build

Erstellt die App für die Produktion im dist -Ordner.

Beachten Sie, dass dist/html die statische Version ist.

Einsatz

Github-Seiten

TLDR

Erstellen Sie ein neues Github-Repository und ersetzen Sie YOUR_NEW_GITHUB_REPO_URL durch die URL Ihres neuen Repos.

 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

Um die URL zu finden, unter der Ihr Projekt bereitgestellt wurde, navigieren Sie in den Einstellungen Ihres Repositorys zur Registerkarte Pages “.

Erläuterung

Für statisches Hosting verwenden wir . als Basis-URL.

 npx imba build --baseurl . server.imba

Ja, wir erstellen weiterhin mit der Datei server.imba , auch wenn wir keine der serverseitigen Dateien verwenden.

Da Github Pages standardmäßig Jekyll verwendet, können Pfade, die mit Unterstrichen beginnen (wie __assets__ ), nicht geladen werden. Daher müssen wir angeben, dass wir Jekyll nicht verwenden möchten, indem wir Folgendes tun:

 npx touch dist/public/.nojekyll

Sobald das alles geklärt ist, ist die tatsächliche Bereitstellung auf Github-Seiten mit npx gh-pages ganz einfach, das einen neuen Git-Zweig namens gh-pages erstellt und unsere Dateien standardmäßig von dort aus bereitstellt.

• Für unsere Zwecke ist es aufgrund der erforderlichen .nojekyll Datei wichtig, --dotfiles anzugeben.
• Wir möchten auch dist/public als Basisverzeichnis verwenden.
• Da wir den gh-pages -Zweig nicht für die eigentliche Versionskontrolle benötigen, bevorzuge ich auch die Verwendung des Flags --no-history .

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