Acerca de GitHub Pages

Puedes usar Páginas de GitHub para albergar un sitio web sobre ti mismo, tu organización o tu proyecto directamente desde un repositorio GitHub AE.

Páginas de GitHub Está disponible en los repositorios internos y privados con GitHub AE. Páginas de GitHub se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server.

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 AE, 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 AE, 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 AE.

Para publicar un sitio de usuario, debes crear un repositorio que pertenezca a tu cuenta de usuario que se llame <username>.<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 sitios de organizaciones y usuarios se encuentran 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 se encuentran 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 de de usuario, son ilimitados.

Publicar fuentes para sitios Páginas de GitHub

La fuente de publicación para tu sitio de Páginas de GitHub es la rama y carpeta en donde se almacenan los archivos fuente de tu sitio.

Advertencia: Si tu administrador de sitio habilitó las Páginas Públicas, Los sitios de Páginas de GitHub estarán disponibles al público en general en la internet, incluso si el repositorio del sitio es privado o interno. Si tienes datos sensibles en el repositorio de tu sitio, puede que quieras eliminar los datos antes de publicarlo. Para obtener más información, consulta las secciones "Configurar Páginas de GitHub para tu empresa" y "Acerca de los repositorios".

Si la fuente de publicación predeterminada existe en tu repositorio, Páginas de GitHub publicará automáticamente un sitio desde esta fuente. La fuente de publicación predeterminada para los sitios de usuario y de organización es la raíz de la rama predeterminada para el repositorio. La fuente de publicación predeterminada para los sitios de proyecto es la raíz de la rama gh-pages.

Si quieres mantener los archivos fuente para tu sitio en una ubicación distinta, puedes cambiar la fuente de publicación para tu sitio. Puedes publicar tu sitio desde cualquier rama en el repositorio, ya sea desde la raíz del repositorio en esa rama, /, o desde la carpeta de /docs en ella. Para obtener más información, consulta "Configurar una fuente de publicación para tu sitio Páginas de GitHub".

Si eliges la carpeta de /docs o cualquier rama como tu fuente de publicación, Páginas de GitHub leerá todo para publicar tu sitio desde la carpeta de /docs.

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 la sección "Acerca de Páginas de GitHub y de 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

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.