BlazorStatic

Используйте возможности Blazor для создания статических веб-сайтов.

Превратите свое приложение Blazor в статический сайт.

? Как это работает?

BlazorStatic стремится быть интуитивно понятным и простым в использовании для большинства разработчиков, которые работали с любой внешней платформой, особенно если вы уже работаете с Blazor.

Сайт BlazorStatic представляет собой многофункциональный пример библиотеки. Проверьте исходный код.

После запуска вашего приложения BlazorStatic извлекает HTML-код страниц с помощью HttpClient , выводит HTML-файлы и ресурсы в output папку, и оттуда вы можете выполнить развертывание на любом стандартном HTTP-сервере или службе хостинга.

Существует множество настроек по умолчанию, которые упрощают использование, но вы можете настроить их более широко. Например, вы можете сопоставить свой заголовок YAML с файлами уценки (которые можно повторно использовать из других генераторов статических сайтов).

Начиная

Вы можете начать использовать BlazorStatic тремя способами, в зависимости от ваших настроек и предполагаемого использования. Для начала вам понадобится .NET SDK 8 или более поздней версии.

? Рекомендуемый способ

Установите шаблоны BlazorStatic:

dotnet new install BlazorStatic.Templates

Это добавит новые параметры в список dotnet new . Затем создайте новый проект, используя:

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

При этом создается папка и проект MyBlazorStaticApp . Это стандартное приложение .NET Blazor с установленным пакетом BlazorStatic, включающим несколько предопределенных компонентов, стилей и запись в блоге с примером содержимого.

Запустите приложение с помощью dotnet watch . Это запустит приложение, что позволит вам просмотреть его в реальном времени, а также сгенерировать статические HTML-файлы в output папке.

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

• Файлы Markdown расположены в папке Content/Blog .
• Файл .gitignore включен в стандартные рекомендации .NET и игнорирует output папку.
• Шаблон также включает папку .github с действием GitHub для создания и развертывания на страницах GitHub. См. раздел «Развертывание» ниже.
• Вы можете настроить что угодно. Более подробную информацию можно найти в этом документе, где все объясняется более подробно.

?‍➡️ Самый быстрый способ

Используйте BlazorStaticMinimalBlog в качестве шаблона (большая зеленая кнопка).

Он скопирует весь контент и запустит действие GitHub. После запуска перейдите в настройки и включите страницы GitHub:

Ваша страница готова!

Пользовательский способ

Если вы хотите полностью понять, как работает BlazorStatic, или если у вас есть существующий проект, в который вы хотите интегрировать библиотеку BlazorStatic, начните с нуля. Ознакомьтесь с этим документом для получения инструкций.

? Функции

• Используйте свой существующий опыт Blazor.
• Легко анализируйте и используйте файлы уценки.
• Поддержка пользовательских фронтальных вопросов YAML.
• Автоматически обнаруживает страницы среди файлов Razor.
• Возможность добавлять/удалять страницы по мере необходимости.
• Работает со всеми фреймворками и темами CSS.
• Легко развертывается с помощью конвейера CI/CD.
• Поддерживает горячую перезагрузку
• Имеет dotnet new

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

Вы можете развернуть output папку в любой статической службе хостинга, например GitHub Pages, Netlify, Vercel, Azure Static Web Apps и т. д.

Подробные инструкции здесь.

Образцы

Описание	Источник	Жить
Страница о BlazorStatic (этот репозиторий содержит сам код)	источник	жить
Минимальный блог	источник	жить
Zodoc — образец обработки изображений и глубокого обучения	источник	жить
❓Добавьте сюда свою страницу!!!

? Взносы

Вклад очень поощряется и ценится. Если вы обнаружите, что что-то отсутствует, неясно или столкнулись с проблемой в коде, я горячо приветствую ваше мнение. Не стесняйтесь:

• Создайте новый выпуск или отправьте PR.
• Свяжитесь с нами по электронной почте: [email protected].
• Свяжитесь со мной напрямую по любым вопросам или предложениям.
• Задавайте вопросы или начинайте обсуждение на сервере Discord сообщества Blazor.