Acerca de GitHub Pages
GitHub Pages es un servicio de alojamiento de sitio estático que toma archivos HTML, CSS y JavaScript directamente desde un repositorio en GitHub AE, opcionalmente ejecuta los archivos a través de un proceso de complilación y publica un sitio web. Puede ver ejemplos de sitios de GitHub Pages en la colección de ejemplos de GitHub Pages.
Para empezar, consulta "Crear un sitio de Páginas de GitHub".
Tipos de sitios GitHub Pages
Existen tres tipos básicos de GitHub Pages sitios: de proyecto, de usuario y de la organización. Los sitios de proyecto están conectados coon un proyecto específico alojado en GitHub AE, como una biblioteca JavaScript o una colección de recetas. Los sitios de usuario y de organización se conectan a una cuenta específica en GitHub AE.
Para publicar un sitio de usuario, debes crear un repositorio propiedad de la cuenta personal denominado <username>.<hostname>. Para publicar un sitio de organización, debe crear un repositorio propiedad de una organización denominado <organization>.<hostname>. Los sitios de usuario y organización están disponibles en http(s)://pages.<hostname>/<username> o http(s)://pages.<hostname>/<organization>.
Los archivos fuente para un sitio de proyecto se almacenan en el mismo repositorio que su proyecto. Los sitios de proyecto están disponibles en http(s)://pages.<hostname>/<username>/<repository>/ o http(s)://pages.<hostname>/<organization>/<repository>/.
Solo puedes crear un sitio de organización o de usuario para cada cuenta en GitHub AE. Los sitios de proyectos, ya sean propiedad de una cuenta de organización o personal, son ilimitados.
Publicar fuentes para sitios de GitHub Pages
Advertencia: Los sitios de GitHub Pages son visibles para todos los miembros de la empresa, incluso si el repositorio del sitio es privado. Si tienes datos confidenciales en el repositorio del sitio, tal vez te interese eliminarlos antes de publicarlo. Para obtener más información, vea «Acerca de los repositorios».
Tu sitio de GitHub Pages se publicará cuando se inserten cambios en una rama específica. Puedes especificar qué rama y carpeta usar como origen de publicación. La rama de origen puede ser cualquier rama del repositorio y la carpeta de origen puede ser la raíz del repositorio (/) de la rama de origen o una carpeta /docs de la rama de origen. Cuando se insertan cambios en la rama de origen, los cambios en la carpeta de origen se publicarán en el sitio de GitHub Pages.
Para obtener más información, vea «Configurar una fuente de publicación para tu sitio de Páginas de GitHub».
Generadores de sitios estáticos
GitHub Pages publica cualquier archivo estático que subas a tu repositorio. Puedes crear tus propios archivos estáticos o usar un generador de sitios estáticos para que desarrolle tu sitio. También puedes personalizar tu propio proceso de compilación de forma local o en otro servidor.
Recomendamos Jekyll, un generador de sitio estático con soporte integrado para GitHub Pages y un proceso de compilación simplificado. Para obtener más información, vea «Acerca de las Páginas de GitHub y Jekyll».
GitHub Pages usará Jekyll para compilar tu sitio por defecto. Si quiere usar un generador de sitios estáticos diferente a Jekyll, desactive el proceso de compilación de Jekyll mediante la creación de un archivo vacío denominado .nojekyll en la raíz de la fuente de publicación y, después, siga las instrucciones del generador de sitios estáticos para desarrollar el sitio localmente.
GitHub Pages no soporta idiomas del lado del servidor como PHP, Ruby o Python.
Límites de uso de GitHub Pages
Los sitios de GitHub Pages no pretende ser un servicio de hospedaje web gratuito ni permite que se use de ese modo para realizar negocios en línea, un sitio de comercio electrónico, o cualquier otro sitio web que esté principalmente dirigido a facilitar operaciones comerciales o proporcionar software comercial como un servicio (SaaS). Los sitios GitHub Pages no se deben usar para realizar transacciones que impliquen el envío de información confidencial como contraseñas o números de tarjeta de crédito.
Adicionalmente, el uso de GitHub Pages está sujeto a los Términos del servicio de GitHub, incluidas las restricciones de planes para enriquecerse rápidamente, el contenido sexualmente obsceno y la actividad o contenido amenazantes o violentos.
Ejercicios educativos
No se prohíbe el uso de GitHub Pages para crear una copia de un sitio web existente como ejercicio de aprendizaje. Sin embargo, además de cumplir con los Términos del servicio de GitHub, debes escribir el código por ti mismo, el sitio no debe recopilar ningún dato de usuario, y debes incluir una renuncia de responsabilidad destacada en el sitio que indique que el proyecto no está asociado con el original y que solo se creó para fines educativos.
Límites de uso
los sitios GitHub Pages están sujetos a los siguientes límites de uso:
- Los repositorios de código fuente de GitHub Pages tienen un límite recomendado de 1 GB.
- Los sitios de GitHub Pages publicados no pueden ser mayores a 1 GB.
- Las implementaciones de GitHub Pages expirarán si toman más de 10 minutos.
Tipos MIME en GitHub Pages
Un tipo MIME es un encabezado que un servidor envía a un navegador, proporcionando información sobre la naturaleza y el formato de los archivos que solicitó el navegador. GitHub Pages soporta más de 750 tipos MIME entre las miles de extensiones de archivo. La lista de tipos MIME admitidos se genera a partir del proyecto mime-db.
Si bien no puedes especificar los tipos de MIME personalizados en una base por perfil o por repositorio, puedes agregar o modificar los tipos de MIME para usar en GitHub Pages. Para más información, vea las instrucciones de contribución de mime-db.
Información adicional
- GitHub Pages en GitHub Skills
- "Repositorios"