Adding a theme to your GitHub Pages site using Jekyll

People with write permissions for a repository can add a theme to a Páginas de GitHub site using 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 Enterprise. Then, test your site locally. For more information, see "Testing your Páginas de GitHub site locally with Jekyll."

En este artículo

• Adding a theme
• Customizing your theme's CSS
• Customizing your theme's HTML layout

Adding a theme

1. On GitHub Enterprise, 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. Navigate to _config.yml.

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

   

5. Add a new line to the file for the theme name. Type theme: THEME-NAME, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "Supported themes" on the Páginas de GitHub site.

   

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."

   

7. 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.

   

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

   

Customizing your theme's CSS

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

1. On GitHub Enterprise, 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. Create a new file called /assets/css/style.scss.

4. Add the following content to the top of the file:

   ---
   ---
   
   @import "";

5. Add any custom CSS or Sass (including imports) you'd like immediately after the @import line.

Customizing your theme's HTML layout

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 theme's source repository. For example, the source repository for Minima is https://github.com/jekyll/minima.

2. In the _layouts folder, navigate to your theme's default.html file.

3. Copy the contents of the file.

4. On GitHub Enterprise, 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. Create a file called _layouts/default.html.

7. Paste the default layout content you copied earlier.

8. Personaliza el diseño como desees.

Leer más

• "Crear archivos nuevos"