Skip to main content

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

Puedes personalizar tu sitio Jekyll agregando y personalizando un tema.

GitHub Pages se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server.

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

Changes en tu sitio se publican automáticamente cuando se fusionan con la fuente de publicación de tu sitio. Si quieres previsualizar tus cambios primero, puedes hacer los cambios localmente en vez de en GitHub Enterprise Server. Después, prueba tu sitio localmente. Para obtener más información, vea "Probar tu sitio de GitHub Pages localmente con Jekyll".

Agregar un tema

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio. 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. Vaya a _config.yml.

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

    Botón Edit file

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

    • Para usar un tema compatible, escriba theme: THEME-NAME, reemplazando THEME-NAME por el nombre del tema como se muestra en el archivo README del repositorio del tema. Para obtener una lista de los temas compatibles, consulte "Temas admitidos" en el sitio GitHub Pages. Tema compatible en el archivo de configuración
    • Para usar cualquier otro tema de Jekyll hospedado en GitHub, escriba remote_theme: THEME-NAME reemplazando THEME-NAME por el nombre del tema como se muestra en el archivo README del repositorio del tema. Tema no compatible en el archivo de configuración 1. 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 más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio 1. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. 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 más información, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama 1. Haga clic en Propose file change (Proponer cambio de 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, vea "Léame de Minima".

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio. 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. Cree un nuevo archivo denominado /assets/css/style.scss.

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

    ---
    ---
    
    @import "{{ site.theme }}";
    
  4. Agregue cualquier CSS o Sass personalizado (incluidas las importaciones) que desee colocar 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, vea "Léame de Minima".

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

Información adicional