diff options
| author | Protesilaos Stavrou <info@protesilaos.com> | 2022-08-19 15:15:52 +0300 |
|---|---|---|
| committer | Protesilaos Stavrou <info@protesilaos.com> | 2022-08-19 15:15:52 +0300 |
| commit | 8d263a2788576af24d0480226960f813270bf23c (patch) | |
| tree | 3f4cee88b56e715f879941304ff94587827c1499 /README.org | |
| parent | d1827dae485c97d62245170b404737de4ce8f43a (diff) | |
Re-organise headings in the manual
Diffstat (limited to 'README.org')
| -rw-r--r-- | README.org | 80 |
1 files changed, 40 insertions, 40 deletions
@@ -278,46 +278,6 @@ will retain the original aesthetic for that level. For example: (t . t))) ; default style for all other levels #+end_src -* Principles -:PROPERTIES: -:CUSTOM_ID: h:a6dd030c-6b6c-4992-83e8-3438b4607b51 -:END: - -+ No customization options that affect the style of individual - components (e.g. change the color of the mode line, remove bold, - etc.)! Either you like them or you don't. To change faces, it is - better to do it in user-level configurations (report the issue and we - can help with the relevant code). Providing customizations that - refashion a wide set of themes is not maintainable. - -+ Curated list of supported packages. I will only cover what I use - and/or know is in a well-maintained state. Styling a package requires - a lot of work as one must (i) know how the package works, (ii) see all - its interfaces in action, (iii) make sure that the color combinations - look consistent with the rest of the theme. - -+ Minimum contrast ratio of 4.5:1 against the main background (WCAG AA - standard). Use my =modus-themes= package (also built into Emacs 28 or - higher) if you need top-class accessibility. - -* Minimal VS maximal scope -:PROPERTIES: -:CUSTOM_ID: h:fb219b87-ab95-401a-a742-a2fc451bf9f7 -:END: - -The =ef-themes= are meant to be minimal in scope, as opposed to my -=modus-themes= whose accessibility requirements make them maximalist by -necessity. The =modus-themes= are such because: - -1. Accessibility is not a one-size-fits-all. Customisation options are - necessary to empower users. -2. Accessibility is as good as its weakest link. If the user spends all - day using FOO package, it needs to be perfectly legible, otherwise - the whole theme fails to deliver on its promise. - -The =ef-themes= can afford to be minimal because they do not have such a -lofty accessibility target. - * Loading a theme :PROPERTIES: :CUSTOM_ID: h:75d74aea-d17f-497f-a3b8-f0bf4c372de0 @@ -461,6 +421,46 @@ made. Though please note that some tweaks to individual hues or color mapping are still possible. At any rate, we will not outright break any code that uses ~ef-themes-with-colors~. +* Principles +:PROPERTIES: +:CUSTOM_ID: h:a6dd030c-6b6c-4992-83e8-3438b4607b51 +:END: + ++ No customization options that affect the style of individual + components (e.g. change the color of the mode line, remove bold, + etc.)! Either you like them or you don't. To change faces, it is + better to do it in user-level configurations (report the issue and we + can help with the relevant code). Providing customizations that + refashion a wide set of themes is not maintainable. + ++ Curated list of supported packages. I will only cover what I use + and/or know is in a well-maintained state. Styling a package requires + a lot of work as one must (i) know how the package works, (ii) see all + its interfaces in action, (iii) make sure that the color combinations + look consistent with the rest of the theme. + ++ Minimum contrast ratio of 4.5:1 against the main background (WCAG AA + standard). Use my =modus-themes= package (also built into Emacs 28 or + higher) if you need top-class accessibility. + +* Minimal VS maximal scope +:PROPERTIES: +:CUSTOM_ID: h:fb219b87-ab95-401a-a742-a2fc451bf9f7 +:END: + +The =ef-themes= are meant to be minimal in scope, as opposed to my +=modus-themes= whose accessibility requirements make them maximalist by +necessity. The =modus-themes= are such because: + +1. Accessibility is not a one-size-fits-all. Customisation options are + necessary to empower users. +2. Accessibility is as good as its weakest link. If the user spends all + day using FOO package, it needs to be perfectly legible, otherwise + the whole theme fails to deliver on its promise. + +The =ef-themes= can afford to be minimal because they do not have such a +lofty accessibility target. + * FAQ :PROPERTIES: :CUSTOM_ID: h:a6d5c6f1-84c5-4d74-ba39-b5ccda05497a |
