BlazorStatic

Aproveche el poder de Blazor para crear sitios web estáticos.

Transforme su aplicación Blazor en un sitio estático.

? ¿Cómo funciona?

BlazorStatic pretende ser intuitivo y fácil de usar para la mayoría de los desarrolladores que han trabajado con cualquier tipo de marco de front-end, especialmente si ya trabaja con Blazor.

El sitio de BlazorStatic es un ejemplo de biblioteca con muchas funciones. Verifique el código fuente.

Al ejecutar su aplicación, BlazorStatic recupera el HTML de las páginas con HttpClient , envía archivos HTML y recursos a la carpeta output y desde allí puede implementarlo en cualquier servidor HTTP estándar o servicio de alojamiento.

Hay muchas opciones predeterminadas para simplificar el uso, pero puedes configurarlas ampliamente. Por ejemplo, puede hacer coincidir su contenido YAML en archivos de rebajas (que pueden reutilizarse desde otros generadores de sitios estáticos).

Empezando

Puede comenzar a utilizar BlazorStatic de tres formas, según su configuración y el uso previsto. Necesitará .NET SDK 8 o superior para comenzar.

? Forma recomendada

Instale las plantillas BlazorStatic:

dotnet new install BlazorStatic.Templates

Esto agrega nuevas opciones a su lista de dotnet new . Luego crea un nuevo proyecto usando:

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

Esto crea una carpeta y un proyecto MyBlazorStaticApp . Es una aplicación .NET Blazor estándar con el paquete BlazorStatic instalado, que incluye algunos componentes predefinidos, estilos y una publicación de blog con contenido de ejemplo.

Ejecute la aplicación usando dotnet watch . Esto iniciará la aplicación, lo que le permitirá verla en vivo y al mismo tiempo generará archivos HTML estáticos en la carpeta output .

Desde aquí, estará listo para explorar el proyecto, agregar contenido, crear nuevas páginas y más.

• Los archivos Markdown se encuentran en la carpeta Content/Blog .
• Se incluye un archivo .gitignore con las recomendaciones estándar de .NET e ignora la carpeta output .
• La plantilla también incluye una carpeta .github con una acción de GitHub para crear e implementar en páginas de GitHub. Consulte la sección Implementación a continuación.
• Puedes personalizar cualquier cosa. Para más detalles consulta este documento, que explica todo con más profundidad.

?‍➡️ La forma más rápida

Utilice BlazorStaticMinimalBlog como plantilla (el botón verde grande).

Copiará todo el contenido y ejecutará la acción de GitHub por usted. Después de que se ejecute, vaya a configuración y active las páginas de GitHub:

¡Tu página ya está lista!

Manera personalizada

Si desea comprender completamente cómo funciona BlazorStatic o si tiene un proyecto existente en el que le gustaría integrar la biblioteca BlazorStatic, comience desde cero. Consulte este documento para obtener orientación.

? Características

• Aproveche su experiencia Blazor existente.
• Analice y consuma fácilmente archivos de rebajas.
• Soporte para frontales YAML personalizados.
• Descubre automáticamente páginas entre archivos Razor.
• Posibilidad de agregar/eliminar páginas según sea necesario.
• Funciona con todos los marcos y temas CSS.
• Fácil de implementar con canalización de CI/CD.
• Soporta recarga en caliente
• Tiene dotnet new

? Implementando

Puede implementar la carpeta output en cualquier servicio de alojamiento estático, como GitHub Pages, Netlify, Vercel, Azure Static Web Apps, etc.

Las instrucciones detalladas están aquí.

Muestras

Descripción	Fuente	Vivir
Página sobre BlazorStatic (este repositorio contiene el código en sí)	fuente	vivir
Blog mínimo	fuente	vivir
Zodoc: muestra de procesamiento de imágenes y aprendizaje profundo	fuente	vivir
❓ Agrega tu página aquí!!!

? Contribuciones

Se alientan y aprecian mucho las contribuciones. Si encuentra algo que falta, no está claro o encuentra algún problema con el código, agradezco cordialmente sus comentarios. Siéntete libre de:

• Cree una nueva edición o envíe un PR.
• Comuníquese por correo electrónico: [email protected]
• Contáctame directamente para cualquier consulta o sugerencia.
• Haga preguntas o inicie una discusión en el servidor de Blazor Community Discord.