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 is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

GitHub Pages now uses GitHub Actions to execute the Jekyll build. When using a branch as the source of your build, GitHub Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if GitHub Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

En este artículo

Introducción

Las GitHub Pages son páginas web públicas que se publican a través de GitHub. La forma más rápida de iniciar es utilizando el Selector de Temas de Jekyll para que cargue un tema preconfigurado. Posteriormente, podrás modificar el estilo y contenido de tus GitHub Pages.

Esta guía le llevará por la creación de 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 obtener más información, vea «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. En el nombre del repositorio, haz clic en Configuración. 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 "Código y automatización" de la barra lateral, haz clic en Páginas.

  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 haya terminado de editar el archivo, haga clic en Commit changes (Confirmar cambios).

Pasos siguientes

Para más información sobre cómo agregar otras páginas al sitio, consulta "Agregar contenido a tu sitio de Páginas de GitHub con Jekyll".

Para más información sobre cómo configurar un sitio de GitHub Pages con Jekyll, consulta "Acerca de las Páginas de GitHub y Jekyll".