imba static site

ПРИМЕЧАНИЕ. Для новых проектов рекомендуется использовать более новую версию https://github.com/imba/imba-vite-template. Этот репозиторий останется альтернативой сборщику ESBuild, но может не увидеть много обновлений, поскольку мы сосредоточимся на продвижении Vite.

Сборка Imba для статического хостинга

Это отправная точка для статического размещения Imba. Его также можно использовать для создания собственного приложения Imba с помощью imbutter.

Исходный скрипт build.js находится здесь: https://gist.github.com/trafnar/05ebbf0f5193e69f998f41b154d18190.

Доступные сценарии

В каталоге проекта вы можете запустить:

npm start

Запускает приложение в режиме разработки. Откройте http://localhost:3000, чтобы просмотреть его в браузере.

Страница перезагрузится, если вы внесете изменения. Вы также увидите любые ошибки в консоли.

npm run build

Собирает приложение для производства в папке dist .

Обратите внимание, что dist/html — это статическая версия.

Развертывание

Страницы Гитхаба

TLDR

Создайте новый репозиторий GitHub и замените YOUR_NEW_GITHUB_REPO_URL URL-адресом нового репозитория.

 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

Чтобы найти URL-адрес, по которому был развернут ваш проект, перейдите на вкладку Pages в настройках вашего репозитория.

Объяснение

Для статического хостинга мы создаем файлы . как базёрл.

 npx imba build --baseurl . server.imba

Да, мы по-прежнему используем файл server.imba , хотя мы не будем использовать какие-либо серверные файлы.

Поскольку Github Pages по умолчанию использует Jekyll, пути, начинающиеся с подчеркивания (например, __assets__ ), не смогут загрузиться, поэтому нам нужно указать, что мы не хотим использовать Jekyll, выполнив:

 npx touch dist/public/.nojekyll

Как только все это будет решено, развертывание на страницах github станет очень простым с помощью npx gh-pages , который создаст новую ветку git с именем gh-pages и по умолчанию будет обслуживать наши файлы оттуда.

• Для наших целей важно указать --dotfiles , поскольку необходим файл .nojekyll .
• Мы также хотим использовать dist/public в качестве базового каталога.
• Поскольку нам не нужна ветка gh-pages для фактического контроля версий, я предпочитаю также использовать флаг --no-history .

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