Probar tu sitio de Páginas de GitHub localmente con Jekyll
Puedes construir tu sitio de Páginas de GitHub localmente para previsualizar y probar los cambios en tu sitio.
Páginas de GitHub se encuentra disponible en repositorios públicos con GitHub gratis y en repositorios privados y públicos con GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise y Servidor de GitHub Enterprise.
Cualquier persona con permisos de lectura para un repositorio puede probar un sitio de Páginas de GitHub localmente.
En este artículo
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, consulta "Crear un sitio de Páginas de GitHub con Jekyll".
We recommend using Bundler to install and run Jekyll. Bundler manages Ruby gem dependencies, reduces Jekyll build errors, and prevents environment-related bugs. To install Bundler:
- Install Ruby. For more information, see "Installing Ruby" in the Ruby documentation.
- Install Bundler. For more information, see "Bundler."
Tip: If you see a Ruby error when you try to install Jekyll using Bundler, you may need to use a package manager, such as RVM or Homebrew, to manage your Ruby installation. For more information, see "Troubleshooting" in the Jekyll documentation.
Construyendo tu sitio localmente
-
Abre el terminal TerminalTerminalGit Bash.
-
Navigate to the publishing source for your site. For more information about publishing sources, see "About Páginas de GitHub."
-
Ejecuta tu sitio Jekyll de forma local.
$ 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.
-
Para previsualizar tu sitio, en tu navegador web, navega hasta
http://localhost:4000
.
Actualizar la gema de Páginas de GitHub
Jekyll es un proyecto de código abierto activo que se actualiza de manera frecuente. Si la gema de github-pages
de tu computadora está desactualizada con respecto a la gema de github-pages
del servidor de Páginas de GitHub, tu sitio puede verse diferente cuando se construya localmente a cuando se publique en GitHub Enterprise. Para evitar esto, actualiza de manera regular la gema de github-pages
en tu computadora.
-
Abre el terminal TerminalTerminalGit Bash.
-
Actualiza la gema de
github-pages
.- Si instalaste Bundler, ejecuta
bundle update github-pages
. - Si no tienes instalado Bundler, ejecuta
gem update github-pages
.
- Si instalaste Bundler, ejecuta
Leer más
- Páginas de GitHub en la documentación de Jekyll