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 Enterprise Server, 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, vea "Creación de un sitio de GitHub Pages".
Los propietarios de la organización pueden deshabilitar la publicación de sitios de GitHub Pages desde los repositorios de la organización. Para más información, vea "Administración de la publicación de sitios de GitHub Pages para la organización".
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 Enterprise Server, como una biblioteca JavaScript o una colección de recetas. Los sitios de organización y de usuario se conectan a una cuenta específica en your GitHub Enterprise Server instance.
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 archivos fuente para un sitio de proyecto se almacenan en el mismo repositorio que su proyecto.
Solo puedes crear un sitio de organización o de usuario para cada cuenta en GitHub Enterprise Server. Los sitios de proyectos, ya sean propiedad de una cuenta de organización o personal, son ilimitados.
La URL donde está disponible el sitio depende de si el aislamiento de subdominios está habilitado para your GitHub Enterprise Server instance.
| Tipo de sitio | Aislamiento de subdominio habilitado | Aislamiento de subdominio inhabilitado |
|---|---|---|
| Usuario | http(s)://pages.<hostname>/<username> | http(s)://<hostname>/pages/<username> |
| Organización | http(s)://pages.<hostname>/<organization> | http(s)://<hostname>/pages/<organization> |
| Sitio del proyecto propiedad de la cuenta personal | http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ |
| Sitio de proyecto propiedad de la cuenta de organización | http(s)://pages.<hostname>/<orgname>/<repository>/ | http(s)://<hostname>/pages/<orgname>/<repository>/ |
Para más información, vea "Habilitación del aislamiento de subdominios" o póngase en contacto con el administrador del sitio.
Publicar fuentes para sitios de GitHub Pages
Advertencia: Si el administrador del sitio ha habilitado Pages público, los sitios de GitHub Pages estarán disponibles públicamente en Internet, incluso si el repositorio del sitio es privado o interno. Si tienes datos confidenciales en el repositorio del sitio, tal vez te interese eliminarlos antes de publicarlo. Para obtener más información, consulta "Configuración de GitHub Pages para la empresa" y "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 más información, consulta "Configuración de una fuente de publicación para el sitio de GitHub Pages."
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 más información, vea "Acerca de GitHub Pages 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.
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.
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
- "GitHub Pages"