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 gratis y en repositorios privados y públicos con GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise y Servidor de GitHub Enterprise. Para obtener más información, consulta "Productos de GitHub."

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

Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on GitHub. Then, test your site locally. For more information, see "Testing your Páginas de GitHub site locally with Jekyll."

En este artículo

Agregar un tema

  1. On GitHub, navigate to your site's repository.

  2. Navigate to the publishing source for your site. For more information about publishing sources, see "About Páginas de GitHub."

  3. Navega hasta _config.yml.

  4. In the upper right corner of the file view, click to open the file editor.

    Edit file button

  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, escribe un mensaje de confirmación breve y significativo que describa el cambio que has realizado en el archivo. Puedes atribuir la confirmación a más de un autor en el mensaje de confirmación. Para obtener más información, consulta "Crear una confirmación con distintos coautores."

    Mensaje de confirmación para tu cambio

  1. Debajo de los campos de mensaje de confirmación, haz clic en el menú desplegable de dirección de correo electrónico y elige una dirección de correo electrónico de autor de Git. Únicamente las direcciones de correo electrónico verificadas aparecen en el menú desplegable. Si habilitaste privacidad de la dirección de correo electrónico, entonces <username>@users.noreply.github.com es la dirección de correo electrónico de autor de la confirmación por defecto. Para obtener más información, consulta "Configurar tu dirección de correo electrónico de confirmación."

    Choose commit email addresses

  2. Debajo de los campos para los mensajes de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es master, debes elegir crear una nueva rama para tu confirmación y luego crear una solicitud de extracción.

    Confirmar opciones de rama

  3. Haz clic en Proponer un cambio en el archivo.

    Botón Proponer un cambio en el archivo

Personalizar el CSS de tu tema

These instructions work best with themes that are officially supported by Páginas de GitHub. For a complete list of supported themes, see "Supported themes" on the Páginas de GitHub site.

Your theme's source repository may offer some help in customizing your theme. For example, see "Minima's README."

  1. On GitHub, navigate to your site's repository.

  2. Navigate to the publishing source for your site. For more information about publishing sources, see "About 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

These instructions work best with themes that are officially supported by Páginas de GitHub. For a complete list of supported themes, see "Supported themes" on the Páginas de GitHub site.

Your theme's source repository may offer some help in customizing your theme. For example, see "Minima's README."

  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. On GitHub, navigate to your site's repository.

  5. Navigate to the publishing source for your site. For more information about publishing sources, see "About 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

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos