alshedivat / alshedivat/al-folio

Inconsistent docs on how to change theme color

Ouverte Adaptée aux débutants
#3,692 6 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
HTML
Étoiles
16.1k
Forks
13.1k
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

### Discussed in https://github.com/alshedivat/al-folio/discussions/3650

Originally posted by **EtienneC30** June 20, 2026
In the CUSTOMIZE.md file it is written [here](https://github.com/alshedivat/al-folio/blob/main/docs/CUSTOMIZE.md#changing-theme-color) that
> A variety of beautiful theme colors have been selected for you to choose from. In v1.x, theme tokens are gem-owned by default. To customize colors locally, either use _config.yml theme settings (for light/dark scheme selection) or create local _sass/_themes.scss and _sass/_variables.scss override files in your starter repo (these override gem defaults).

But there are no instructions about how to choose a color theme or what the scss files should look like. After a lot of looking I found corresponding files in my computer which I overrode as indicated I think but it did not apply the changes (when I pushed it did not even trigger the deploy job). But I feel like there should be a simpler way so I probably missed something. Any help appreciated 🙏

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Start with the “Changing theme color” section in docs/CUSTOMIZE.md, then inspect the referenced _config.yml, _sass/_themes.scss, and _sass/_variables.scss files to verify the available choices and override structure. Update the documentation so a reader can choose a theme and create the local SCSS overrides, with examples that make the expected result clear.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
jekyll, scss
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
68/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.