Guía de inicio rápido para GitHub Pages

Puedes utilizar GitHub Pages para mostrar algunos proyectos de código abierto, hospedar un blog o incluso compartir tu CV. Esta guía te ayudará a iniciar creando tu siguiente sitio web.

¿Quién puede utilizar esta característica?

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server.

En este artículo

Introducción

En esta guía, crearás un sitio de usuario en <username>.github.io.

Crear tu sitio web

  1. En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.

    Captura de pantalla del menú desplegable GitHub que muestra las opciones para crear nuevos elementos. El elemento de menú "New repository" está resaltado en naranja oscuro.

  2. Escriba username.github.io como nombre del repositorio. Reemplace username por su nombre de usuario de GitHub. Por ejemplo, si el nombre de usuario es octocat, el nombre del repositorio debe ser octocat.github.io.

    Captura de pantalla de la configuración de GitHub Pages en un repositorio. El campo del nombre del repositorio contiene el texto "octocat.github.io" y aparece en naranja oscuro.

  3. Elige la visibilidad del repositorio. Para más información, consulta Acerca de los repositorios.

  4. Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame).

  5. Haga clic en Create repository (Crear repositorio).

  6. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  7. En la sección "Code and automation" de la barra lateral, haz clic en Pages.

  8. En "Compilación e implementación", en "Origen", selecciona Implementar desde una rama.

  9. En "Compilación e implementación", en "Rama", usa el menú desplegable de rama y selecciona un origen de publicación.

    Captura de pantalla de la configuración de Páginas en un repositorio GitHub. El menú para seleccionar una rama como origen de publicación, etiquetado como "Ninguno", aparece en naranja oscuro.

  10. Opcionalmente, abre el archivo README.md del repositorio. El archivo README.md es donde escribirá el contenido de su sitio. Puedes editar el archivo o mantener el contenido predeterminado por el momento.

  11. Visite username.github.io para ver su nuevo sitio web. Ten en cuenta que la publicación de los cambios en el sitio puede tardar hasta 10 minutos después de que insertes los cambios en GitHub.

Cambiar el título y la descripción

De manera predeterminada, el título del sitio es username.github.io. Puede cambiar el título. Para ello, edite el archivo _config.yml en el repositorio. También puedes agregar una descripción de tu sitio.

  1. Haga clic en la pestaña Code (Código) del repositorio.

  2. En la lista de archivos, haga clic en _config.yml para abrir el archivo.

  3. Haz clic en para editar el archivo.

  4. El archivo _config.yml ya contiene una línea que especifica el tema del sitio. Agregue una nueva línea con title: seguido del título que quiera. Agregue una nueva línea con description: seguido de la descripción que quiera. Por ejemplo:

    theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!

  5. Cuando hayas terminado de editar el archivo, haz clic en Commit changes (Confirmar cambios).

Pasos siguientes

Has creado, personalizado y publicado correctamente tu primer sitio web de GitHub Pages, pero hay mucho más que explorar. Estos son algunos recursos útiles para que completes los pasos siguientes con GitHub Pages: