Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2021-03-02. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

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

Puedes compilar 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 Free y GitHub Free para organizaciones, y en repositorios privados y públicos con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y Servidor de GitHub Enterprise.

En este artículo

Cualquier persona con permisos de lectura para un repositorio puede probar un sitio de Páginas de GitHub localmente.

Prerrequisitos

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

Recomendamos utilizando 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. Instala Ruby. Para obtener más información, consulta "Instalar Ruby" en la documentación de Ruby.
  2. Instala Bundler. Para obtener más información, visita "Bundler".

Sugerencia: si ves un error de Ruby cuando tratas de instalar Jekyll utilizando Bundler, es posible que necesites utilizar un administrador de paquete, como RVM o Homebrew, para administrar tu instalación de Ruby. Para obtener más información, consulta la sección "Solución de problemas" en la documentación de Jekyll.

Construyendo su sitio localmente

  1. Abre la TerminalTerminalGit Bash.
  2. Navega a la fuente de publicación para tu sitio. Para obtener más información acerca de las fuentes de publicación, consulta "Acerca de las Páginas de GitHub".
  3. 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.
  4. 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 compile localmente en comparación a cómo se vea cuando se publique en GitHub Enterprise. Para evitar esto, actualiza de manera regular la gema de github-pages en tu computadora.

  1. Abre la TerminalTerminalGit Bash.
  2. Actualiza la gema de github-pages.
    • Si instalaste Bundler, ejecuta bundle update github-pages.
    • Si no tienes instalado Bundler, ejecuta gem update github-pages.

Leer más