Probar tu sitio de Páginas de GitHub localmente con Jekyll

Cualquier persona con permisos de lectura para un repositorio puede probar un sitio de GitHub Pages localmente.

Prerrequisitos

Antes de que puedas usar Jekyll para probar un sitio, debes hacer lo siguiente:

• Instalar Jekyll
• Crear un sitio de Jekyll. Para obtener más información, vea "Crear un sitio de GitHub Pages con Jekyll".

Se recomienda usar Bundler para instalar y ejecutar Jekyll. Bundler administra las dependencias de gema de Ruby, reduce los errores de construcción de Jekyll y evita los errores relacionados con el entorno. Para instalar Bundler:

1. Instale Ruby. Para más información, vea "Instalación de Ruby" en la documentación de Ruby.
2. Instale Bundler. Para más información, vea "Bundler".

Construyendo tu sitio localmente

1. Abra TerminalTerminalGit Bash. 1. Navega a la fuente de publicación para tu sitio. Para más información, consulta "Configuración de una fuente de publicación para el sitio de GitHub Pages."
2. Ejecute bundle install.
3. Ejecute el sitio de Jekyll localmente.

   $ bundle exec jekyll serve
   > Configuration file: /Users/octocat/my-site/_config.yml
   >            Source: /Users/octocat/my-site
   >       Destination: /Users/octocat/my-site/_site
   > Incremental build: disabled. Enable with --incremental
   >      Generating...
   >                    done in 0.309 seconds.
   > Auto-regeneration: enabled for '/Users/octocat/my-site'
   > Configuration file: /Users/octocat/my-site/_config.yml
   >    Server address: http://127.0.0.1:4000/
   >  Server running... press ctrl-c to stop.

4. Para obtener una vista previa del sitio, en el explorador web, vaya a http://localhost:4000.

Actualizar la gema de GitHub Pages

Jekyll es un proyecto de código abierto activo que se actualiza de manera frecuente. Si la gema de github-pages de su equipo está desactualizada con respecto a la gema de github-pages del servidor de GitHub Pages, su sitio puede tener un aspecto distinto cuando se compile localmente en comparación a cuando se publique en GitHub Enterprise Server. Para evitar esto, actualice periódicamente la gema github-pages en el equipo.

1. Abra TerminalTerminalGit Bash.
2. Actualice la gema github-pages.
   • Si ha instalado Bundler, ejecute bundle update github-pages.
   • Si no tiene instalado Bundler, ejecute gem update github-pages.

Información adicional

• GitHub Pages en la documentación de Jekyll