Acerca de Páginas de GitHub
Páginas de GitHub es un servicio de alojamiento de sitio estático que toma archivos HTML, CSS y JavaScript directamente desde un repositorio en GitHub Enterprise, opcionalmente ejecuta los archivos a través de un proceso de complilación y publica un sitio web. Puedes ver ejemplos de sitios de Páginas de GitHub en la recopilación de ejemplos de Páginas de GitHub.
Para empezar, vea "Creando un sitio Páginas de GitHub."
Tipos de sitios Páginas de GitHub
Existen tres tipos básicos de Páginas de GitHub 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, como una biblioteca JavaScript o una colección de recetas. Los sitios de usuario y organización están conectados a una cuenta específica de GitHub Enterprise.
Para publicar un sitio de usuario debes crear un repositorio que pertenezca a tu cuenta de usuario y se llame <user>.<hostname>. Para publicar un sitio de organización debes crear un repositorio que pertenezca a una organización y que se llame <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 usuario u organización para cada cuenta de GitHub Enterprise. Los sitios de proyectos, ya sean propiedad de una cuenta de organización de de usuario, son ilimitados.
La URL donde tu sitio está disponible depende de si el aislamiento del subdominio está habilitado para tu instancia de servidor de GitHub Enterprise.
| Tipo de sitio | Aislamiento de subdominio habilitado | Aislamiento de subdominio inhabilitado |
|---|---|---|
| Usuario |
http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ | Organization | http(s)://pages.<hostname>/<organization>/<repository>/ | http(s)://<hostname>/pages/<organization>/<repository>/ | Sitio del proyecto que pertenece a la cuenta del usuario | http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ Sitio del proyecto que pertenece a la cuenta de la organización | http(s)://pages.<hostname>/<orgname>/<repository>/ | http(s)://<hostname>/pages/<orgname>/<repository>/
Para obtener más información, consulta "Habilitar el aislamiento del subdominio" o comunícate con el administrador del sitio.
Publicar fuentes para sitios de Páginas de GitHub
The publishing source for your Páginas de GitHub site is the branch and folder where the source files for your site are stored. All sites have a default publishing source, and project sites have additional publishing sources available.
Advertencia:Si tu administrador de sitio ha habilitado las Páginas Públicas, los sitios Páginas de GitHub serán accesibles al público en general en internet, aún si sus repositorios son privados. Si tienes datos sensibles en el repositorio de tu sitio, tal vez quieras eliminarlos antes de publicarlo. Para obtener más información, consulta la sección "Configurar Páginas de GitHub en tu aplicativo" y "Acerca de la visibilidad de un repositorio".
La fuente de publicación predeterminada para los sitios de usuario y organización es la rama principal. Si el repositorio para tu sitio de usuario u organización tiene una rama principal, tu sitio se publicará automáticamente desde esa rama. No puedes elegir una fuente de publicación diferente para sitios de usuario u organización.
La fuente de publicación predeterminada para un sitio de proyecto es la rama gh-pages. Si el repositorio para tu sitio de proyecto tiene una rama gh-pages, tu sitio se publicará automáticamente desde esa rama.
Los sitios del proyecto también pueden publicarse desde la rama principal o una carpeta /docs en la rama master. Para publicar tu sitio desde una de estas fuentes, debes configurar una fuente de publicación diferente. Para obtener más información, consulta "Configurar una fuente de publicación para tu sitio Páginas de GitHub".
Si eliges la carpeta /docs de la rama principal como tu fuente de publicación, Páginas de GitHub leerá todo para publicar tu sitio desde la carpeta /docs.
No puedes publicar tu sitio de proyecto desde ninguna otra rama, aún si la rama predeterminada es diferente a master o gh-pages.
Generadores de sitios estáticos
Páginas de GitHub 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 Páginas de GitHub y un proceso de compilación simplificado. Para obtener más información, consulta "Acerca de las Páginas de GitHub y Jekyll".
Páginas de GitHub usará Jekyll para compilar tu sitio por defecto. Si deseas usar un generador de sitio estático diferente a Jekyll, desactiva el proceso de compilación de Jekyll creando un archivo vacío denominado `en la raíz de tu fuente de publicación, luego seguir las instrucciones del generador de sitio estático para desarrollar tu sitio localmente.
Páginas de GitHub no soporta idiomas del lado del servidor como PHP, Ruby o Python.
Guías para usar Páginas de GitHub
los sitios Páginas de GitHub están sujetos a los siguientes límites de uso:
- Los repositorios de fuente de Páginas de GitHub tienen un límite recomendado de 1 GB.
- Los sitios de Páginas de GitHub publicados no pueden ser mayores a 1 GB.
Tipos MIME en Páginas de GitHub
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. Páginas de GitHub soporta más de 750 tipos MIME entre las miles de extensiones de archivo. La lista de los tipos de MIME compatibles se genera desde el mime-db project.
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 Páginas de GitHub. Para obtener más información, consulta los lineamientos de contribución de mime-db.
Leer más
- Páginas de GitHub en Laboratorio de aprendizaje de GitHub
- "Páginas de GitHub"