BlazorStatic

Aproveite o poder do Blazor para criar sites estáticos.

Transforme seu aplicativo Blazor em um site estático.

? Como funciona?

BlazorStatic pretende ser intuitivo e fácil de usar para a maioria dos desenvolvedores que trabalharam com qualquer tipo de framework front-end, especialmente se você já trabalha com Blazor.

O site BlazorStatic é um exemplo de biblioteca rico em recursos. Verifique o código-fonte.

Ao executar seu aplicativo, BlazorStatic busca o HTML das páginas com HttpClient , gera arquivos HTML e ativos para a pasta output e, a partir daí, você pode implantar em qualquer servidor HTTP padrão ou serviço de hospedagem.

Existem muitos padrões para manter o uso simples, mas você pode configurá-lo extensivamente. Por exemplo, você pode combinar seu front-main YAML em arquivos markdown (que podem ser reutilizados em outros geradores de sites estáticos).

Começando

Você pode começar a usar o BlazorStatic de três maneiras, dependendo da configuração e do uso pretendido. Você precisará do .NET SDK 8 ou superior para começar.

? Maneira recomendada

Instale os modelos BlazorStatic:

dotnet new install BlazorStatic.Templates

Isso adiciona novas opções à sua dotnet new . Em seguida, crie um novo projeto usando:

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

Isso cria uma pasta e um projeto MyBlazorStaticApp . É um aplicativo .NET Blazor padrão com o pacote BlazorStatic instalado, incluindo alguns componentes predefinidos, estilos e uma postagem de blog com conteúdo de exemplo.

Execute o aplicativo usando dotnet watch . Isso iniciará o aplicativo, permitindo que você o visualize ao vivo, ao mesmo tempo que gera arquivos HTML estáticos na pasta output .

A partir daqui, você estará pronto para explorar o projeto, adicionar conteúdo, criar novas páginas e muito mais.

• Os arquivos Markdown estão localizados na pasta Content/Blog .
• Um arquivo .gitignore está incluído nas recomendações padrão do .NET e ignora a pasta output .
• O modelo também inclui uma pasta .github com uma ação do GitHub para construir e implantar nas páginas do GitHub. Consulte a seção Implantação abaixo.
• Você pode personalizar qualquer coisa. Para mais detalhes, consulte este documento, que explica tudo com mais detalhes.

?‍➡️ Maneira mais rápida

Use BlazorStaticMinimalBlog como modelo (o grande botão verde).

Ele copiará todo o conteúdo e executará a ação do GitHub para você. Após a execução, acesse as configurações e ative as páginas do GitHub:

Sua página está pronta agora!

Maneira personalizada

Se você quiser entender completamente como funciona o BlazorStatic ou se tiver um projeto existente onde gostaria de integrar a biblioteca BlazorStatic, comece do zero. Confira este documento para orientação.

? Características

• Aproveite sua experiência existente com o Blazor.
• Analise e consuma facilmente arquivos markdown.
• Suporte para assuntos frontais YAML personalizados.
• Descobre automaticamente páginas entre arquivos Razor.
• Capacidade de adicionar/remover páginas conforme necessário.
• Funciona com todas as estruturas e temas CSS.
• Fácil de implantar com pipeline de CI/CD.
• Suporta HotReload
• Tem dotnet new

? Implantando

Você pode implantar a pasta output em qualquer serviço de hospedagem estática, como GitHub Pages, Netlify, Vercel, Azure Static Web Apps, etc.

Instruções detalhadas estão aqui.

Amostras

Descrição	Fonte	Ao vivo
Página sobre BlazorStatic (este repositório contém o próprio código)	fonte	ao vivo
Blog mínimo	fonte	ao vivo
Zodoc - exemplo de processamento de imagem e aprendizado profundo	fonte	ao vivo
❓ Adicione sua página aqui!!!

? Contribuições

As contribuições são altamente encorajadas e apreciadas. Se você encontrar algo faltando, não estiver claro ou encontrar um problema com o código, agradeço calorosamente sua opinião. Sinta-se à vontade para:

• Crie um novo problema ou envie um PR.
• Entre em contato por e-mail: [email protected]
• Contate-me diretamente para qualquer dúvida ou sugestão.
• Faça perguntas ou inicie uma discussão no servidor Blazor Community Discord.