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.

Agregar un tema a tu sitio de Páginas de GitHub con Jekyll

Puedes personalizar tu sitio Jekyll agregando y personalizando un tema.

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

Las personas con permisos de escritura para un repositorio pueden agregar un tema a un sitio de Páginas de GitHub con Jekyll.

Los cambios en tu sitio se publican automáticamente cuando se fusionan con la fuente de publicación de tu sitio. Si quieres pre-visualizar tus cambios primero, puedes hacer los cambios localmente en vez de en GitHub Enterprise. Después, prueba tu sitio localmente. Para obtener más información, consulta "Verificar tu sitio de Páginas de GitHub localmente con Jekyll".

Agregar un tema

  1. En GitHub Enterprise, navega al repositorio de tu sitio.

  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. Navega hasta _config.yml.

  4. En la esquina superior derecha de la vista del archivo, haz clic en para abrir el editor de archivos.

    Botón Editar archivo

  5. Agrega una nueva línea al archivo para el nombre del tema.

    • Para usar un tema compatible, escribe tema: THEME-NAME, reemplazando THEME-NAME por el nombre del tema, tal como se muestra en el README del repositorio del tema. Para conocer la lista de temas compatibles, consulta "Temas compatibles" en el sitio de Páginas de GitHub.
      Supported theme in config file
    • Para usar cualquier otro tema de Jekyll alojado en GitHub, escribe remote_theme: THEME-NAME, reemplazando THEME-NAME por el nombre del tema, tal como se muestra en el README del repositorio del tema.
      Unsupported theme in config file
  6. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, consulta "Crear una confirmación con co-autores múltiples".

    Mensaje de confirmación de tu cambio

  7. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, consulta "Crear una solicitud de extracción nueva".

    Confirmar opciones de rama

  8. Haz clic en Proponer cambio en el archivo.

    Botón para proponer cambio de archivo

Personalizar el CSS de tu tema

El repositorio fuente de tu tema podría ofrecer algo de ayuda para personalizarlo. Por ejemplo, ve el "README de Minima."

  1. En GitHub Enterprise, navega al repositorio de tu sitio.

  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. Crea un archivo nuevo denominado /assets/css/style.scss.

  4. Agrega el siguiente contenido en la parte superior del archivo:

    ---
    ---
    
    @import "";
    
  5. Agrega cualquier CSS o Sass personalizado que quieras (incluidas importaciones) inmediatamente después de la línea @import.

Personalizar el diseño HTML de tu tema

El repositorio fuente de tu tema podría ofrecer algo de ayuda para personalizarlo. Por ejemplo, ve el "README de Minima."

  1. En GitHub, desplázate hasta el repositorio fuente de tu tema. Por ejemplo, el repositorio fuente para Minima es https://github.com/jekyll/minima.
  2. En la carpeta _layouts, desplázate hasta el archivo default.html de tu tema.
  3. Copia los contenidos del archivo.
  4. En GitHub Enterprise, navega al repositorio de tu sitio.
  5. 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".
  6. Crea un archivo denominado _layouts/default.html.
  7. Pega el contenido del diseño personalizado que copiaste anteriormente.
  8. Personaliza el diseño como desees.

Leer más

¿Te ayudó este documento?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.