[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/alect-themes ff095a8 030/269: Update README
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/alect-themes ff095a8 030/269: Update README |
Date: |
Thu, 21 Oct 2021 17:58:42 -0400 (EDT) |
branch: elpa/alect-themes
commit ff095a853dce719d469cebcc3e03161f6e9dca39
Author: Alex Kost <alezost@gmail.com>
Commit: Alex Kost <alezost@gmail.com>
Update README
Update screenshots, add description of default vs themed faces.
---
README.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-----
1 file changed, 86 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index 4bc14ea..09e45ee 100644
--- a/README.md
+++ b/README.md
@@ -87,15 +87,95 @@ You can change those colors by putting this into your
`.emacs`:
(alect-set-color 'dark 'red-2 "#32cd32")))
```
+### Alternative themes
+
+Along with 2 original light and dark themes, the package provides 2
+inverted (alternative) themes. They use the same color palettes, so
+they look very similar to the original ones. The difference (by
+default) is that dark and bright colors are reversed.
+
+However these 2 themes can be configured with
+`alect-inverted-color-regexp` variable (for details, see docstrings of
+this variable and `alect-get-color` function). For example, if you
+set this variable to invert background colors, alternative themes will
+look... unusual – see [alternative screenshots](#dired-elisp).
+
+### Emacs 24.3.1 and earlier
+
+While using any theme (not only from this package) you may meet faces
+that do not look how they should (intended by the theme). For example,
+if you enable `alect-light` theme, you can see ugly gray buttons (the
+left picture) in the `Custom-mode` instead of the themed colored
+buttons (the right picture):
+
+<a href="http://imgur.com/M6eyfWq" title="alect-light - Custom-mode">
+<img src="http://i.imgur.com/M6eyfWq.png" title="alect-light - Custom-mode
(wrong colors)" width=320 height=240/></a>
+<a href="http://imgur.com/WOz6Po2" title="alect-light - Custom-mode">
+<img src="http://i.imgur.com/WOz6Po2.png" title="alect-light - Custom-mode
(proper colors)" width=320 height=240/></a>
+
+This happens because Emacs applies default face settings even for a
+themed face. This behaviour is changed in new versions of Emacs (24.4
+and above). Happily it can be easily fixed for earlier versions by
+redefining `face-spec-recalc` function (can be found on
+[Emacs git
mirror](http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/faces.el)):
+
+```lisp
+(defun face-spec-recalc (face frame)
+ "Reset the face attributes of FACE on FRAME according to its specs.
+This applies the defface/custom spec first, then the custom theme specs,
+then the override spec."
+ (while (get face 'face-alias)
+ (setq face (get face 'face-alias)))
+ (face-spec-reset-face face frame)
+ ;; If FACE is customized or themed, set the custom spec from
+ ;; `theme-face' records, which completely replace the defface spec
+ ;; rather than inheriting from it.
+ (let ((theme-faces (get face 'theme-face)))
+ (if theme-faces
+ (dolist (spec (reverse theme-faces))
+ (face-spec-set-2 face frame (cadr spec)))
+ (face-spec-set-2 face frame (face-default-spec face))))
+ (face-spec-set-2 face frame (get face 'face-override-spec)))
+```
+
+If you put it into your `.emacs`, you will always get pure themes
+without unintended face settings.
+
## Screenshots
-### Custom, emacs-lisp, minibuffer ("DejaVu Sans Mono-12" font)
-<a href="http://imgur.com/D0UASEQ"><img src="http://i.imgur.com/D0UASEQ.png"
width=320 height=240/></a>
-<a href="http://imgur.com/GXnGuO0"><img src="http://i.imgur.com/GXnGuO0.png"
width=320 height=240/></a>
+### C, shell, linum, ido
+
+**Font:** *Anonymous Pro-13*
+
+<a href="http://imgur.com/Mjupclm">
+<img src="http://i.imgur.com/Mjupclm.png" title="alect-light - c, shell"
width=320 height=240/></a>
+<a href="http://imgur.com/AiG3TsM">
+<img src="http://i.imgur.com/AiG3TsM.png" title="alect-dark - c, shell"
width=320 height=240/></a>
+
+### Org, markdown
+
+**Font:** *DejaVu Sans Mono-12*
+
+<a href="http://imgur.com/B1Pl5kX">
+<img src="http://i.imgur.com/B1Pl5kX.png" title="alect-light - org, markdown"
width=320 height=240/></a>
+<a href="http://imgur.com/Tck5Aj2">
+<img src="http://i.imgur.com/Tck5Aj2.png" title="alect-dark - org, markdown"
width=320 height=240/></a>
+
+### Dired, elisp
+
+Alternative themes, configured to invert background (see
+[alternative configuration](#alternative-themes)) like this:
+
+```lisp
+(setq alect-inverted-color-regexp "^\\(bg\\)\\([-+]\\)\\([012]\\)$")
+```
+
+**Font:** *Anonymous Pro-13*
-### C, shell ("Anonymous Pro-13" font)
-<a href="http://imgur.com/GkjhzKK"><img src="http://i.imgur.com/GkjhzKK.png"
width=320 height=240/></a>
-<a href="http://imgur.com/Stl0mba"><img src="http://i.imgur.com/Stl0mba.png"
width=320 height=240/></a>
+<a href="http://imgur.com/ljO1Dlf">
+<img src="http://i.imgur.com/ljO1Dlf.png" title="alect-light-alt - dired,
elisp" width=320 height=240/></a>
+<a href="http://imgur.com/HNMr4qj">
+<img src="http://i.imgur.com/HNMr4qj.png" title="alect-dark-alt - dired,
elisp" width=320 height=240/></a>
## Feedback
- [nongnu] elpa/alect-themes fbf0829 011/269: Update colors sample, (continued)
- [nongnu] elpa/alect-themes fbf0829 011/269: Update colors sample, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes dc88e28 015/269: Add customization type for `alect-colors' variable, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 3139f1a 017/269: Add description of customizing color palettes, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 95c7091 021/269: Combine `alect-get-faces' and `alect-get-vars', ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 7b42f0a 022/269: Add support for inverted (alternative) themes, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 602655e 023/269: Add files for alternative themes, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes d3443de 024/269: Replace white/gray/black with a gray group, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes a10591e 025/269: Improve custom-button faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes ef4816b 026/269: Improve yellow colors for the light theme, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 6c459a6 029/269: Update .gitignore, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes ff095a8 030/269: Update README,
ELPA Syncer <=
- [nongnu] elpa/alect-themes 209804e 037/269: Inherit `org-agenda-structure' from `alect-title', ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes b0ee25c 040/269: Delete unknown w3m faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes d9583c9 044/269: Remove redundant part from mode-line face, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 5e6748d 042/269: Improve match face, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 2c0ba50 053/269: Update version (0.3) and package commentary, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 32c3244 056/269: Update version (0.3.1), ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 7b4397a 064/269: Modify `font-lock-warning-face', ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes fa8f779 071/269: Modify `alect-color-level-9' face, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 3677326 049/269: Add support for 2 variants of face specification, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 0a8e941 050/269: Remove redundant parentheses in faces, ELPA Syncer, 2021/10/21