Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

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.

Páginas de GitHub se encuentra disponible en repositorios públicos con GitHub Free y GitHub Free para organizaciones, y en repositorios privados y públicos con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y Servidor de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

En este artículo

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

Puedes alojar tu sitio en el dominio github.io de GitHub o en tu propio dominio personalizado. Para obtener más información, consulta "Usar un dominio personalizado con Páginas de GitHub".

Para empezar, vea "Creando un sitio Páginas de GitHub."

Organization owners can disable the publication of Páginas de GitHub sites from the organization's repositories. For more information, see "Disabling publication of Páginas de GitHub sites for your organization."

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

Para publicar un sitio de usuario debes crear un repositorio que pertenezca a tu cuenta de usuario y se llame <user>.github.io. Para publicar un sitio de organización debes crear un repositorio que pertenezca a una organización y que se llame <organization>.github.io. A menos que esté usando un dominio personalizado, los sitios de usuario y de organización están disponibles en http(s)://<username>.github.io o http(s)://<organization>.github.io.

Los archivos fuente para un sitio de proyecto se almacenan en el mismo repositorio que su proyecto. A menos que esté usando un dominio prsonalizado, los sitios del proyecto están disponibles en http(s)://<user>.github.io/<repository> o http(s)://<organization>.github.io/<repository>.

Para obtener más información sobre cómo los dominios personalizados afectan a la URL de tu sitio, consulta "Acerca de los dominios personalizados y Páginas de GitHub".

Solo puedes crear un sitio de usuario u organización para cada cuenta de GitHub. Los sitios de proyectos, ya sean propiedad de una cuenta de organización de de usuario, son ilimitados.

Nota: Los repositorios que usan el esquema de nombres <user>.github.com heredado seguirán publicándose, pero los visitantes serán redirigidos desde http(s)://<username>.github.com hasta http(s)://<username>.github.io. Si existen tanto un repositorio <user>.github.com como <user>.github.io, solo el repositorio <user>.github.io será publicado.

Publicar fuentes para sitios 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.

Warning: Páginas de GitHub sites are publicly available on the internet, even if the repository for the site is private or internal. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see "About repository visibility."

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, incluyendo el archivo CNAME, desde la carpeta de /docs. Por ejemplo, cuando editas tu dominio personalizado a través de la configuración de Páginas de GitHub, dicho dominio escribirá en /docs/CNAME. Para más información sobre los archivos CNAME, consulta "Administrar un dominio personalizado para tu sitio Páginas de GitHub".

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. For more information, see "About Páginas de GitHub and 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 creados después del 15 de junio de 2016 y utilizando dominios github.io` se brindan a través de HTTPS. Si creaste tu sitio antes del 15 de junio de 2016, puedes habilitar el soporte HTTPS para el tráfico hasta tu sitio. Para obtener más información, consulta "[Asegurar tu Páginas de GitHub con HTTPS](/articles/securing-your-github-pages-site-with-https)".
  • - Los sitios Páginas de GitHub 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. - Tu uso de Páginas de GitHub está sujeto a los [Términos del servicio de GitHub](/articles/github-terms-of-service/), incluida la prohibición de reventa.

Límites de uso

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. Para más información, consulta "¿Cuál es la cuota de mi disco?"

  • Los sitios de Páginas de GitHub publicados no pueden ser mayores a 1 GB.

  • Los sitios de Páginas de GitHub tienen un soft límite de ancho de banda de 100GB por mes.

  • Los sitios de Páginas de GitHub tienen un soft límite de 10 construcciones por hora.

Si tu sitio excede estas cuotas de uso, es posible que no podamos prestar servicio a tu sitio, o puedes recibir un correo electrónico formal de GitHub Support o GitHub Premium Support sugiriendo estrategias para reducir el impacto de tu sitio en nuestros servidores, lo que incluye poner una red de distribución de contenido de un tercero (CDN) al frente de tu sitio, usar las otras características de GitHub, como lanzamientos, o mudar a un servicio de alojamiento diferente que pueda satisfacer mejor tus necesidades.

Usos prohibidos

Páginas de GitHub no pretende ser un servicio de alojamiento web gratuito ni permite que se use de ese modo para realizar tus negocios en línea, un sitio de comercio electrónico, o cualquier otro sitio web que esté principalmente dirigido a facilitar las operaciones comerciales o brindar software comercial como un servicio (SaaS).

Además, los sitios de Páginas de GitHub deben evitar:

  • el contenido o la actividad que sea ilegal o esté prohibida por nuestros Términos de servicio o Pautas de la comunidad
  • el contenido o la actividad violentas o amenazadoras
  • la actividad masiva automatizada excesiva (por ejemplo, envío de spam)
  • la actividad que comprometa a los usuarios o los servicios de GitHub
  • los esquemas del tipo 'hágase rico rápidamente'
  • el contenido sexualmente obsceno
  • el contenido que falsea de manera fraudulenta tu identidad o el propósito del sitio

Si tienes consultas acerca de si tu uso o tu intención de uso corresponde a alguna de estas categorías, comunícate con GitHub Support o GitHub Premium Support.

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?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.