[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/modus-operandi-theme 0633c2a 047/153: Recompile manual
From: |
Stefan Monnier |
Subject: |
[elpa] externals/modus-operandi-theme 0633c2a 047/153: Recompile manual (cover 619e48bbc and decf274f4) |
Date: |
Thu, 18 Mar 2021 13:47:36 -0400 (EDT) |
branch: externals/modus-operandi-theme
commit 0633c2a60ee8de113ce68e862faa6baa48f32be0
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
Recompile manual (cover 619e48bbc and decf274f4)
---
doc/modus-themes.info | 189 +++++++++++++++++++++++++++++++++++---------------
1 file changed, 133 insertions(+), 56 deletions(-)
diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index e2988c4..878d319 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -93,6 +93,7 @@ Advanced customisation (do-it-yourself)
* Tweak colours (DIY):: Declare your own palette overrides
* Font configs (DIY):: Optimise for mixed typeface buffers
+* Org user faces (DIY):: Extend styles for org-mode keywords and
priorities
Face coverage
@@ -950,6 +951,7 @@ such, they are labelled as “do-it-yourself” or “DIY”.
* Tweak colours (DIY):: Declare your own palette overrides
* Font configs (DIY):: Optimise for mixed typeface buffers
+* Org user faces (DIY):: Extend styles for org-mode keywords and
priorities
File: modus-themes.info, Node: Tweak colours (DIY), Next: Font configs
(DIY), Up: Advanced customisation (do-it-yourself)
@@ -1038,7 +1040,7 @@ prior to loading:: for a more comprehensive setup).
(load-theme 'modus-operandi t)))
-File: modus-themes.info, Node: Font configs (DIY), Prev: Tweak colours
(DIY), Up: Advanced customisation (do-it-yourself)
+File: modus-themes.info, Node: Font configs (DIY), Next: Org user faces
(DIY), Prev: Tweak colours (DIY), Up: Advanced customisation (do-it-yourself)
5.2 Font configurations for Org (and others)
============================================
@@ -1072,12 +1074,12 @@ describe-function’):
The value of the ‘:height’ attribute essentially is the point size ×
100. So if you want to use a font at point size ‘11’, you set the
-height to ‘110’. Values do not need to be rounded to multiples of ten:
+height at ‘110’. Values do not need to be rounded to multiples of ten:
the likes of ‘115’ are perfectly valid.
An alternative syntax, which the author of this documents prefers, is
-to pass all typeface parameters directly to a ‘font’ property. Note
-that here we use a standard point size.
+to pass all typeface parameters directly to a ‘font’ property.(1) Note
+that here we use a standard point size:
(set-face-attribute 'default nil :font "DejaVu Sans Mono-11")
(set-face-attribute 'variable-pitch nil :font "DejaVu Serif-11")
@@ -1089,6 +1091,79 @@ multiple faces like this:
(dolist (face '(default fixed-pitch))
(set-face-attribute face nil :font "DejaVu Sans Mono-11"))
+ ---------- Footnotes ----------
+
+ (1) Has the benefit of accepting ‘fontconfig’ parameters (GNU/Linux),
+such as ‘"DejaVu Sans Mono-11:hintstyle=hintslight:autohint=false"’.
+<https://www.freedesktop.org/software/fontconfig/fontconfig-user.html>
+
+
+File: modus-themes.info, Node: Org user faces (DIY), Prev: Font configs
(DIY), Up: Advanced customisation (do-it-yourself)
+
+5.3 Org user faces (DIY)
+========================
+
+Users of ‘org-mode’ have the option to configure various keywords and
+priority cookies to better match their workflow. User options are
+‘org-todo-keyword-faces’ and ‘org-priority-faces’.
+
+ As those are meant to be custom faces, it would be futile to have the
+themes try to guess what each user would want to use, which keywords to
+target, and so on. Instead, we can provide guidelines on how to
+customise things to one’s liking with the intent to retain the overall
+aesthetics of the theme.
+
+ Please bear in mind that the end result of those is not controlled by
+the active theme but by how Org maps faces to its constructs. Editing
+those while ‘org-mode’ is active requires ‘M-x org-mode-restart’ for
+changes to take effect.
+
+ Let us assume you wish to visually differentiate your keywords. You
+have something like this:
+
+ (setq org-todo-keywords
+ '((sequence "TODO(t)" "|" "DONE(D)" "CANCEL(C)")
+ (sequence "MEET(m)" "|" "MET(M)")
+ (sequence "STUDY(s)" "|" "STUDIED(S)")
+ (sequence "WRITE(w)" "|" "WROTE(W)")))
+
+ You could then use a variant of the following to inherit from a face
+that uses the styles you want and also to preserve the properties
+applied by the ‘org-todo’ face:
+
+ (setq org-todo-keyword-faces
+ '(("MEET" . '(font-lock-preprocessor-face org-todo))
+ ("STUDY" . '(font-lock-variable-name-face org-todo))
+ ("WRITE" . '(font-lock-type-face org-todo))))
+
+ This will refashion the keywords you specify, while letting the
+others use their original styles (which are defined in the ‘org-todo’
+face).
+
+ When you inherit from multiple faces, you need to quote the list as
+shown above. The order is important: the last item is applied over the
+previous ones.
+
+ If you do not want to blend multiple faces, you do not need a quoted
+list. A pattern of ‘keyword . face’ would suffice.
+
+ Consider both approaches in the configuration of the priority
+cookies:
+
+ (setq org-priority-faces
+ '((?A . '(org-scheduled-today org-priority))
+ (?B . org-priority)
+ (?C . '(shadow org-priority))))
+
+ To find all the faces that are loaded in your current Emacs session,
+use ‘M-x list-faces-display’. Also try ‘M-x describe-variable’ and then
+specify the name of each of those Org variables demonstrated above.
+Their documentation strings will offer you further guidance.
+
+ Also consider reading the “Notes for aspiring Emacs theme
+developers”, published on 2020-08-28 by Protesilaos Stavrou:
+<https://protesilaos.com/codelog/2020-08-28-notes-emacs-theme-devs/>.
+
File: modus-themes.info, Node: Face coverage, Next: Notes for individual
packages, Prev: Advanced customisation (do-it-yourself), Up: Top
@@ -2165,58 +2240,60 @@ Appendix A GNU Free Documentation License
Tag Table:
Node: Top218
-Node: Overview3732
-Node: How do the themes look like5417
-Node: Installation5900
-Node: Install from the archives6550
-Node: Install on GNU/Linux7237
-Node: Debian 11 Bullseye7682
-Node: GNU Guix8091
-Node: Enable and load8442
-Node: Load automatically9019
-Node: Load at a given time or at sunset/sunrise9578
-Ref: Load at a given time or at sunset/sunrise-Footnote-111616
-Ref: Load at a given time or at sunset/sunrise-Footnote-211744
-Node: Toggle between the themes on demand11827
-Node: Configure options prior to loading12574
-Ref: Configure options prior to loading-Footnote-115055
-Node: Customisation Options15230
-Node: Bold constructs16894
-Node: Slanted constructs17893
-Node: Syntax highlighting18484
-Node: Command prompts19213
-Node: Mode line20016
-Node: Completion UIs21270
-Node: Fringes23211
-Node: Line highlighting23975
-Node: Matching parentheses24641
-Node: Diffs25283
-Node: Org mode blocks27076
-Node: Accented headings28582
-Node: Section headings29437
-Node: Scaled headings30622
-Node: Scaled heading sizes31241
-Node: Headings' font32914
-Node: Advanced customisation (do-it-yourself)33538
-Node: Tweak colours (DIY)34458
-Node: Font configs (DIY)38092
-Node: Face coverage40456
-Node: Supported packages40958
-Node: Covered indirectly46880
-Node: Will NOT be supported47232
-Node: Notes for individual packages47950
-Node: Note for powerline or spaceline48356
-Node: Note on shr colours48728
-Node: Note for Helm grep49141
-Node: Note on vc-annotate-background-mode50588
-Node: Contributing51442
-Node: Sources of the themes51861
-Node: Issues you can help with52623
-Node: Merge requests53810
-Node: Acknowledgements54892
-Node: Meta56349
-Node: External projects (ports)57402
-Node: GNU Free Documentation License58225
+Node: Overview3816
+Node: How do the themes look like5501
+Node: Installation5984
+Node: Install from the archives6634
+Node: Install on GNU/Linux7321
+Node: Debian 11 Bullseye7766
+Node: GNU Guix8175
+Node: Enable and load8526
+Node: Load automatically9103
+Node: Load at a given time or at sunset/sunrise9662
+Ref: Load at a given time or at sunset/sunrise-Footnote-111700
+Ref: Load at a given time or at sunset/sunrise-Footnote-211828
+Node: Toggle between the themes on demand11911
+Node: Configure options prior to loading12658
+Ref: Configure options prior to loading-Footnote-115139
+Node: Customisation Options15314
+Node: Bold constructs16978
+Node: Slanted constructs17977
+Node: Syntax highlighting18568
+Node: Command prompts19297
+Node: Mode line20100
+Node: Completion UIs21354
+Node: Fringes23295
+Node: Line highlighting24059
+Node: Matching parentheses24725
+Node: Diffs25367
+Node: Org mode blocks27160
+Node: Accented headings28666
+Node: Section headings29521
+Node: Scaled headings30706
+Node: Scaled heading sizes31325
+Node: Headings' font32998
+Node: Advanced customisation (do-it-yourself)33622
+Node: Tweak colours (DIY)34626
+Node: Font configs (DIY)38260
+Ref: Font configs (DIY)-Footnote-140692
+Node: Org user faces (DIY)40914
+Node: Face coverage43746
+Node: Supported packages44248
+Node: Covered indirectly50170
+Node: Will NOT be supported50522
+Node: Notes for individual packages51240
+Node: Note for powerline or spaceline51646
+Node: Note on shr colours52018
+Node: Note for Helm grep52431
+Node: Note on vc-annotate-background-mode53878
+Node: Contributing54732
+Node: Sources of the themes55151
+Node: Issues you can help with55913
+Node: Merge requests57100
+Node: Acknowledgements58182
+Node: Meta59639
+Node: External projects (ports)60692
+Node: GNU Free Documentation License61515
End Tag Table
- [elpa] externals/modus-operandi-theme 9f9160f 042/153: Miscellaneous Org tweaks for consistency, (continued)
- [elpa] externals/modus-operandi-theme 9f9160f 042/153: Miscellaneous Org tweaks for consistency, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 2968c4a 002/153: The themes are now part of upstream GNU Emacs, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 53606c6 011/153: Remove support for obsolete objed-extend face, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 9fed8eb 033/153: Update the manual's example to include new option, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme d9fa0ff 021/153: Add missing metadata to info manual, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme e596487 025/153: Add README in markdown format, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 619e48b 045/153: Tweak custom fonts section in the manual, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 113ab25 032/153: Simplify style of org-special-keyword, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 00f8a28 044/153: Update README to note that the manual is available, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 72c0714 038/153: Add support for eshell-syntax-highlighting, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 0633c2a 047/153: Recompile manual (cover 619e48bbc and decf274f4),
Stefan Monnier <=
- [elpa] externals/modus-operandi-theme d09be79 030/153: Expand docstring of new headings' alist option, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme d5b6321 028/153: Initial implementation of reviewed headings option, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 7789ae9 004/153: Clarify the version numbers that ship with Emacs, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 95ac8b4 020/153: Re-organise new doc files, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 49872b0 031/153: Expand manual with new heading styles alist option, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 3d00716 049/153: Use distinct colour for info-menu-star, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme a745281 053/153: Minor tweaks to custom modeline 'moody' option, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme decf274 046/153: Add manual entry on Org user faces (DIY), Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme 0e45c0a 056/153: Reword manual's entry on Org user faces, Stefan Monnier, 2021/03/18
- [elpa] externals/modus-operandi-theme ab61e17 029/153: Several refinements to new headings custom alist, Stefan Monnier, 2021/03/18