Inicio rápido para páginas de GitHub

Puede usar GitHub Pages para presentar algunos proyectos de código abierto, hospedar un blog o incluso compartir su currículum. 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. Sustituya 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 nombre del repositorio contiene el texto "octocat.github.io" y se describe en naranja oscuro.

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

  2. Cambie Agregar README a Activado.

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

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

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

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

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

  1. 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.
  2. Visite username.github.io para ver su nuevo sitio web. Tenga en cuenta que los cambios en el sitio pueden tardar hasta 10 minutos en publicarse después de insertar 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, compruebe si _config.yml existe. Si no existe, cree un nuevo archivo denominado _config.yml.

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

  4. Haga clic para editar el archivo.

  5. 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!

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

Pasos siguientes

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