Skip to main content

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

Puedes añadir un tema a tu sitio de Páginas de GitHub para personalizar la apariencia de tu sitio.

People with admin permissions for a repository can use the theme chooser to add a theme to a Páginas de GitHub site.

Páginas de GitHub 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, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos de GitHub".

Acerca del selector de temas

Nota: El selector de tema de Jekyll no es compatible para los sitios de Páginas de GitHub que se publican con un flujo de trabajo de GitHub Actions personalizado. Si compilas tu sitio con Jekyll y lo publicas con un flujo de trabajo de GitHub Actions personalizado, puedes agregar un tema editando el archivo _config.yml. Para obtener más información, consulta "Agregar un tema a tu sitio de GitHub Pages con Jekyll".

El selector de temas agrega un tema de Jekyll a tu repositorio. Para obtener más información acerca de Jekyll, consulta "Acerca de las Páginas de GitHub y Jekyll".

La forma en que funciona el selector de temas depende de si tu repositorio es público o privado.

  • Si las Páginas de GitHub ya están habilitadas para tu repositorio, el selector de temas agregará tu tema a la fuente de publicación actual.
  • Si tu repositorio es público y Páginas de GitHub se encuentra inhabilitado para éste, mediante el selector de temas podrás habilitar Páginas de GitHub y configurar la rama predeterminada como tu fuente de publicación.
  • Si tu repositorio es público, y las Páginas de GitHub están inhabilitadas para tu repositorio, debes habilitar las Páginas de GitHub configurando una fuente de publicación antes de poder usar el selector de temas.

Para obtener más información acerca de las fuentes de publicación, consulta "Acerca de las Páginas de GitHub".

Si antes agregaste manualmente un tema de Jekyll a tu repositorio, puede que esos archivos se apliquen incluso después de que uses el selector de temas. Para evitar conflictos, elimina todas las carpetas y archivos de temas agregados manualmente antes de usar el selector de temas. Para obtener más información, consulta "Agregar un tema a tu sitio de Páginas de GitHub con Jekyll".

Agregar un tema con el selector de temas

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

  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  3. En la sección de "Código y automatización" de la barra lateral, haz clic en Páginas .

  4. Debajo de "Páginas de GitHub", haz clic en Choose a theme (Elegir un tema) o Change theme (Cambiar tema). Elija un botón del tema

  5. Para elegir un tema, haz clic en el tema que quieras y luego haz clic en Select theme (Seleccionar tema). Opciones de temas y botón Select theme (Seleccionar tema)

  6. Puede que se te solicite que edites el archivo README.md de tu sitio.

    • Para editar el archivo más tarde, haz clic en Cancel (Cancelar). Enlace de cancelación al editar un archivo
    • Para editar el archivo ahora, consulta la sección "Editar archivos".

El tema elegido se aplicará automáticamente a los archivos markdown de tu repositorio. Para aplicar el tema a los archivos HTML de tu repositorio, debes agregar el texto preliminar de YAML que especifica un diseño para cada archivo. Para obtener más información, consulta "Texto preliminar" en el sitio de Jekyll.

Leer más

  • Temas en el sitio de Jekyll