Cómo publicar una página Github

Github Pages permite a los desarrolladores alojar un sitio web estático de su proyecto de forma gratuita. Es una de las instalaciones clave de Github que ha hecho que el mantenimiento de proyectos gratuitos de código abierto sea más económico, especialmente para desarrolladores independientes..

Bootstrap y Normalize.css son un par de páginas populares de Github. Para crear uno, solo necesita crear una nueva rama de su repositorio de proyectos y llamarla páginas gh. Publicar la rama a Github..

Una vez que está listo, se puede acceder al sitio a través de la URL que se establece en relación con su nombre de usuario de Github y el nombre del repositorio. nombre de usuario .github.io / nombre del repositorio.

Puede configurar un dominio personalizado para su página Github. Lo hemos mostrado como hacerlo en nuestro tutorial anterior..

Páginas de Github simplificadas

Crear una página de Github es fácil y rápido. Pero, hay una pequeña advertencia.

Tome uno de los repositorios de demostración en nuestra cuenta de Github, Calendario de Adviento, por ejemplo. Tenemos dos sucursales - dominar y páginas gh que comparten exactamente el mismo de las ramas de código.

Tenemos que asegurarnos de que los códigos en páginas gh siempre están sincronizados con el dominar rama.

Afortunadamente, Github lo ha simplificado recientemente al eliminar el páginas gh requisito de la rama. Ahora podemos alimentar el sitio directamente a través de dominar rama.

Para hacerlo, vaya a cualquiera de las pantallas de configuración del repositorio de Github. Desplácese hasta la sección Páginas Github y seleccione la rama maestra menú de la selección.

Ya está todo listo y puede quitar con seguridad el páginas gh rama del repositorio.

Documentación de servicio

Algunos proyectos como Bootstrap, Foundation o Skeleton requieren una página de documentación. Y sus desarrolladores usualmente también sirven estas páginas de documentación a través de páginas gh documento.

Entonces, el repositorio ahora tiene dos sucursales con un conjunto de códigos y propósitos completamente diferentes; uno es el fuente principal, mientras que el otro documentaciones de host y también algunos fragmentos de código. En esta situación, a menudo puede encontrar conflictos de cambio al cambiar entre estas dos ramas.

Con este nuevo cambio de Github, los desarrolladores ahora pueden servir páginas de documentación a través de un nombre de carpeta / docs / dentro de dominar rama. Luego, vaya a las páginas de Github y seleccione la siguiente opción, carpeta de rama / docs principal.

Ahora, mantener el código fuente y la documentación se ha vuelto más estricto.