documentation_emacs_test/source/misc/modus-themes.org.fr.po

8978 lines
335 KiB
Plaintext
Raw Normal View History

2022-03-08 11:11:57 +01:00
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2021-11-07 12:11+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:7
msgid ""
"#+title: Modus themes for GNU Emacs #+author: Protesilaos Stavrou #+email: "
"info@protesilaos.com #+language: en #+options: ':t toc:nil author:t email:t "
"num:t #+startup: content"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:14
msgid ""
"#+macro: stable-version 1.6.0 #+macro: release-date 2021-09-29 #+macro: "
"development-version 1.7.0-dev #+macro: file "
"@@texinfo:@file{@@$1@@texinfo:}@@ #+macro: space @@texinfo:@: @@ #+macro: "
"kbd @@texinfo:@kbd{@@$1@@texinfo:}@@"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:23
msgid ""
"#+texinfo_filename: modus-themes.info #+texinfo_dir_category: Emacs misc "
"features #+texinfo_dir_title: Modus Themes: (modus-themes) "
"#+texinfo_dir_desc: Highly accessible themes (WCAG AAA) #+texinfo_header: "
"@set MAINTAINERSITE @uref{https://protesilaos.com,maintainer webpage} "
"#+texinfo_header: @set MAINTAINER Protesilaos Stavrou #+texinfo_header: @set "
"MAINTAINEREMAIL @email{info@protesilaos.com} #+texinfo_header: @set "
"MAINTAINERCONTACT @uref{mailto:info@protesilaos.com,contact the maintainer}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:25
msgid "#+texinfo: @insertcopying"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:29
msgid ""
"This manual, written by Protesilaos Stavrou, describes the customization "
"options for the ~modus-operandi~ and ~modus-vivendi~ themes, and provides "
"every other piece of information pertinent to them."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:34
msgid ""
"The documentation furnished herein corresponds to stable version "
"{{{stable-version}}}, released on {{{release-date}}}. Any reference to a "
"newer feature which does not yet form part of the latest tagged commit, is "
"explicitly marked as such."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:36
msgid "Current development target is {{{development-version}}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:38
msgid "#+toc: headlines 8 insert TOC here, with eight headline levels"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:44
#, no-wrap
msgid ""
"* COPYING\n"
":properties:\n"
":copying: t\n"
":custom_id: h:b14c3fcb-13dd-4144-9d92-2c58b3ed16d3\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:46
msgid "Copyright (C) 2020-2021 Free Software Foundation, Inc."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:54
msgid ""
"#+begin_quote Permission is granted to copy, distribute and/or modify this "
"document under the terms of the GNU Free Documentation License, Version 1.3 "
"or any later version published by the Free Software Foundation; with no "
"Invariant Sections, with the Front-Cover Texts being “A GNU Manual,” and "
"with the Back-Cover Texts as in (a) below. A copy of the license is "
"included in the section entitled “GNU Free Documentation License.”"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:58
msgid ""
"(a) The FSFs Back-Cover Text is: “You have the freedom to copy and modify "
"this GNU manual.” #+end_quote"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:63
#, no-wrap
msgid ""
"* Overview\n"
":properties:\n"
":custom_id: h:f0f3dbcb-602d-40cf-b918-8f929c441baf\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:69
msgid ""
"The Modus themes are designed for accessible readability. They conform with "
"the highest standard for color contrast between any given combination of "
"background and foreground values. This corresponds to the WCAG AAA "
"standard, which specifies a minimum rate of distance in relative luminance "
"of 7:1."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:74
msgid ""
"Modus Operandi (~modus-operandi~) is a light theme, while Modus Vivendi "
"(~modus-vivendi~) is dark. Each theme's color palette is designed to meet "
"the needs of the numerous interfaces that are possible in the Emacs "
"computing environment."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:79
msgid ""
"The overarching objective of this project is to always offer accessible "
"color combinations. There shall never be a compromise on this principle. "
"If there arises an inescapable trade-off between readability and stylistic "
"considerations, we will always opt for the former."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:83
msgid ""
"To ensure that users have a consistently accessible experience, the themes "
"strive to achieve as close to full face coverage as possible "
"([[#h:a9c8f29d-7f72-4b54-b74b-ddefe15d6a19][Face coverage]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:88
msgid ""
"Furthermore, the themes are designed to empower users with red-green color "
"deficiency (deuteranopia). This is achieved through customization options "
"which have the effect of replacing all relevant instances of green with a "
"variant of blue ([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization "
"Options]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:91
msgid ""
"Starting with version 0.12.0 and onwards, the themes are built into GNU "
"Emacs."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:97
#, no-wrap
msgid ""
"** How do the themes look like\n"
":properties:\n"
":custom_id: h:69b92089-069c-4ba1-9d94-cc3415fc4f87\n"
":end:\n"
"#+cindex: Screenshots\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:102
msgid ""
"Check the web page with "
"[[https://protesilaos.com/modus-themes-pictures/][the screen shots]]. There "
"are lots of scenarios on display that draw attention to details and "
"important aspects in the design of the themes. They also showcase the "
"numerous customization options."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:104
msgid "[[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization options]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:110
#, no-wrap
msgid ""
"** Learn about the latest changes\n"
":properties:\n"
":custom_id: h:2cc37c36-6c1a-48b2-a010-1050b270ee18\n"
":end:\n"
"#+cindex: Changelog\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:113
msgid ""
"Please refer to the [[https://protesilaos.com/modus-themes-changelog][web "
"page with the change log]]. It is comprehensive and covers everything that "
"goes into every tagged release of the themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:118
#, no-wrap
msgid ""
"* Installation\n"
":properties:\n"
":custom_id: h:1af85373-7f81-4c35-af25-afcef490c111\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:123
msgid ""
"The Modus themes are distributed with Emacs starting with version 28.1. On "
"older versions of Emacs, they can be installed using Emacs' package manager "
"or manually from their code repository. There also exist packages for "
"distributions of GNU/Linux."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:128
#, no-wrap
msgid ""
"** Install manually from source\n"
":properties:\n"
":custom_id: h:da3414b7-1426-46b8-8e76-47b845b76fd0\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:132
msgid ""
"In the following example, we are assuming that your Emacs files are stored "
"in =~/.emacs.d= and that you want to place the Modus themes in "
"=~/.emacs.d/modus-themes=."
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:135
#, markdown-text
msgid ""
"Get the source and store it in the desired path by running the following in "
"the command line shell:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:137
msgid ""
": $ git clone https://gitlab.com/protesilaos/modus-themes.git "
"~/.emacs.d/modus-themes"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:140
#, markdown-text
msgid ""
"Add that path to your known Elisp libraries' list, by placing this snippet "
"of Emacs Lisp in your init file (e.g. {{{file(init.el)}}}):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:144
msgid ""
"#+begin_src emacs-lisp (add-to-list 'load-path \"~/.emacs.d/modus-themes\") "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:146
msgid ""
"The themes are now ready to be used: "
"[[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enable and load]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:151
#, no-wrap
msgid ""
"** Install from the archives\n"
":properties:\n"
":custom_id: h:c4b10085-149f-43e2-bd4d-347f33aee054\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:154
msgid ""
"The ~modus-themes~ package is available from the GNU ELPA archive, which is "
"configured by default."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:158
msgid ""
"Prior to querying any package archive, make sure to have updated the index, "
"with {{{kbd(M-x package-refresh-contents)}}}. Then all you need to do is "
"type {{{kbd(M-x package-install)}}} and specify the ~modus-themes~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:162
msgid ""
"Note that older versions of the themes used to be distributed as standalone "
"packages. This practice has been discontinued starting with version 1.0.0 "
"of this project."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:164
msgid ""
"Once installed, the themes are ready to be used: "
"[[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enable and load]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:169
#, no-wrap
msgid ""
"** Install on GNU/Linux\n"
":properties:\n"
":custom_id: h:da640eb1-95dd-4e86-bb4e-1027b27885f0\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:174
msgid ""
"The themes are also available from the archives of some distributions of "
"GNU/Linux. These should correspond to a tagged release rather than building "
"directly from the latest Git commit. It all depends on the distro's "
"packaging policies."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:179
#, no-wrap
msgid ""
"*** Debian 11 Bullseye\n"
":properties:\n"
":custom_id: h:7e570360-9ee6-4bc5-8c04-9dc11418a3e4\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:181
msgid "The themes are part of Debian 11 Bullseye. Get them with:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:185
msgid "#+begin_src sh sudo apt install elpa-modus-themes #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:187
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:200
msgid ""
"They are now ready to be used: "
"[[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enable and load]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:192
#, no-wrap
msgid ""
"*** GNU Guix\n"
":properties:\n"
":custom_id: h:a4ca52cd-869f-46a5-9e16-4d9665f5b88e\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:194
msgid "Users of Guix can get the themes with this command:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:198
msgid "#+begin_src sh guix package -i emacs-modus-themes #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:211
#, no-wrap
msgid ""
"* Enable and load\n"
":properties:\n"
":custom_id: h:3f3c3728-1b34-437d-9d0c-b110f5b161a9\n"
":end:\n"
"#+findex: modus-themes-load-themes\n"
"#+findex: modus-themes-toggle\n"
"#+findex: modus-themes-load-operandi\n"
"#+findex: modus-themes-load-vivendi\n"
"#+cindex: Essential configuration\n"
"#+vindex: modus-themes-after-load-theme-hook\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:214
msgid ""
"Users of the built-in themes can load and automatically enable the theme of "
"their preference by adding either form to their init file:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:219
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(load-theme 'modus-operandi) ; Light theme\n"
"(load-theme 'modus-vivendi) ; Dark theme\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:221
msgid "This is all one needs."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:225
msgid ""
"Users of packaged variants of the themes must add a few more lines to ensure "
"that everything works as intended. First, one has to require the main "
"library before loading either theme:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:229
msgid "#+begin_src emacs-lisp (require 'modus-themes) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:232
msgid ""
"Then it is recommended to load the individual theme files with the helper "
"function ~modus-themes-load-themes~:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:237
msgid ""
"#+begin_src emacs-lisp ;; Load the theme files before enabling a theme (else "
"you get an error). (modus-themes-load-themes) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:240
msgid ""
"Once the libraries that define the themes are enabled, one can activate a "
"theme with either of the following expressions:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:246
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-load-operandi) ; Light theme\n"
";; OR\n"
"(modus-themes-load-vivendi) ; Dark theme\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:253
msgid ""
"Changes to the available customization options must always be evaluated "
"before loading a theme "
"([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization Options]]). An "
"exception to this norm is when using the various Custom interfaces or with "
"commands like {{{kbd(M-x customize-set-variable)}}}, which automatically "
"reload the theme by default "
"([[#h:9001527a-4e2c-43e0-98e8-3ef72d770639][Option for inhibiting theme "
"reload]]). This is how a basic setup could look like:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:256
msgid "#+begin_src emacs-lisp (require 'modus-themes)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:260
#, no-wrap
msgid ""
";; Your customisations here. For example:\n"
"(setq modus-themes-bold-constructs t\n"
" modus-themes-mode-line '3d)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:263
msgid ""
";; Load the theme files before enabling a theme (else you get an error). "
"(modus-themes-load-themes)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:266
msgid ";; Enable the theme of your preference: (modus-themes-load-operandi)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:270
msgid ""
";; Optionally add a key binding for the toggle between the themes: "
"(define-key global-map (kbd \"<f5>\") #'modus-themes-toggle) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:272
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:356
msgid ""
"[[#h:e979734c-a9e1-4373-9365-0f2cd36107b8][Sample configuration for "
"use-package]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:276
msgid ""
"With those granted, bear in mind a couple of technical points on "
"~modus-themes-load-operandi~ and ~modus-themes-load-vivendi~, as well as "
"~modus-themes-toggle~ which relies on them:"
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:279
#, markdown-text
msgid ""
"Those functions call ~load-theme~. Some users prefer to opt for "
"~enable-theme~ instead "
"([[#h:e68560b3-7fb0-42bc-a151-e015948f8a35][Differences between loading and "
"enabling]])."
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:285
#, markdown-text
msgid ""
"The functions will run the ~modus-themes-after-load-theme-hook~ as their "
"final step. This can be employed for bespoke configurations "
"([[#h:f4651d55-8c07-46aa-b52b-bed1e53463bb][Advanced customization "
"(do-it-yourself)]]). Experienced users may not wish to rely on such a hook "
"and the functions that run it: they may prefer a custom solution "
"([[#h:86f6906b-f090-46cc-9816-1fe8aeb38776][A theme-agnostic hook for theme "
"loading]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:291
#, no-wrap
msgid ""
"** Sample configuration for use-package\n"
":properties:\n"
":custom_id: h:e979734c-a9e1-4373-9365-0f2cd36107b8\n"
":end:\n"
"#+cindex: use-package configuration\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:294
msgid ""
"It is common for Emacs users to rely on ~use-package~ for declaring package "
"configurations in their setup. We use this as an example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:303
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(use-package modus-themes\n"
" :ensure ; omit this to use the built-in themes\n"
" :init\n"
" ;; Add all your customizations prior to loading the themes\n"
" (setq modus-themes-italic-constructs t\n"
" modus-themes-bold-constructs nil\n"
" modus-themes-region '(bg-only no-extend))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:311
#, no-wrap
msgid ""
" ;; Load the theme files before enabling a theme (else you get an error).\n"
" (modus-themes-load-themes)\n"
" :config\n"
" ;; Load the theme of your choice:\n"
" (modus-themes-load-operandi) ;; OR (modus-themes-load-vivendi)\n"
" :bind (\"<f5>\" . modus-themes-toggle))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:313
msgid ""
"[[#h:e68560b3-7fb0-42bc-a151-e015948f8a35][Differences between loading and "
"enabling]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:319
msgid ""
"Note: make sure not to customize the variable ~custom-theme-load-path~ or "
"~custom-theme-directory~ after the themes' package declaration. That will "
"lead to failures in loading the files. If either or both of those variables "
"need to be changed, their values should be defined before the package "
"declaration of the themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:325
#, no-wrap
msgid ""
"** Differences between loading and enabling\n"
":properties:\n"
":custom_id: h:e68560b3-7fb0-42bc-a151-e015948f8a35\n"
":end:\n"
"#+cindex: load-theme VS enable-theme\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:331
msgid ""
"The reason we recommend ~load-theme~ instead of the other option of "
"~enable-theme~ is that the former does a kind of \"reset\" on the face "
"specs. It quite literally loads (or re-loads) the theme. Whereas the "
"latter simply puts an already loaded theme at the top of the list of enabled "
"items, re-using whatever state was last loaded."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:336
msgid ""
"As such, ~load-theme~ reads all customizations that may happen during any "
"given Emacs session: even after the initial setup of a theme. Examples are "
"calls to ~custom-set-faces~, as well as new values assigned to the options "
"the Modus themes provide "
"([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization Options]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:341
msgid ""
"Our tests show that ~enable-theme~ does not read such variables anew, so it "
"might appear to the unsuspecting user that the themes are somehow broken "
"whenever they try to assign a new value to a customization option or some "
"face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:346
msgid ""
"This \"reset\" that ~load-theme~ conducts does, however, come at the cost of "
"being somewhat slower than ~enable-theme~. Users who have a stable setup "
"and who seldom update their variables during a given Emacs session, are "
"better off using something like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:351
msgid ""
"#+begin_src emacs-lisp (require 'modus-themes) (load-theme 'modus-operandi "
"t t) (load-theme 'modus-vivendi t t)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:354
msgid ""
"(enable-theme 'modus-operandi) ;; OR (enable-theme 'modus-vivendi) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:360
msgid ""
"With the above granted, other sections of the manual discuss how to "
"configure custom faces, where ~load-theme~ is expected, though "
"~enable-theme~ could still apply in stable setups:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:362
msgid ""
"[[#h:1487c631-f4fe-490d-8d58-d72ffa3bd474][Case-by-case face specs using the "
"themes' palette]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:364
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2009
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3496
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3659
msgid ""
"[[#h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae][Face specs at scale using the "
"themes' palette]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:369
#, no-wrap
msgid ""
"* Customization Options\n"
":properties:\n"
":custom_id: h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:373
msgid ""
"The Modus themes are highly configurable, though they should work well "
"without any further tweaks. By default, all customization options are set "
"to nil, unless otherwise noted in this manual."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:376
msgid ""
"Remember that all customization options must be evaluated before loading a "
"theme ([[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enable and load]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:379
msgid ""
"Below is a summary of what you will learn in the subsequent sections of this "
"manual."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:388
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-italic-constructs t\n"
" modus-themes-bold-constructs nil\n"
" modus-themes-no-mixed-fonts nil\n"
" modus-themes-subtle-line-numbers nil\n"
" modus-themes-success-deuteranopia t\n"
" modus-themes-tabs-accented t\n"
" modus-themes-inhibit-reload t ; only applies to "
"`customize-set-variable' and related\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:390
#, no-wrap
msgid " modus-themes-fringes nil ; {nil,'subtle,'intense}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:396
#, no-wrap
msgid ""
" ;; Options for `modus-themes-lang-checkers' are either nil (the\n"
" ;; default), or a list of properties that may include any of those\n"
" ;; symbols: `straight-underline', `text-also', `background',\n"
" ;; `intense'\n"
" modus-themes-lang-checkers nil\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:401
#, no-wrap
msgid ""
" ;; Options for `modus-themes-mode-line' are either nil, or a list\n"
" ;; that can combine any of `3d' OR `moody', `borderless',\n"
" ;; `accented', `padded'.\n"
" modus-themes-mode-line '(padded accented borderless)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:406
#, no-wrap
msgid ""
" ;; Options for `modus-themes-syntax' are either nil (the default),\n"
" ;; or a list of properties that may include any of those symbols:\n"
" ;; `faint', `yellow-comments', `green-strings', `alt-syntax'\n"
" modus-themes-syntax nil\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:411
#, no-wrap
msgid ""
" ;; Options for `modus-themes-hl-line' are either nil (the default),\n"
" ;; or a list of properties that may include any of those symbols:\n"
" ;; `accented', `underline', `intense'\n"
" modus-themes-hl-line '(underline accented)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:416
#, no-wrap
msgid ""
" ;; Options for `modus-themes-paren-match' are either nil (the\n"
" ;; default), or a list of properties that may include any of those\n"
" ;; symbols: `bold', `intense', `underline'\n"
" modus-themes-paren-match '(bold intense)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:422
#, no-wrap
msgid ""
" ;; Options for `modus-themes-links' are either nil (the default),\n"
" ;; or a list of properties that may include any of those symbols:\n"
" ;; `neutral-underline' OR `no-underline', `faint' OR `no-color',\n"
" ;; `bold', `italic', `background'\n"
" modus-themes-links '(neutral-underline background)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:427
#, no-wrap
msgid ""
" ;; Options for `modus-themes-prompts' are either nil (the\n"
" ;; default), or a list of properties that may include any of those\n"
" ;; symbols: `background', `bold', `gray', `intense', `italic'\n"
" modus-themes-prompts '(intense bold)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:429
#, no-wrap
msgid " modus-themes-completions 'moderate ; {nil,'moderate,'opinionated}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:431
#, no-wrap
msgid " modus-themes-mail-citations nil ; {nil,'faint,'monochrome}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:436
#, no-wrap
msgid ""
" ;; Options for `modus-themes-region' are either nil (the default),\n"
" ;; or a list of properties that may include any of those symbols:\n"
" ;; `no-extend', `bg-only', `accented'\n"
" modus-themes-region '(bg-only no-extend)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:440
#, no-wrap
msgid ""
" ;; Options for `modus-themes-diffs': nil, 'desaturated,\n"
" ;; 'bg-only, 'deuteranopia, 'fg-only-deuteranopia\n"
" modus-themes-diffs 'fg-only-deuteranopia\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:442
#, no-wrap
msgid ""
" modus-themes-org-blocks 'gray-background ; "
"{nil,'gray-background,'tinted-background}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:449
#, no-wrap
msgid ""
" modus-themes-org-agenda ; this is an alist: read the manual or its doc "
"string\n"
" '((header-block . (variable-pitch scale-title))\n"
" (header-date . (grayscale workaholic bold-today))\n"
" (event . (accented scale-small))\n"
" (scheduled . uniform)\n"
" (habit . traffic-light-deuteranopia))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:454
#, no-wrap
msgid ""
" modus-themes-headings ; this is an alist: read the manual or its doc "
"string\n"
" '((1 . (overline background))\n"
" (2 . (rainbow overline))\n"
" (t . (no-bold)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:464
#, no-wrap
msgid ""
" modus-themes-variable-pitch-ui nil\n"
" modus-themes-variable-pitch-headings t\n"
" modus-themes-scale-headings t\n"
" modus-themes-scale-1 1.1\n"
" modus-themes-scale-2 1.15\n"
" modus-themes-scale-3 1.21\n"
" modus-themes-scale-4 1.27\n"
" modus-themes-scale-title 1.33)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:472
#, no-wrap
msgid ""
"** Option for inhibiting theme reload\n"
":properties:\n"
":alt_title: Custom reload theme\n"
":description: Toggle auto-reload of the theme when setting custom "
"variables\n"
":custom_id: h:9001527a-4e2c-43e0-98e8-3ef72d770639\n"
":end:\n"
"#+vindex: modus-themes-inhibit-reload\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:474
msgid "Symbol: ~modus-themes-inhibit-reload~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:476
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:497
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:527
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:555
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:643
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:891
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:912
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:957
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:986
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1244
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1290
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1597
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1687
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1714
msgid "Possible values:"
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:479
#, markdown-text
msgid "~nil~"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:479
#, markdown-text
msgid "~t~ (default)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:483
msgid ""
"By default, customizing a theme-related user option through the Custom "
"interfaces or with {{{kbd(M-x customize-set-variable)}}} will not reload the "
"currently active Modus theme."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:485
msgid "Enable this behaviour by setting this variable to ~nil~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:493
#, no-wrap
msgid ""
"** Option for color-coding success state (deuteranopia)\n"
":properties:\n"
":alt_title: Success' color-code\n"
":description: Toggle blue color for success or done states\n"
":custom_id: h:3ed03a48-20d8-4ce7-b214-0eb7e4c79abe\n"
":end:\n"
"#+vindex: modus-themes-success-deuteranopia\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:495
msgid "Symbol: ~modus-themes-success-deuteranopia~"
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:500
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:530
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:558
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:646
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:916
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:961
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:990
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1125
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1250
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1294
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1600
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1690
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1717
#, markdown-text
msgid "~nil~ (default)"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:500
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:530
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:558
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:646
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1125
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1600
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1690
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1717
#, markdown-text
msgid "~t~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:503
msgid ""
"The default is to colorise all faces that denote \"success\", \"done\", or "
"similar with a variant of green."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:506
msgid ""
"With a non-nil value (~t~), use variants of blue instead of green. This is "
"meant to empower users with red-green color deficiency."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:510
msgid ""
"The present customization option should apply to all contexts where there "
"can be a color-coded distinction between success and failure, to-do and "
"done, and so on."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:513
msgid ""
"Diffs, which have a red/green dichotomy by default, can also be configured "
"to conform with deuteranopia."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:515
msgid "[[#h:ea7ac54f-5827-49bd-b09f-62424b3b6427][Option for diff buffer looks]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:523
#, no-wrap
msgid ""
"** Option for more bold constructs\n"
":properties:\n"
":alt_title: Bold constructs\n"
":description: Toggle bold constructs in code\n"
":custom_id: h:b25714f6-0fbe-41f6-89b5-6912d304091e\n"
":end:\n"
"#+vindex: modus-themes-bold-constructs\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:525
msgid "Symbol: ~modus-themes-bold-constructs~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:533
msgid "The default is to use a bold typographic weight only when it is required."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:538
msgid ""
"With a non-nil value (~t~) display several syntactic constructs in bold "
"weight. This concerns keywords and other important aspects of code syntax. "
"It also affects certain mode line indicators and command-line prompts."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:541
msgid ""
"Advanced users may also want to configure the exact attributes of the ~bold~ "
"face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:543
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:569
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2501
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3413
msgid ""
"[[#h:2793a224-2109-4f61-a106-721c57c01375][Configure bold and italic "
"faces]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:551
#, no-wrap
msgid ""
"** Option for more italic constructs\n"
":properties:\n"
":alt_title: Italic constructs\n"
":description: Toggle italic font constructs in code\n"
":custom_id: h:977c900d-0d6d-4dbb-82d9-c2aae69543d6\n"
":end:\n"
"#+vindex: modus-themes-italic-constructs\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:553
msgid "Symbol: ~modus-themes-italic-constructs~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:561
msgid ""
"The default is to not use slanted text forms (italics) unless it is "
"absolutely necessary."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:564
msgid ""
"With a non-nil value (~t~) choose to render more faces in italics. This "
"typically affects documentation strings and code comments."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:567
msgid ""
"Advanced users may also want to configure the exact attributes of the "
"~italic~ face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:577
#, no-wrap
msgid ""
"** Option for syntax highlighting\n"
":properties:\n"
":alt_title: Syntax styles\n"
":description: Choose the overall aesthetic of code syntax\n"
":custom_id: h:c119d7b2-fcd4-4e44-890e-5e25733d5e52\n"
":end:\n"
"#+vindex: modus-themes-syntax\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:579
msgid "Symbol: ~modus-themes-syntax~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:582
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:674
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:745
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1011
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1071
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1152
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1199
msgid ""
"Possible values are expressed as a list of properties (default is ~nil~ or "
"an empty list). The list can include any of the following symbols:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:587
msgid "+ ~faint~ + ~yellow-comments~ + ~green-strings~ + ~alt-syntax~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:593
msgid ""
"The default (a ~nil~ value or an empty list) is to use a balanced "
"combination of colors on the cyan-blue-magenta side of the spectrum. There "
"is little to no use of greens, yellows, and reds. Comments are gray, "
"strings are blue colored, doc strings are a shade of cyan, while color "
"combinations are designed to avoid exaggerations."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:596
msgid ""
"The property ~faint~ fades the saturation of all applicable colors, where "
"that is possible or appropriate."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:598
msgid "The property ~yellow-comments~ applies a yellow color to comments."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:601
msgid ""
"The property ~green-strings~ applies a green color to strings and a green "
"tint to doc strings."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:605
msgid ""
"The property ~alt-syntax~ changes the combination of colors beyond strings "
"and comments, so that the effective palette is broadened to provide greater "
"variety relative to the default."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:608
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:712
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:773
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:843
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1090
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1169
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1218
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1543
msgid ""
"Combinations of any of those properties are expressed as a list, like in "
"these examples:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:615
msgid ""
"#+begin_src emacs-lisp (faint) (green-strings yellow-comments) (alt-syntax "
"green-strings yellow-comments) (faint alt-syntax green-strings "
"yellow-comments) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:617
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:721
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:782
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:851
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1048
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1098
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1177
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1226
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1551
msgid "The order in which the properties are set is not significant."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:619
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:723
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:784
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:853
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1050
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1100
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1179
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1228
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1553
msgid "In user configuration files the form may look like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:623
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-syntax '(faint alt-syntax)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:627
msgid ""
"Independent of this variable, users may also control the use of a bold "
"weight or italic text: ~modus-themes-bold-constructs~ and "
"~modus-themes-italic-constructs~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:629
msgid ""
"[[#h:b25714f6-0fbe-41f6-89b5-6912d304091e][Option for more bold "
"constructs]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:631
msgid ""
"[[#h:977c900d-0d6d-4dbb-82d9-c2aae69543d6][Option for more italic "
"constructs]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:639
#, no-wrap
msgid ""
"** Option for no font mixing\n"
":properties:\n"
":alt_title: No mixed fonts\n"
":description: Toggle mixing of font families\n"
":custom_id: h:115e6c23-ee35-4a16-8cef-e2fcbb08e28b\n"
":end:\n"
"#+vindex: modus-themes-no-mixed-fonts\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:641
msgid "Symbol: ~modus-themes-no-mixed-fonts~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:654
msgid ""
"By default, the themes configure some spacing-sensitive faces like Org "
"tables and code blocks to always inherit from the ~fixed-pitch~ face. This "
"is to ensure that those constructs remain monospaced even when users opt for "
"a mode that remaps typeface families, such as the built-in {{{kbd(M-x "
"variable-pitch-mode)}}}. Otherwise the layout would appear broken, due to "
"how spacing is done. To disable this behaviour, set the option to ~t~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:659
msgid ""
"Users may prefer to use another package for handling mixed typeface "
"configurations, rather than letting the theme do it, perhaps because a "
"purpose-specific package has extra functionality. Two possible options are "
"~org-variable-pitch~ and ~mixed-pitch~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:661
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1702
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1725
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2551
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3890
msgid ""
"[[#h:defcf4fc-8fa8-4c29-b12e-7119582cc929][Font configurations for Org and "
"others]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:669
#, no-wrap
msgid ""
"** Option for links\n"
":properties:\n"
":alt_title: Link styles\n"
":description: Choose among several styles, with or without underline\n"
":custom_id: h:c119d7b2-fcd4-4e44-890e-5e25733d5e52\n"
":end:\n"
"#+vindex: modus-themes-links\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:671
msgid "Symbol: ~modus-themes-links~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "Underline style:"
msgstr ""
#. type: Bullet: ' - '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~neutral-underline~"
msgstr ""
#. type: Bullet: ' - '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~no-underline~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "Text coloration:"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:961
#, markdown-text
msgid "~faint~"
msgstr ""
#. type: Bullet: ' - '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~no-color~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~bold~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~italic~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:684
#, markdown-text
msgid "~background~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:687
msgid ""
"The default (a ~nil~ value or an empty list) is a prominent text color, "
"typically blue, with an underline of the same color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:692
msgid ""
"For the style of the underline, a ~neutral-underline~ property turns the "
"color of the line into a subtle gray, while the ~no-underline~ property "
"removes the line altogether. If both of those are set, the latter takes "
"precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:697
msgid ""
"For text coloration, a ~faint~ property desaturates the color of the text "
"and the underline, unless the underline is affected by the aforementioned "
"properties. While a ~no-color~ property removes the color from the text. "
"If both of those are set, the latter takes precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:700
msgid ""
"A ~bold~ property applies a heavy typographic weight to the text of the "
"link."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:703
msgid ""
"An ~italic~ property adds a slant to the link's text (italic or oblique "
"forms, depending on the typeface)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:705
msgid "A ~background~ property applies a subtle tinted background color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:709
msgid ""
"In case both ~no-underline~ and ~no-color~ are set, then a subtle gray "
"background is applied to all links. This can still be combined with the "
"~bold~ and ~italic~ properties."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:719
msgid ""
"#+begin_src emacs-lisp (faint) (no-underline faint) (no-color no-underline "
"bold) (italic bold background no-color no-underline) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:727
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-links '(neutral-underline "
"background)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:732
msgid ""
"The placement of the underline, meaning its proximity to the text, is "
"controlled by ~x-use-underline-position-properties~, "
"~x-underline-at-descent-line~, ~underline-minimum-offset~. Please refer to "
"their documentation strings."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:740
#, no-wrap
msgid ""
"** Option for command prompt styles\n"
":properties:\n"
":alt_title: Command prompts\n"
":description: Choose among plain, subtle, or intense prompts\n"
":custom_id: h:db5a9a7c-2928-4a28-b0f0-6f2b9bd52ba1\n"
":end:\n"
"#+vindex: modus-themes-prompts\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:742
msgid "Symbol: ~modus-themes-prompts~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:751
msgid "+ ~background~ + ~bold~ + ~gray~ + ~intense~ + ~italic~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:754
msgid ""
"The default (a ~nil~ value or an empty list) means to only use a subtle "
"accented foreground color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:757
msgid ""
"The property ~background~ applies a background color to the prompt's text. "
"By default, this is a subtle accented value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:761
msgid ""
"The property ~intense~ makes the foreground color more prominent. If the "
"~background~ property is also set, it amplifies the value of the background "
"as well."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:766
msgid ""
"The property ~gray~ changes the prompt's colors to grayscale. This affects "
"the foreground and, if the ~background~ property is also set, the "
"background. Its effect is subtle, unless it is combined with the ~intense~ "
"property."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:770
msgid ""
"The property ~bold~ makes the text use a bold typographic weight. "
"Similarly, ~italic~ adds a slant to the font's forms (italic or oblique "
"forms, depending on the typeface)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:780
msgid ""
"#+begin_src emacs-lisp (intense) (bold intense) (intense bold gray) "
"(intense background gray bold) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:788
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-prompts '(background gray)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:796
#, no-wrap
msgid ""
"** Option for mode line presentation\n"
":properties:\n"
":alt_title: Mode line\n"
":description: Choose among several styles, with or without borders\n"
":custom_id: h:27943af6-d950-42d0-bc23-106e43f50a24\n"
":end:\n"
"#+vindex: modus-themes-mode-line\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:798
msgid "Symbol: ~modus-themes-mode-line~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:801
msgid ""
"Possible values, which can be expressed as a list of combinations of box "
"effect, color, and border visibility:"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "Overall style:"
msgstr ""
#. type: Bullet: ' - '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "~3d~"
msgstr ""
#. type: Bullet: ' - '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "~moody~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "~accented~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "~borderless~"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:808
#, markdown-text
msgid "~padded~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:813
msgid ""
"The default (a nil value or an empty list) is a two-dimensional rectangle "
"with a border around it. The active and the inactive mode lines use "
"different shades of grayscale values for the background, foreground, border."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:817
msgid ""
"The ~3d~ property applies a three-dimensional effect to the active mode "
"line. The inactive mode lines remain two-dimensional and are toned down a "
"bit, relative to the default style."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:826
msgid ""
"The ~moody~ property optimizes the mode line for use with the library of the "
"same name (hereinafter referred to as 'Moody'). In practice, it removes the "
"box effect and replaces it with underline and overline properties. It also "
"tones down the inactive mode lines. Despite its intended purpose, this "
"option can also be used without the Moody library (please consult the "
"themes' manual on this point for more details). If both ~3d~ and ~moody~ "
"properties are set, the latter takes precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:830
msgid ""
"The ~borderless~ property removes the color of the borders. It does not "
"actually remove the borders, but only makes their color the same as the "
"background, effectively creating some padding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:833
msgid ""
"The ~accented~ property ensures that the active mode line uses a colored "
"background instead of the standard shade of gray."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:840
msgid ""
"The ~padded~ property increases the apparent height of the mode line. This "
"is done by applying box effects and combining them with an underline and "
"overline. To ensure that the underline is placed at the bottom, set "
"~x-underline-at-descent-line~ to non-nil. The ~padded~ property has no "
"effect when the ~moody~ property is also used, because Moody already applies "
"its own padding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:849
msgid ""
"#+begin_src emacs-lisp (accented) (borderless 3d) (moody accented "
"borderless) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:857
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-mode-line '(borderless accented)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:875
msgid ""
"Note that Moody does not expose any faces that the themes could style "
"directly. Instead it re-purposes existing ones to render its tabs and "
"ribbons. As such, there may be cases where the contrast ratio falls below "
"the 7:1 target that the themes conform with (WCAG AAA). To hedge against "
"this, we configure a fallback foreground for the ~moody~ property, which "
"will come into effect when the background of the mode line changes to "
"something less accessible, such as Moody ribbons (read the doc string of "
"~set-face-attribute~, specifically ~:distant-foreground~). This fallback is "
"activated when Emacs determines that the background and foreground of the "
"given construct are too close to each other in terms of color distance. In "
"practice, users will need to experiment with the variable "
"~face-near-same-color-threshold~ to trigger the effect. We find that a "
"value of =45000= shall suffice, contrary to the default =30000=. Though for "
"the combinations that involve the ~accented~ and ~moody~ properties, as "
"mentioned above, that should be raised up to =70000=. Do not set it too "
"high, because it has the adverse effect of always overriding the default "
"colors (which have been carefully designed to be highly accessible)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:879
msgid ""
"Furthermore, because Moody expects an underline and overline instead of a "
"box style, it is advised to set ~x-underline-at-descent-line~ to a non-nil "
"value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:887
#, no-wrap
msgid ""
"** Option for accented background in tab interfaces\n"
":properties:\n"
":alt_title: Tab style\n"
":description: Toggle accented background for tabs\n"
":custom_id: h:27cef8f5-dc4e-4c93-ba41-b899e650d936\n"
":end:\n"
"#+vindex: modus-themes-tabs-accented\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:889
msgid "Symbol: ~modus-themes-tabs-accented~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:894
msgid "+ ~nil~ (default) + ~t~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:897
msgid ""
"By default, all tab interfaces use backgrounds which are shades of gray. "
"When this option is set to non-nil, the backgrounds become colorful."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:900
msgid ""
"This affects the built-in ~tab-bar-mode~ and ~tab-line-mode~, as well as the "
"Centaur tabs package."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:908
#, no-wrap
msgid ""
"** Option for completion framework aesthetics\n"
":properties:\n"
":alt_title: Completion UIs\n"
":description: Choose among standard, moderate, or opinionated looks\n"
":custom_id: h:f1c20c02-7b34-4c35-9c65-99170efb2882\n"
":end:\n"
"#+vindex: modus-themes-completions\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:910
msgid "Symbol: ~modus-themes-completions~"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:916
#, markdown-text
msgid "~moderate~"
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:916
#, markdown-text
msgid "~opinionated~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:925
msgid ""
"This is a special option that has different effects depending on the "
"completion UI. The interfaces can be grouped in two categories, based on "
"their default aesthetics: (i) those that only or mostly use foreground "
"colors for their interaction model, and (ii) those that combine background "
"and foreground values for some of their metaphors. The former category "
"encompasses Icomplete, Ido, Selectrum, Vertico, as well as pattern matching "
"styles like Orderless and Flx. The latter covers Helm, Ivy, and Sallet."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:928
msgid ""
"A value of ~nil~ (the default) will simply respect the metaphors of each "
"completion framework."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:934
msgid ""
"Option ~moderate~ applies a combination of background and foreground that is "
"fairly subtle. For Icomplete and friends this constitutes a departure from "
"their default aesthetics, however the difference is small. While Helm, Ivy "
"et al appear slightly different than their original looks, as they are toned "
"down a bit."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:941
msgid ""
"Option ~opinionated~ uses color combinations that refashion the completion "
"UI. For the Icomplete camp this means that intense background and "
"foreground combinations are used: in effect their looks emulate those of "
"Helm, Ivy and co. in their original style. Whereas the other group of "
"packages will revert to an even more nuanced aesthetic with some additional "
"changes to the choice of hues."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:945
msgid ""
"To appreciate the scope of this customization option, you should spend some "
"time with every one of the ~nil~ (default), ~moderate~, and ~opinionated~ "
"possibilities."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:953
#, no-wrap
msgid ""
"** Option for mail citations\n"
":properties:\n"
":alt_title: Mail citations\n"
":description: Choose among colorful, desaturated, monochrome citations\n"
":custom_id: h:5a12765d-0ba0-4a75-ab11-e35d3bbb317d\n"
":end:\n"
"#+vindex: modus-themes-mail-citations\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:955
msgid "Symbol: ~modus-themes-mail-citations~"
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:961
#, markdown-text
msgid "~monochrome~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:965
msgid ""
"By default, citations in email-related buffers apply contrasting hues to "
"different levels of depth in cited text. The colors are fairly easy to tell "
"apart."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:968
msgid ""
"A value of ~faint~ makes all citation levels less intense, while retaining "
"the default style of contrasting hues (albeit very subtle ones)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:970
msgid "Option ~monochrome~ turns all citations in to a uniform shade of gray."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:974
msgid ""
"Whatever the value assigned to this variable, citations in emails are "
"controlled by typographic elements or indentation, which the themes do not "
"touch."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:982
#, no-wrap
msgid ""
"** Option for fringe visibility\n"
":properties:\n"
":alt_title: Fringes\n"
":description: Choose among invisible, subtle, or intense fringe styles\n"
":custom_id: h:1983c3fc-74f6-44f3-b917-967c403bebae\n"
":end:\n"
"#+vindex: modus-themes-fringes\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:984
msgid "Symbol: ~modus-themes-fringes~"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:990
#, markdown-text
msgid "~subtle~"
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:990
#, markdown-text
msgid "~intense~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:994
msgid ""
"The default is to use the same color as that of the main background, meaning "
"that the fringes are not obvious though they still occupy the space given to "
"them by ~fringe-mode~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:998
msgid ""
"Options ~subtle~ and ~intense~ apply a gray background, making the fringes "
"visible. The difference between the two is one of degree, as their names "
"imply."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1006
#, no-wrap
msgid ""
"** Option for language checkers\n"
":properties:\n"
":alt_title: Language checkers\n"
":description: Control the style of language checkers/linters\n"
":custom_id: h:4b13743a-8ebf-4d2c-a043-cceba10b1eb4\n"
":end:\n"
"#+vindex: modus-themes-lang-checkers\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1008
msgid "Symbol: ~modus-themes-lang-checkers~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1016
msgid "+ ~straight-underline~ + ~text-also~ + ~background~ + ~intense~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1021
msgid ""
"The default (a ~nil~ value or an empty list) applies a color-coded underline "
"to the affected text, while it leaves the original foreground intact. If "
"the display spec of Emacs has support for it, the underline's style is that "
"of a wave, otherwise it is a straight line."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1024
msgid ""
"The property ~straight-underline~ ensures that the underline under the "
"affected text is always drawn as a straight line."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1027
msgid ""
"The property ~text-also~ applies the same color of the underline to the "
"affected text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1029
msgid "The property ~background~ adds a color-coded background."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1033
msgid ""
"The property ~intense~ amplifies the applicable colors if ~background~ "
"and/or ~text-only~ are set. If ~intense~ is set on its own, then it implies "
"~text-only~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1037
msgid ""
"To disable fringe indicators for Flymake or Flycheck, refer to variables "
"~flymake-fringe-indicator-position~ and ~flycheck-indication-mode~, "
"respectively."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1040
msgid ""
"Combinations of any of those properties can be expressed in a list, as in "
"those examples:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1046
msgid ""
"#+begin_src emacs-lisp (background) (straight-underline intense) "
"(background text-also straight-underline) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1054
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-lang-checkers '(text-also "
"background)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1058
msgid ""
"NOTE: The placement of the straight underline, though not the wave style, is "
"controlled by the built-in variables ~underline-minimum-offset~, "
"~x-underline-at-descent-line~, ~x-use-underline-position-properties~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1066
#, no-wrap
msgid ""
"** Option for line highlighting (hl-line-mode)\n"
":properties:\n"
":alt_title: Line highlighting\n"
":description: Choose style of current line (hl-line-mode)\n"
":custom_id: h:1dba1cfe-d079-4c13-a810-f768e8789177\n"
":end:\n"
"#+vindex: modus-themes-hl-line\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1068
msgid "Symbol: ~modus-themes-hl-line~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1075
msgid "+ ~accented~ + ~intense~ + ~underline~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1078
msgid ""
"The default (a ~nil~ value or an empty list) is a subtle gray background "
"color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1080
msgid "The property ~accented~ changes the background to a colored variant."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1084
msgid ""
"An ~underline~ property draws a line below the highlighted area. Its color "
"is similar to the background, so gray by default or an accent color when "
"~accented~ is also set."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1087
msgid ""
"An ~intense~ property amplifies the colors in use, which may be both the "
"background and the underline."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1096
msgid ""
"#+begin_src emacs-lisp (intense) (underline intense) (accented intense "
"underline) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1104
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-hl-line '(underline accented)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1107
msgid ""
"Set ~x-underline-at-descent-line~ to a non-nil value for better results with "
"underlines."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1110
msgid ""
"This style affects several packages that enable ~hl-line-mode~, such as "
"=elfeed=, =notmuch=, and =mu4e=."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1118
#, no-wrap
msgid ""
"** Option for line numbers (display-line-numbers-mode)\n"
":properties:\n"
":alt_title: Line numbers\n"
":description: Toggle subtle style for line numbers\n"
":custom_id: h:8c4a6230-2e43-4aa2-a631-3b7179392e09\n"
":end:\n"
"#+vindex: modus-themes-subtle-line-numbers\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1120
msgid "Symbol: ~modus-themes-subtle-line-numbers~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1122
msgid "Possible value:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1130
msgid ""
"The default style for ~display-line-numbers-mode~ and its global variant is "
"to apply a subtle gray background to the line numbers. The current line has "
"a more pronounced background and foreground combination to bring more "
"attention to itself."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1134
msgid ""
"Similarly, the faces for ~display-line-numbers-major-tick~ and its "
"counterpart ~display-line-numbers-minor-tick~ use appropriate styles that "
"involve a bespoke background and foreground combination."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1139
msgid ""
"With a non-nil value (~t~), line numbers have no background of their own. "
"Instead they retain the primary background of the theme, blending with the "
"rest of the buffer. Foreground values for all relevant faces are updated to "
"accommodate this aesthetic."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1147
#, no-wrap
msgid ""
"** Option for parenthesis matching (show-paren-mode)\n"
":properties:\n"
":alt_title: Matching parentheses\n"
":description: Choose between various styles for matching "
"delimiters/parentheses\n"
":custom_id: h:e66a7e4d-a512-4bc7-9f86-fbbb5923bf37\n"
":end:\n"
"#+vindex: modus-themes-paren-match\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1149
msgid "Symbol: ~modus-themes-paren-match~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1156
msgid "+ ~bold~ + ~intense~ + ~underline~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1158
msgid "The default (a ~nil~ value or an empty list) is a subtle background color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1161
msgid ""
"The ~bold~ property adds a bold weight to the characters of the matching "
"delimiters."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1164
msgid ""
"The ~intense~ property applies a more prominent background color to the "
"delimiters."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1166
msgid "The ~underline~ property draws a straight line under the affected text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1175
msgid ""
"#+begin_src emacs-lisp (bold) (underline intense) (bold intense underline) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1183
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-paren-match '(bold intense)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1186
msgid ""
"This customization variable affects the built-in ~show-paren-mode~ and the "
"=smartparens= package."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1194
#, no-wrap
msgid ""
"** Option for active region\n"
":properties:\n"
":alt_title: Active region\n"
":description: Choose between various styles for the active region\n"
":custom_id: h:60798063-b4ad-45ea-b9a7-ff7b5c0ab74c\n"
":end:\n"
"#+vindex: modus-themes-region\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1196
msgid "Symbol: ~modus-themes-region~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1203
msgid "+ ~no-extend~ + ~bg-only~ + ~accented~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1207
msgid ""
"The default (a ~nil~ value or an empty list) is a prominent gray background "
"that overrides all foreground colors in the area it encompasses. Its reach "
"extends to the edge of the window."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1210
msgid ""
"The ~no-extend~ property limits the region to the end of the line, so that "
"it does not reach the edge of the window."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1213
msgid ""
"The ~bg-only~ property makes the region's background color more subtle to "
"allow the underlying text to retain its foreground colors."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1215
msgid "The ~accented~ property applies a more colorful background to the region."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1224
msgid ""
"#+begin_src emacs-lisp (no-extend) (bg-only accented) (accented bg-only "
"no-extend) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1232
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-region '(bg-only no-extend)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1240
#, no-wrap
msgid ""
"** Option for diff buffer looks\n"
":properties:\n"
":alt_title: Diffs\n"
":description: Choose among intense, desaturated, or text-only diffs\n"
":custom_id: h:ea7ac54f-5827-49bd-b09f-62424b3b6427\n"
":end:\n"
"#+vindex: modus-themes-diffs\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1242
msgid "Symbol: ~modus-themes-diffs~"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1250
#, markdown-text
msgid "~desaturated~"
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1250
#, markdown-text
msgid "~bg-only~"
msgstr ""
#. type: Bullet: '4. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1250
#, markdown-text
msgid "~deuteranopia~"
msgstr ""
#. type: Bullet: '5. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1250
#, markdown-text
msgid "~fg-only-deuteranopia~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1253
msgid ""
"The default (~nil~) uses fairly intense color combinations for diffs, by "
"applying prominently colored backgrounds, with appropriate foregrounds."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1256
msgid ""
"Option ~desaturated~ follows the same principles as with the default "
"(~nil~), though it tones down all relevant colors."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1261
msgid ""
"Option ~bg-only~ applies a background but does not override the text's "
"foreground. This makes it suitable for a non-nil value passed to "
"~diff-font-lock-syntax~ (note: Magit does not support syntax highlighting in "
"diffs---last checked on 2021-04-21)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1267
msgid ""
"Option ~deuteranopia~ is like the default (~nil~) in terms of using "
"prominently colored backgrounds, except that it also accounts for red-green "
"color defficiency by replacing all instances of green with colors on the "
"blue side of the spectrum. Other stylistic changes are made in the interest "
"of optimizing for such a use-case."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1278
msgid ""
"Option ~fg-only-deuteranopia~ removes all colored backgrounds, except from "
"word-wise or refined changes. Instead, it only uses color-coded foreground "
"values to differentiate between added, removed, and changed lines. If a "
"background is necessary to denote context, a subtle grayscale value is "
"applied. The color used for added lines is a variant of blue to account for "
"red-green color defficiency but also because green text alone is hard to "
"discern in the diff's context (hard for our accessibility purposes). The "
"~fg-only~ option that existed in older versions of the themes is now an "
"alias of ~fg-only-deuteranopia~, in the interest of backward compatibility."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1286
#, no-wrap
msgid ""
"** Option for org-mode block styles\n"
":properties:\n"
":alt_title: Org mode blocks\n"
":description: Choose among plain, gray, or tinted backgrounds\n"
":custom_id: h:b7e328c0-3034-4db7-9cdf-d5ba12081ca2\n"
":end:\n"
"#+vindex: modus-themes-org-blocks\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1288
msgid "Symbol: ~modus-themes-org-blocks~"
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1294
#, markdown-text
msgid "~gray-background~ (value ~grayscale~ exists for backward compatibility)"
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1294
#, markdown-text
msgid "~tinted-background~ (value ~rainbow~ exists for backward compatibility)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1297
msgid ""
"The default means that the block has no distinct background of its own and "
"uses the one that applies to the rest of the buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1303
msgid ""
"Option ~gray-background~ applies a subtle gray background to the block's "
"contents. It also affects the begin and end lines of the block: their "
"background extends to the edge of the window for Emacs version >= 27 where "
"the ~:extend~ keyword is recognized by ~set-face-attribute~ (this is "
"contingent on the variable ~org-fontify-whole-block-delimiter-line~)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1309
msgid ""
"Option ~tinted-background~ uses a slightly colored background for the "
"contents of the block. The exact color will depend on the programming "
"language and is controlled by the variable ~org-src-block-faces~ (refer to "
"the theme's source code for the current association list). For this to take "
"effect, Org must be restarted with {{{kbd(M-x org-mode-restart)}}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1313
msgid ""
"Code blocks use their major mode's colors only when the variable "
"~org-src-fontify-natively~ is non-nil. While quote/verse blocks require "
"setting ~org-fontify-quote-and-verse-blocks~ to a non-nil value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1315
msgid ""
"[[#h:f44cc6e3-b0f1-4a5e-8a90-9e48fa557b50][Update Org block delimiter "
"fontification]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1319
msgid ""
"Older versions of the themes provided options ~grayscale~ (or ~greyscale~) "
"and ~rainbow~. Those will continue to work as they are aliases for "
"~gray-background~ and ~tinted-background~, respectively."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1327
#, no-wrap
msgid ""
"** Option for Org agenda constructs\n"
":properties:\n"
":alt_title: Org agenda\n"
":description: Control each element in the presentation of the agenda\n"
":custom_id: h:68f481bc-5904-4725-a3e6-d7ecfa7c3dbc\n"
":end:\n"
"#+vindex: modus-themes-org-agenda\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1329
msgid "Symbol: ~modus-themes-org-agenda~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1333
msgid ""
"This is an alist that accepts a =(key . value)= combination. Some values "
"are specified as a list. Here is a sample, followed by a description of all "
"possible combinations:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1342
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-org-agenda\n"
" '((header-block . (variable-pitch scale-title))\n"
" (header-date . (grayscale workaholic bold-today))\n"
" (event . (accented scale-small))\n"
" (scheduled . uniform)\n"
" (habit . traffic-light)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1349
msgid ""
"A ~header-block~ key applies to elements that concern the headings which "
"demarcate blocks in the structure of the agenda. By default (a ~nil~ value) "
"those are rendered in a bold typographic weight, plus a height that is "
"slightly taller than the default font size. Acceptable values come in the "
"form of a list that can include either or both of those properties:"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1354
#, markdown-text
msgid "~variable-pitch~ to use a proportionately spaced typeface;"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1354
#, markdown-text
msgid ""
"~scale-title~ to increase the size to the number assigned to "
"~modus-themes-scale-title~ "
"([[#h:6868baa1-beba-45ed-baa5-5fd68322ccb3][Control the scale of headings]]) "
"or ~no-scale~ to make the font use the same height as the rest of the "
"buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1357
msgid ""
"In case both ~scale-title~ and ~no-scale~ are in the list, the latter takes "
"precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1359
msgid "Example usage:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1366
msgid ""
"#+begin_src emacs-lisp (header-block . nil) (header-block . (scale-title)) "
"(header-block . (no-scale)) (header-block . (variable-pitch scale-title)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1372
msgid ""
"A ~header-date~ key covers date headings. Dates use only a foreground color "
"by default (a ~nil~ value), with weekdays and weekends having a slight "
"difference in hueness. The current date has an added gray background. This "
"key accepts a list of values that can include any of the following "
"properties:"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid ""
"~grayscale~ to make weekdays use the main foreground color and weekends a "
"more subtle gray;"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid "~workaholic~ to make weekdays and weekends look the same in terms of color;"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid "~bold-today~ to apply a bold typographic weight to the current date;"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid "~bold-all~ to render all date headings in a bold weight."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid ""
"~scale-heading~ increases the height of the date headings to the value of "
"~modus-themes-scale-1~ (which is the first step in the scale for regular "
"headings)."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1385
#, markdown-text
msgid ""
"~underline-today~ applies an underline to the current date while removing "
"the background it has by default."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1387
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1413
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1431
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1468
msgid "For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1396
msgid ""
"#+begin_src emacs-lisp (header-date . nil) (header-date . (workaholic)) "
"(header-date . (grayscale bold-all)) (header-date . (grayscale workaholic)) "
"(header-date . (grayscale workaholic bold-today)) (header-date . (grayscale "
"workaholic bold-today scale-heading)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1403
msgid ""
"An ~event~ key covers events from the diary and other entries that derive "
"from a symbolic expression or sexp (e.g. phases of the moon, holidays). "
"This key accepts a list of values. By default (a nil value or an empty "
"list) those have a gray foreground, while sexp events are additionally "
"presented using slanted text (italics). The properties that can form a list "
"of possible values are:"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1411
#, markdown-text
msgid ""
"~scale-small~ reduces the height of the entries to the value of the user "
"option ~modus-themes-scale-small~ (0.9 the height of the main font size by "
"default)."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1411
#, markdown-text
msgid ""
"~accented~ applies an accent value to the event's foreground, replacing the "
"original gray."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1411
#, markdown-text
msgid ""
"~italic~ adds a slant to the font's forms (italic or oblique forms, "
"depending on the typeface)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1420
msgid ""
"#+begin_src emacs-lisp (event . nil) (event . (scale-small)) (event "
". (scale-small accented)) (event . (scale-small accented italic)) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1424
msgid ""
"A ~scheduled~ key applies to tasks with a scheduled date. By default (a "
"~nil~ value), those use varying shades of yellow to denote (i) a past or "
"current date and (ii) a future date. Valid values are symbols:"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1429
#, markdown-text
msgid "nil (default);"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1429
#, markdown-text
msgid "~uniform~ to make all scheduled dates the same color;"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1429
#, markdown-text
msgid ""
"~rainbow~ to use contrasting colors for past, present, future scheduled "
"dates."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1437
msgid ""
"#+begin_src emacs-lisp (scheduled . nil) (scheduled . uniform) (scheduled "
". rainbow) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1440
msgid ""
"A ~habit~ key applies to the ~org-habit~ graph. All possible value are "
"passed as a symbol. Those are:"
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1466
#, markdown-text
msgid ""
"The default (~nil~) is meant to conform with the original aesthetic of "
"~org-habit~. It employs all four color codes that correspond to the "
"org-habit states---clear, ready, alert, and overdue---while distinguishing "
"between their present and future variants. This results in a total of eight "
"colors in use: red, yellow, green, blue, in tinted and shaded versions. "
"They cover the full set of information provided by the ~org-habit~ "
"consistency graph."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1466
#, markdown-text
msgid ""
"~simplified~ is like the default except that it removes the dichotomy "
"between current and future variants by applying uniform color-coded values. "
"It applies a total of four colors: red, yellow, green, blue. They produce a "
"simplified consistency graph that is more legible (or less busy) than the "
"default. The intent is to shift focus towards the distinction between the "
"four states of a habit task, rather than each state's present/future "
"outlook."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1466
#, markdown-text
msgid ""
"~traffic-light~ further reduces the available colors to red, yellow, and "
"green. As in ~simplified~, present and future variants appear uniformly, "
"but differently from it, the ~clear~ state is rendered in a green hue, "
"instead of the original blue. This is meant to capture the use-case where a "
"habit task being too early is less important than it being too late. The "
"difference between ready and clear states is attenuated by painting both of "
"them using shades of green. This option thus highlights the alert and "
"overdue states."
msgstr ""
#. type: Bullet: '- '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1466
#, markdown-text
msgid ""
"~traffic-light-deuteranopia~ is like the ~traffic-light~ except its three "
"colors are red, yellow, and blue to be suitable for users with red-green "
"color deficiency (deuteranopia)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1474
msgid ""
"#+begin_src emacs-lisp (habit . nil) (habit . simplified) (habit "
". traffic-light) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1476
msgid "Putting it all together, the alist can look like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1483
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"'((header-block . (scale-title variable-pitch))\n"
" (header-date . (grayscale workaholic bold-today))\n"
" (event . (accented scale-small))\n"
" (scheduled . uniform)\n"
" (habit . traffic-light))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1492
#, no-wrap
msgid ""
";; Or else:\n"
"(setq modus-themes-org-agenda\n"
" '((header-block . (scale-title variable-pitch))\n"
" (header-date . (grayscale workaholic bold-today))\n"
" (event . (accented scale-small))\n"
" (scheduled . uniform)\n"
" (habit . traffic-light)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1500
#, no-wrap
msgid ""
"** Option for the headings' overall style\n"
":properties:\n"
":alt_title: Heading styles\n"
":description: Choose among several styles, also per heading level\n"
":custom_id: h:271eff19-97aa-4090-9415-a6463c2f9ae1\n"
":end:\n"
"#+vindex: modus-themes-headings\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1502
msgid "Symbol: ~modus-themes-headings~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1508
msgid ""
"This is an alist that accepts a =(key . list-of-values)= combination. The "
"key is either a number, representing the heading's level or ~t~, which "
"pertains to the fallback style. The list of values covers symbols that "
"refer to properties, as described below. Here is a sample, followed by a "
"presentation of all available properties:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1515
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-headings\n"
" '((1 . (background overline))\n"
" (2 . (overline rainbow))\n"
" (t . (monochrome))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1517
msgid "Properties:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1523
msgid "+ ~rainbow~ + ~overline~ + ~background~ + ~no-bold~ + ~monochrome~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1526
msgid ""
"By default (a ~nil~ value for this variable), all headings have a bold "
"typographic weight and use a desaturated text color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1528
msgid "A ~rainbow~ property makes the text color more saturated."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1530
msgid "An ~overline~ property draws a line above the area of the heading."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1533
msgid ""
"A ~background~ property adds a subtle tinted color to the background of the "
"heading."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1535
msgid "A ~no-bold~ property removes the bold weight from the heading's text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1540
msgid ""
"A ~monochrome~ property makes all headings the same base color, which is "
"that of the default for the active theme (black/white). When ~background~ "
"is also set, ~monochrome~ changes its color to gray. If both ~monochrome~ "
"and ~rainbow~ are set, the former takes precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1549
msgid ""
"#+begin_src emacs-lisp (no-bold) (rainbow background) (overline monochrome "
"no-bold) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1560
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-headings\n"
" '((1 . (background overline rainbow))\n"
" (2 . (background overline))\n"
" (t . (overline no-bold))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1564
msgid ""
"When defining the styles per heading level, it is possible to pass a non-nil "
"value (~t~) instead of a list of properties. This will retain the original "
"aesthetic for that level. For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1570
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-headings\n"
" '((1 . t) ; keep the default style\n"
" (2 . (background overline))\n"
" (t . (rainbow)))) ; style for all other headings\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1576
#, no-wrap
msgid ""
"(setq modus-themes-headings\n"
" '((1 . (background overline))\n"
" (2 . (rainbow no-bold))\n"
" (t . t))) ; default style for all other levels\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1581
msgid ""
"For Org users, the extent of the heading depends on the variable "
"~org-fontify-whole-heading-line~. This affects the ~overline~ and "
"~background~ properties. Depending on the version of Org, there may be "
"others, such as ~org-fontify-done-headline~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1583
msgid "[[#h:075eb022-37a6-41a4-a040-cc189f6bfa1f][Option for scaled headings]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1585
msgid ""
"[[#h:97caca76-fa13-456c-aef1-a2aa165ea274][Option for variable-pitch font in "
"headings]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1593
#, no-wrap
msgid ""
"** Option for scaled headings\n"
":properties:\n"
":alt_title: Scaled headings\n"
":description: Toggle scaling of headings\n"
":custom_id: h:075eb022-37a6-41a4-a040-cc189f6bfa1f\n"
":end:\n"
"#+vindex: modus-themes-scale-headings\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1595
msgid "Symbol: ~modus-themes-scale-headings~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1602
msgid "The default is to use the same size for headings and paragraph text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1605
msgid ""
"With a non-nil value (~t~) make headings larger in height relative to the "
"main text. This is noticeable in modes like Org, Markdown, and Info."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1612
#, no-wrap
msgid ""
"*** Control the scale of headings\n"
":properties:\n"
":alt_title: Scaled heading sizes\n"
":description: Specify rate of increase for scaled headings\n"
":custom_id: h:6868baa1-beba-45ed-baa5-5fd68322ccb3\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1615
msgid ""
"In addition to the toggle for enabling scaled headings, users can also "
"specify a number of their own."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1620
#, markdown-text
msgid ""
"If it is a floating point, say, =1.5=, it is interpreted as a multiple of "
"the base font size. This is the recommended method, because it will always "
"adapt to changes in the base font size, such as while using the "
"~text-scale-adjust~ command."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1629
#, markdown-text
msgid ""
"If it is an integer, it is read as an absolute font height that is 1/10 of "
"the typographic point size. Thus a value of =18pt= must be expressed as "
"=180=. Setting an absolute value is discouraged, as it will break the "
"layout in cases where the base font size must change, such as with the "
"~text-scale-adjust~ command ([[#h:defcf4fc-8fa8-4c29-b12e-7119582cc929][Font "
"configurations]]). While we discourage using absolute values, we still "
"provide for this option for users who do not need to perform text-scaling "
"operations or who are content with whatever discrepancies in height."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1634
msgid ""
"Below are the variables in their default values, using the floating point "
"paradigm. The numbers are very conservative, but one is free to change them "
"to their liking, such as =1.2=, =1.4=, =1.6=, =1.8=, =2.0=---or use a "
"resource for finding a consistent scale:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1643
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-scale-1 1.05\n"
" modus-themes-scale-2 1.1\n"
" modus-themes-scale-3 1.15\n"
" modus-themes-scale-4 1.2\n"
" modus-themes-scale-title 1.3\n"
" modus-themes-scale-small 0.9)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1650
msgid ""
"As for the application of that scale, the variables that range from "
"~modus-themes-scale-1~ up to ~modus-themes-scale-4~ apply to regular "
"headings within the context of the given major mode. The former is the "
"smallest, while the latter is the largest. \"Regular headings\" are those "
"that have a standard syntax for their scale, such as Org mode's eight levels "
"of asterisks or Markdown's six columns."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1659
msgid ""
"Whereas ~modus-themes-scale-title~ is applied to special headings that do "
"not conform with the aforementioned syntax, yet which are expected to be "
"larger than the largest value on that implied scale or at least have some "
"unique purpose in the buffer. Put concretely, Org's =#+title= meta datum is "
"not part of the eight levels of headings in an Org file, yet is supposed to "
"signify the primary header. Similarly, the Org Agenda's structure headings "
"are not part of a recognisable scale and so they also get "
"~modus-themes-scale-title~ "
"([[#h:68f481bc-5904-4725-a3e6-d7ecfa7c3dbc][Option for Org agenda "
"constructs]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1664
msgid ""
"Similarly ~modus-themes-scale-small~ is not applied to regular headings, but "
"reserved for special contexts where the user is presented with an option to "
"use a smaller font height than the base size. It is only implemented for "
"the Org agenda."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1670
msgid ""
"Users who wish to maintain scaled headings for the normal syntax while "
"preventing special headings from standing out, can assign a value of =1.0= "
"to ~modus-themes-scale-title~ to make it the same as body text (or whatever "
"value would render it indistinguishable from the desired point of "
"reference)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1675
msgid ""
"Note that in earlier versions of Org, scaling would only increase the size "
"of the heading, but not of keywords that were added to it, like \"TODO\". "
"The issue has been fixed upstream: "
"<https://protesilaos.com/codelog/2020-09-24-org-headings-adapt/>."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1683
#, no-wrap
msgid ""
"** Option for variable-pitch font in UI elements\n"
":properties:\n"
":alt_title: UI typeface\n"
":description: Toggle the use of variable-pitch across the User Interface\n"
":custom_id: h:16cf666c-5e65-424c-a855-7ea8a4a1fcac\n"
":end:\n"
"#+vindex: modus-themes-variable-pitch-ui\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1685
msgid "Symbol: ~modus-themes-variable-pitch-ui~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1694
msgid ""
"This option concerns User Interface elements that are under the direct "
"control of Emacs. In particular: the mode line, header line, tab bar, and "
"tab line."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1697
msgid ""
"The default is to use the same font as the rest of Emacs, which usually is a "
"monospaced family."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1700
msgid ""
"With a non-nil value (~t~) apply a proportionately spaced typeface. This is "
"done by assigning the ~variable-pitch~ face to the relevant items."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1710
#, no-wrap
msgid ""
"** Option for variable-pitch font in headings\n"
":properties:\n"
":alt_title: Headings' typeface\n"
":description: Toggle the use of variable-pitch in headings\n"
":custom_id: h:97caca76-fa13-456c-aef1-a2aa165ea274\n"
":end:\n"
"#+vindex: modus-themes-variable-pitch-headings\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1712
msgid "Symbol: ~modus-themes-variable-pitch-headings~"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1720
msgid "The default is to use the main font family, which typically is monospaced."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1723
msgid ""
"With a non-nil value (~t~) apply a proportionately spaced typeface, else "
"\"variable-pitch\", to headings (such as in Org mode)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1730
#, no-wrap
msgid ""
"* Advanced customization (do-it-yourself)\n"
":properties:\n"
":custom_id: h:f4651d55-8c07-46aa-b52b-bed1e53463bb\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1735
msgid ""
"Unlike the predefined customization options which follow a clear pattern of "
"allowing the user to quickly specify their preference, the themes also "
"provide a more flexible, albeit difficult, mechanism to control things with "
"precision ([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization "
"Options]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1740
msgid ""
"This section is of interest only to users who are prepared to maintain their "
"own local tweaks and who are willing to deal with any possible "
"incompatibilities between versioned releases of the themes. As such, they "
"are labelled as \"do-it-yourself\" or \"DIY\"."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1745
#, no-wrap
msgid ""
"** Per-theme customization settings (DIY)\n"
":properties:\n"
":custom_id: h:a897b302-8e10-4a26-beab-3caaee1e1193\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1752
msgid ""
"If you prefer to maintain different customization options between the two "
"themes, it is best you write your own functions that first set those options "
"and then load the relevant theme. The following code does exactly that by "
"simply differentiating the two themes on the choice of bold constructs in "
"code syntax (enabled for one, disabled for the other)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1758
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-demo-modus-operandi ()\n"
" (interactive)\n"
" (setq modus-themes-bold-constructs t) ; ENABLE bold\n"
" (modus-themes-load-operandi))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1763
#, no-wrap
msgid ""
"(defun my-demo-modus-vivendi ()\n"
" (interactive)\n"
" (setq modus-themes-bold-constructs nil) ; DISABLE bold\n"
" (modus-themes-load-vivendi))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1769
#, no-wrap
msgid ""
"(defun my-demo-modus-themes-toggle ()\n"
" (if (eq (car custom-enabled-themes) 'modus-operandi)\n"
" (my-demo-modus-vivendi)\n"
" (my-demo-modus-operandi)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1772
msgid ""
"Then assign ~my-demo-modus-themes-toggle~ to a key instead of the equivalent "
"the themes provide."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1775
msgid ""
"For a more elaborate design, it is better to inspect the source code of "
"~modus-themes-toggle~ and relevant functions."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1783
#, no-wrap
msgid ""
"** Case-by-case face specs using the themes' palette (DIY)\n"
":properties:\n"
":custom_id: h:1487c631-f4fe-490d-8d58-d72ffa3bd474\n"
":end:\n"
"#+findex: modus-themes-color\n"
"#+findex: modus-themes-color-alts\n"
"#+cindex: Extracting individual colors\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1786
msgid ""
"This section is about tweaking individual faces. If you plan to do things "
"at scale, consult the next section: "
"[[#h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae][Set multiple faces]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1791
msgid ""
"We already covered in previous sections how to toggle between the themes and "
"how to configure options prior to loading. We also explained that some of "
"the functions made available to users will fire up a hook that can be used "
"to pass tweaks in the post-theme-load phase."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1798
msgid ""
"Now assume you wish to change a single face, say, the ~cursor~. And you "
"would like to get the standard \"blue\" color value of the active Modus "
"theme, whether it is Modus Operandi or Modus Vivendi. To do that, you can "
"use the ~modus-themes-color~ function. It accepts a symbol that is "
"associated with a color in ~modus-themes-operandi-colors~ and "
"~modus-themes-vivendi-colors~. Like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1802
msgid "#+begin_src emacs-lisp (modus-themes-color 'blue) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1804
msgid "The function always extracts the color value of the active Modus theme."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1809
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(progn\n"
" (load-theme 'modus-operandi t)\n"
" (modus-themes-color 'blue)) ; \"#0031a9\" for `modus-operandi'\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1814
#, no-wrap
msgid ""
"(progn\n"
" (load-theme 'modus-vivendi t)\n"
" (modus-themes-color 'blue)) ; \"#2fafff\" for `modus-vivendi'\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1817
msgid ""
"Do {{{kbd(C-h v)}}} on the aforementioned variables to check all the "
"available symbols that can be passed to this function."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1821
msgid ""
"With that granted, let us expand the example to actually change the ~cursor~ "
"face's background property. We employ the built-in function of "
"~set-face-attribute~:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1825
msgid ""
"#+begin_src emacs-lisp (set-face-attribute 'cursor nil :background "
"(modus-themes-color 'blue)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1830
msgid ""
"If you evaluate this form, your cursor will become blue. But if you change "
"themes, such as with ~modus-themes-toggle~, your edits will be lost, because "
"the newly loaded theme will override the ~:background~ attribute you had "
"assigned to that face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1836
msgid ""
"For such changes to persist, we need to make them after loading the theme. "
"So we rely on ~modus-themes-after-load-theme-hook~, which gets called from "
"~modus-themes-load-operandi~, ~modus-themes-load-vivendi~, as well as the "
"command ~modus-themes-toggle~. Here is a sample function that tweaks two "
"faces and then gets added to the hook:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1841
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-custom-faces ()\n"
" (set-face-attribute 'cursor nil :background (modus-themes-color 'blue))\n"
" (set-face-attribute 'font-lock-type-face nil :foreground "
"(modus-themes-color 'magenta-alt)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1844
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1969
msgid ""
"(add-hook 'modus-themes-after-load-theme-hook "
"#'my-modus-themes-custom-faces) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1846
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1971
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2582
msgid ""
"[[#h:86f6906b-f090-46cc-9816-1fe8aeb38776][A theme-agnostic hook for theme "
"loading]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1849
msgid ""
"Using this principle, it is possible to override the styles of faces without "
"having to find color values for each case."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1854
msgid ""
"Another application is to control the precise weight for bold constructs. "
"This is particularly useful if your typeface has several variants such as "
"\"heavy\", \"extrabold\", \"semibold\". All you have to do is edit the "
"~bold~ face. For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1858
msgid ""
"#+begin_src emacs-lisp (set-face-attribute 'bold nil :weight 'semibold) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1863
msgid ""
"Remember to use the custom function and hook combo we demonstrated above. "
"Because the themes do not hard-wire a specific weight, this simple form is "
"enough to change the weight of all bold constructs throughout the interface."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1872
msgid ""
"Finally, there are cases where you want to tweak colors though wish to apply "
"different ones to each theme, say, a blue hue for Modus Operandi and a shade "
"of red for Modus Vivendi. To this end, we provide ~modus-themes-color-alts~ "
"as a convenience function to save you from the trouble of writing separate "
"wrappers for each theme. It still returns a single value by querying either "
"of ~modus-themes-operandi-colors~ and ~modus-themes-vivendi-colors~, only "
"here you pass the two keys you want, first for ~modus-operandi~ then "
"~modus-vivendi~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1874
msgid "Take the previous example with the ~cursor~ face:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1879
msgid ""
"#+begin_src emacs-lisp ;; Blue for `modus-operandi' and red for "
"`modus-vivendi' (set-face-attribute 'cursor nil :background "
"(modus-themes-color-alts 'blue 'red)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1886
#, no-wrap
msgid ""
"** Face specs at scale using the themes' palette (DIY)\n"
":properties:\n"
":custom_id: h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae\n"
":end:\n"
"#+findex: modus-themes-with-colors\n"
"#+cindex: Extracting colors en masse\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1890
msgid ""
"The examples here are for large scale operations. For simple, one-off "
"tweaks, you may prefer the approach documented in the previous section "
"([[#h:1487c631-f4fe-490d-8d58-d72ffa3bd474][Case-by-case face specs using "
"the themes' palette]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1896
msgid ""
"The ~modus-themes-with-colors~ macro lets you retrieve multiple color values "
"by employing the backquote/backtick and comma notation. The values are "
"stored in the alists ~modus-themes-operandi-colors~ and "
"~modus-themes-vivendi-colors~, while the macro always queries that of the "
"active Modus theme."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1899
msgid ""
"Here is an abstract example that just returns a list of color values while "
"~modus-operandi~ is enabled:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1924
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-with-colors\n"
" (list fg-main\n"
" blue-faint\n"
" magenta\n"
" magenta-alt-other\n"
" cyan-alt-other\n"
" fg-special-cold\n"
" blue-alt\n"
" magenta-faint\n"
" cyan\n"
" fg-main\n"
" green-faint\n"
" red-alt-faint\n"
" blue-alt-faint\n"
" fg-special-warm\n"
" cyan-alt\n"
" blue))\n"
";; =>\n"
";; (\"#000000\" \"#002f88\" \"#721045\" \"#5317ac\"\n"
";; \"#005a5f\" \"#093060\" \"#2544bb\" \"#752f50\"\n"
";; \"#00538b\" \"#000000\" \"#104410\" \"#702f00\"\n"
";; \"#003f78\" \"#5d3026\" \"#30517f\" \"#0031a9\")\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1931
msgid ""
"Getting a list of colors may have its applications, though what you are most "
"likely interested in is how to use those variables to configure several "
"faces at once. To do so we can rely on the built-in ~custom-set-faces~ "
"function, which sets face specifications for the special ~user~ theme. That "
"\"theme\" gets applied on top of regular themes like ~modus-operandi~ and "
"~modus-vivendi~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1933
msgid "This is how it works:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1943
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-with-colors\n"
" (custom-set-faces\n"
" `(cursor ((,class :background ,blue)))\n"
" `(mode-line ((,class :background ,yellow-nuanced-bg\n"
" :foreground ,yellow-nuanced-fg)))\n"
" `(mode-line-inactive ((,class :background ,blue-nuanced-bg\n"
" :foreground ,blue-nuanced-fg)))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1950
msgid ""
"The above snippet will immediately refashion the faces it names once it is "
"evaluated. However, if you switch between the Modus themes, say, from "
"~modus-operandi~ to ~modus-vivendi~, the colors will not get updated to "
"match those of the new theme. To make things work across the themes, we "
"need to employ the same technique we discussed in the previous section, "
"namely, to pass our changes at the post-theme-load phase via a hook."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1956
msgid ""
"The themes provide the ~modus-themes-after-load-theme-hook~, which gets "
"called from ~modus-themes-load-operandi~, ~modus-themes-load-vivendi~, as "
"well as the command ~modus-themes-toggle~. With this knowledge, you can "
"wrap the macro in a function and then assign that function to the hook. "
"Thus:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1966
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-custom-faces ()\n"
" (modus-themes-with-colors\n"
" (custom-set-faces\n"
" `(cursor ((,class :background ,blue)))\n"
" `(mode-line ((,class :background ,yellow-nuanced-bg\n"
" :foreground ,yellow-nuanced-fg)))\n"
" `(mode-line-inactive ((,class :background ,blue-nuanced-bg\n"
" :foreground ,blue-nuanced-fg))))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1977
msgid ""
"To discover the faces defined by all loaded libraries, you may do {{{kbd(M-x "
"list-faces-display)}}}. Be warned that when you ~:inherit~ a face you are "
"introducing an implicit dependency, so try to avoid doing so for libraries "
"other than the built-in {{{file(faces.el)}}} (or at least understand that "
"things may break if you inherit from a yet-to-be-loaded face)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1982
msgid ""
"Also bear in mind that these examples are meant to work with the Modus "
"themes. If you are cycling between multiple themes you may encounter "
"unforeseen issues, such as the colors of the Modus themes being applied to a "
"non-Modus item."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1986
msgid ""
"Finally, note that you can still use other functions where those make "
"sense. For example, the ~modus-themes-color-alts~ that was discussed in the "
"previous section. Adapt the above example like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:1994
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"...\n"
"(modus-themes-with-colors\n"
" (custom-set-faces\n"
" `(cursor ((,class :background ,(modus-themes-color-alts 'blue "
"'green))))\n"
" ...))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2000
#, no-wrap
msgid ""
"** Remap face with local value (DIY)\n"
":properties:\n"
":custom_id: h:7a93cb6f-4eca-4d56-a85c-9dcd813d6b0f\n"
":end:\n"
"#+cindex: Remapping faces\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2007
msgid ""
"There are cases where we need to change the buffer-local attributes of a "
"face. This might be because we have our own minor mode that re-uses a face "
"for a particular purpose, such as a line selection tool that activates "
"~hl-line-mode~, but we wish to keep it distinct from other buffers. This is "
"where ~face-remap-add-relative~ can be applied and may be combined with "
"~modus-themes-with-colors~ to deliver consistent results."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2012
msgid ""
"In this example we will write a simple interactive function that adjusts the "
"background color of the ~region~ face. This is the sample code:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2023
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar my-rainbow-region-colors\n"
" (modus-themes-with-colors\n"
" `((red . ,red-subtle-bg)\n"
" (green . ,green-subtle-bg)\n"
" (yellow . ,yellow-subtle-bg)\n"
" (blue . ,blue-subtle-bg)\n"
" (magenta . ,magenta-subtle-bg)\n"
" (cyan . ,cyan-subtle-bg)))\n"
" \"Sample list of color values for `my-rainbow-region'.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2034
#, no-wrap
msgid ""
"(defun my-rainbow-region (color)\n"
" \"Remap buffer-local attribute of `region' using COLOR.\"\n"
" (interactive\n"
" (list\n"
" (completing-read \"Pick a color: \" my-rainbow-region-colors)))\n"
" (face-remap-add-relative\n"
" 'region\n"
" `( :background ,(alist-get (intern color) my-rainbow-region-colors)\n"
" :foreground ,(face-attribute 'default :foreground))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2038
msgid ""
"When ~my-rainbow-region~ is called interactively, it prompts for a color to "
"use. The list of candidates is drawn from the car of each association in "
"~my-rainbow-region-colors~ (so \"red\", \"green\", etc.)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2042
msgid ""
"To extend this principle, we may write wrapper functions that pass a color "
"directly. Those can be useful in tandem with hooks. Consider this example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2046
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-rainbow-region-magenta ()\n"
" (my-rainbow-region 'magenta))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2049
msgid "(add-hook 'diff-mode-hook #'my-rainbow-region-magenta) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2052
msgid "Whenever we enter a ~diff-mode~ buffer, we now get a magenta-colored region."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2056
msgid ""
"Perhaps you may wish to generalise those findings in to a set of functions "
"that also accept an arbitrary face. We shall leave the experimentation up "
"to you."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2062
#, no-wrap
msgid ""
"** Cycle through arbitrary colors (DIY)\n"
":properties:\n"
":custom_id: h:77dc4a30-b96a-4849-85a8-fee3c2995305\n"
":end:\n"
"#+cindex: Cycle colors\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2069
msgid ""
"Users may opt to customize individual faces of the themes to accommodate "
"their particular needs. One such case is with the color intensity of "
"comments, specifically the foreground of ~font-lock-comment-face~. The "
"Modus themes set that to a readable value, in accordance with their "
"accessibility objective, though users may prefer to lower the overall "
"contrast on an on-demand basis."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2074
msgid ""
"One way to achieve this is to design a command that cycles through three "
"distinct levels of intensity, though the following can be adapted to any "
"kind of cyclic behaviour, such as to switch between red, green, and blue."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2079
msgid ""
"In the following example, we employ the ~modus-themes-color~ function which "
"reads a symbol that represents an entry in the active theme's color palette "
"([[#h:1487c631-f4fe-490d-8d58-d72ffa3bd474][Case-by-case face specs using "
"the themes' palette]]). Those are stored in "
"~my-modus-themes-comment-colors~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2091
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar my-modus-themes-comment-colors\n"
" ;; We are abusing the palette here, as those colors have their own\n"
" ;; purpose in the palette, so please ignore the semantics of their\n"
" ;; names.\n"
" '((low . bg-region)\n"
" (medium . bg-tab-inactive-alt)\n"
" (high . fg-alt))\n"
" \"Alist of levels of intensity mapped to color palette entries.\n"
"The entries are found in `modus-themes-operandi-colors' or\n"
"`modus-themes-vivendi-colors'.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2095
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2151
#, no-wrap
msgid ""
"(defvar my-modus-themes--adjust-comment-color-state nil\n"
" \"The cyclic state of `my-modus-themes-adjust-comment-color'.\n"
"For internal use.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2100
#, no-wrap
msgid ""
"(defun my-modus-themes--comment-foreground (degree state)\n"
" \"Set `font-lock-comment-face' foreground.\n"
"Use `my-modus-themes-comment-colors' to extract the color value\n"
"for each level of intensity.\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2108
#, no-wrap
msgid ""
"This is complementary to `my-modus-themes-adjust-comment-color'.\"\n"
" (let ((palette-colors my-modus-themes-comment-colors))\n"
" (set-face-foreground\n"
" 'font-lock-comment-face\n"
" (modus-themes-color (alist-get degree palette-colors)))\n"
" (setq my-modus-themes--adjust-comment-color-state state)\n"
" (message \"Comments are set to %s contrast\" degree)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2121
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2180
#, no-wrap
msgid ""
"(defun my-modus-themes-adjust-comment-color ()\n"
" \"Cycle through levels of intensity for comments.\n"
"The levels are determined by `my-modus-themes-comment-colors'.\"\n"
" (interactive)\n"
" (pcase my-modus-themes--adjust-comment-color-state\n"
" ('nil\n"
" (my-modus-themes--comment-foreground 'low 1))\n"
" (1\n"
" (my-modus-themes--comment-foreground 'medium 2))\n"
" (_\n"
" (my-modus-themes--comment-foreground 'high nil))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2124
msgid ""
"With the above, {{{kbd(M-x my-modus-themes-adjust-comment-color)}}} will "
"cycle through the three levels of intensity that have been specified."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2134
msgid ""
"Another approach is to not read from the active theme's color palette and "
"instead provide explicit color values, either in hexadecimal RGB notation "
"(like =#123456=) or as the names that are displayed in the output of "
"{{{kbd(M-x list-colors-display)}}}. In this case, the alist with the colors "
"will have to account for the active theme, so as to set the appropriate "
"colors. While this introduces a bit more complexity, it ultimately offers "
"greater flexibility on the choice of colors for such a niche functionality "
"(so there is no need to abuse the palette of the active Modus theme):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2140
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar my-modus-themes-comment-colors\n"
" '((light . ((low . \"gray75\")\n"
" (medium . \"gray50\")\n"
" (high . \"#505050\"))) ; the default for "
"`modus-operandi'\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2147
#, no-wrap
msgid ""
" (dark . ((low . \"gray25\")\n"
" (medium . \"gray50\")\n"
" (high . \"#a8a8a8\")))) ; the default for "
"`modus-vivendi'\n"
" \"Alist of levels of intensity mapped to color values.\n"
"For such colors, consult the command `list-colors-display'. Pass\n"
"the name of a color or its hex value.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2156
#, no-wrap
msgid ""
"(defun my-modus-themes--comment-foreground (degree state)\n"
" \"Set `font-lock-comment-face' foreground.\n"
"Use `my-modus-themes-comment-colors' to extract the color value\n"
"for each level of intensity.\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2167
#, no-wrap
msgid ""
"This is complementary to `my-modus-themes-adjust-comment-color'.\"\n"
" (let* ((colors my-modus-themes-comment-colors)\n"
" (levels (pcase (car custom-enabled-themes)\n"
" ('modus-operandi (alist-get 'light colors))\n"
" ('modus-vivendi (alist-get 'dark colors)))))\n"
" (set-face-foreground\n"
" 'font-lock-comment-face\n"
" (alist-get degree levels))\n"
" (setq my-modus-themes--adjust-comment-color-state state)\n"
" (message \"Comments are set to %s contrast\" degree)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2184
msgid ""
"The effect of the above configurations on ~font-lock-comment-face~ is "
"global. To make it buffer-local, one must tweak the code to employ the "
"function ~face-remap-add-relative~ "
"([[#h:7a93cb6f-4eca-4d56-a85c-9dcd813d6b0f][Remap face with local value]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2186
msgid "So this form in ~my-modus-themes--comment-foreground~:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2194
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
";; example 1\n"
"(...\n"
" (set-face-foreground\n"
" 'font-lock-comment-face\n"
" (modus-themes-color (alist-get degree palette-colors)))\n"
" ...)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2202
#, no-wrap
msgid ""
";; example 2\n"
"(...\n"
" (set-face-foreground\n"
" 'font-lock-comment-face\n"
" (alist-get degree levels))\n"
" ...)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2204
msgid "Must become this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2212
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
";; example 1\n"
"(...\n"
" (face-remap-add-relative\n"
" 'font-lock-comment-face\n"
" `(:foreground ,(modus-themes-color (alist-get degree palette-colors))))\n"
" ...)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2220
#, no-wrap
msgid ""
";; example 2\n"
"(...\n"
" (face-remap-add-relative\n"
" 'font-lock-comment-face\n"
" `(:foreground ,(alist-get degree levels)))\n"
" ...)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2228
#, no-wrap
msgid ""
"** Override colors (DIY)\n"
":properties:\n"
":custom_id: h:307d95dd-8dbd-4ece-a543-10ae86f155a6\n"
":end:\n"
"#+vindex: modus-themes-operandi-color-overrides\n"
"#+vindex: modus-themes-vivendi-color-overrides\n"
"#+cindex: Change a theme's colors\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2235
msgid ""
"The themes provide a mechanism for overriding their color values. This is "
"controlled by the variables ~modus-themes-operandi-color-overrides~ and "
"~modus-themes-vivendi-color-overrides~, which are alists that should mirror "
"a subset of the associations in ~modus-themes-operandi-colors~ and "
"~modus-themes-vivendi-colors~ respectively. As with all customisations, "
"overriding must be done before loading the affected theme."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2241
msgid ""
"Let us approach the present topic one step at a time. Here is a simplified "
"excerpt of the default palette for Modus Operandi with some basic background "
"values that apply to buffers and the mode line (remember to inspect the "
"actual value to find out all the associations that can be overridden):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2250
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defconst modus-themes-operandi-colors\n"
" '((bg-main . \"#ffffff\")\n"
" (bg-dim . \"#f8f8f8\")\n"
" (bg-alt . \"#f0f0f0\")\n"
" (bg-active . \"#d7d7d7\")\n"
" (bg-inactive . \"#efefef\")))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2255
msgid ""
"As one can tell, we bind a key to a hexadecimal RGB color value. Now say we "
"wish to override those specific values and have our changes propagate to all "
"faces that use those keys. We could write something like this, which adds a "
"subtle ochre tint:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2264
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq modus-themes-operandi-color-overrides\n"
" '((bg-main . \"#fefcf4\")\n"
" (bg-dim . \"#faf6ef\")\n"
" (bg-alt . \"#f7efe5\")\n"
" (bg-active . \"#e8dfd1\")\n"
" (bg-inactive . \"#f6ece5\")))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2268
msgid ""
"Once this is evaluated, any subsequent loading of ~modus-operandi~ will use "
"those values instead of the defaults. No further intervention is required."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2270
msgid "To reset the changes, we apply this and reload the theme:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2274
msgid ""
"#+begin_src emacs-lisp (setq modus-themes-operandi-color-overrides nil) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2278
msgid ""
"Users who wish to leverage such a mechanism can opt to implement it "
"on-demand by means of a global minor mode. The following snippet covers "
"both themes and expands to some more assosiations in the palette:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2314
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(define-minor-mode my-modus-themes-tinted\n"
" \"Tweak some Modus themes colors.\"\n"
" :init-value nil\n"
" :global t\n"
" (if my-modus-themes-tinted\n"
" (setq modus-themes-operandi-color-overrides\n"
" '((bg-main . \"#fefcf4\")\n"
" (bg-dim . \"#faf6ef\")\n"
" (bg-alt . \"#f7efe5\")\n"
" (bg-hl-line . \"#f4f0e3\")\n"
" (bg-active . \"#e8dfd1\")\n"
" (bg-inactive . \"#f6ece5\")\n"
" (bg-region . \"#c6bab1\")\n"
" (bg-header . \"#ede3e0\")\n"
" (bg-tab-bar . \"#dcd3d3\")\n"
" (bg-tab-active . \"#fdf6eb\")\n"
" (bg-tab-inactive . \"#c8bab8\")\n"
" (fg-unfocused . \"#55556f\"))\n"
" modus-themes-vivendi-color-overrides\n"
" '((bg-main . \"#100b17\")\n"
" (bg-dim . \"#161129\")\n"
" (bg-alt . \"#181732\")\n"
" (bg-hl-line . \"#191628\")\n"
" (bg-active . \"#282e46\")\n"
" (bg-inactive . \"#1a1e39\")\n"
" (bg-region . \"#393a53\")\n"
" (bg-header . \"#202037\")\n"
" (bg-tab-bar . \"#262b41\")\n"
" (bg-tab-active . \"#120f18\")\n"
" (bg-tab-inactive . \"#3a3a5a\")\n"
" (fg-unfocused . \"#9a9aab\")))\n"
" (setq modus-themes-operandi-color-overrides nil\n"
" modus-themes-vivendi-color-overrides nil)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2320
msgid ""
"With this in place, one can invoke {{{kbd(M-x my-modus-themes-tinted)}}} and "
"then load the Modus theme of their choice. The new palette subset will come "
"into effect: subtle ochre tints for Modus Operandi and night sky shades for "
"Modus Vivendi. Switching between the two themes, such as with {{{kbd(M-x "
"modus-themes-toggle)}}} will also use the overrides."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2326
msgid ""
"Given that this is a user-level customisation, one is free to implement "
"whatever color values they desire, even if the possible combinations fall "
"below the minimum 7:1 contrast ratio that governs the design of the themes "
"(the WCAG AAA legibility standard). Alternatively, this can also be done "
"programmatically ([[#h:4589acdc-2505-41fc-9f5e-699cfc45ab00][Override color "
"saturation]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2331
msgid ""
"For manual interventions it is advised to inspect the source code of "
"~modus-themes-operandi-colors~ and ~modus-themes-vivendi-colors~ for the "
"inline commentary: it explains what the intended use of each palette subset "
"is."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2336
msgid ""
"Furthermore, users may benefit from the ~modus-themes-contrast~ function "
"that we provide: [[#h:02e25930-e71a-493d-828a-8907fc80f874][test color "
"combinations]]. It measures the contrast ratio between two color values, so "
"it can help in overriding the palette (or a subset thereof) without making "
"the end result inaccessible."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2342
#, no-wrap
msgid ""
"** Override color saturation (DIY)\n"
":properties:\n"
":custom_id: h:4589acdc-2505-41fc-9f5e-699cfc45ab00\n"
":end:\n"
"#+cindex: Change a theme's color saturation\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2351
msgid ""
"In the previous section we documented how one can override color values "
"manually ([[#h:307d95dd-8dbd-4ece-a543-10ae86f155a6][Override colors]]). "
"Here we use a programmatic approach which leverages the built-in "
"~color-saturate-name~ function to adjust the saturation of all color values "
"used by the active Modus theme. Our goal is to prepare a counterpart of the "
"active theme's palette that holds modified color values, adjusted for a "
"percent change in saturation. A positive number amplifies the effect, while "
"a negative one will move towards a grayscale spectrum."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2358
msgid ""
"We start with a function that can be either called from Lisp or invoked "
"interactively. In the former scenario, we pass to it the rate of change we "
"want. While in the latter, a minibuffer prompt asks for a number to apply "
"the desired effect. In either case, we intend to assign anew the value of "
"~modus-themes-operandi-color-overrides~ (light theme) and the same for "
"~modus-themes-vivendi-color-overrides~ (dark theme)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2383
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-saturate (percent)\n"
" \"Saturate current Modus theme palette overrides by PERCENT.\"\n"
" (interactive\n"
" (list (read-number \"Saturation by percent: \")))\n"
" (let* ((theme (modus-themes--current-theme))\n"
" (palette (pcase theme\n"
" ('modus-operandi modus-themes-operandi-colors)\n"
" ('modus-vivendi modus-themes-vivendi-colors)\n"
" (_ (error \"No Modus theme is active\"))))\n"
" (overrides (pcase theme\n"
" ('modus-operandi "
"'modus-themes-operandi-color-overrides)\n"
" ('modus-vivendi "
"'modus-themes-vivendi-color-overrides)\n"
" (_ (error \"No Modus theme is active\")))))\n"
" (let (name cons colors)\n"
" (dolist (cons palette)\n"
" (setq name (color-saturate-name (cdr cons) percent))\n"
" (setq name (format \"%s\" name))\n"
" (setq cons `(,(car cons) . ,name))\n"
" (push cons colors))\n"
" (set overrides colors))\n"
" (pcase theme\n"
" ('modus-operandi (modus-themes-load-operandi))\n"
" ('modus-vivendi (modus-themes-load-vivendi)))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2388
msgid ""
";; sample Elisp calls (or call `my-modus-themes-saturate' interactively) "
"(my-modus-themes-saturate 50) (my-modus-themes-saturate -75) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2391
msgid ""
"Using the above has an immediate effect, as it reloads the active Modus "
"theme."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2398
msgid ""
"The =my-modus-themes-saturate= function stores new color values in the "
"variables ~modus-themes-operandi-color-overrides~ and "
"~modus-themes-vivendi-color-overrides~, meaning that it undoes changes "
"implemented by the user on individual colors. To have both automatic "
"saturation adjustment across the board and retain per-case edits to the "
"palette, some tweaks to the above function are required. For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2404
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar my-modus-themes-vivendi-extra-color-overrides\n"
" '((fg-main . \"#ead0c0\")\n"
" (bg-main . \"#050515\"))\n"
" \"My bespoke colors for `modus-vivendi'.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2409
#, no-wrap
msgid ""
"(defvar my-modus-themes-operandi-extra-color-overrides\n"
" '((fg-main . \"#1a1a1a\")\n"
" (bg-main . \"#fefcf4\"))\n"
" \"My bespoke colors for `modus-operandi'.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2441
#, no-wrap
msgid ""
"(defun my-modus-themes-saturate (percent)\n"
" \"Saturate current Modus theme palette overrides by PERCENT.\n"
"Preserve the color values stored in\n"
"`my-modus-themes-operandi-extra-color-overrides',\n"
"`my-modus-themes-vivendi-extra-color-overrides'.\"\n"
" (interactive\n"
" (list (read-number \"Saturation by percent: \")))\n"
" (let* ((theme (modus-themes--current-theme))\n"
" (palette (pcase theme\n"
" ('modus-operandi modus-themes-operandi-colors)\n"
" ('modus-vivendi modus-themes-vivendi-colors)\n"
" (_ (error \"No Modus theme is active\"))))\n"
" (overrides (pcase theme\n"
" ('modus-operandi "
"'modus-themes-operandi-color-overrides)\n"
" ('modus-vivendi "
"'modus-themes-vivendi-color-overrides)\n"
" (_ (error \"No Modus theme is active\"))))\n"
" (extra-overrides (pcase theme\n"
" ('modus-operandi "
"my-modus-themes-operandi-extra-color-overrides)\n"
" ('modus-vivendi "
"my-modus-themes-vivendi-extra-color-overrides)\n"
" (_ (error \"No Modus theme is active\")))))\n"
" (let (name cons colors)\n"
" (dolist (cons palette)\n"
" (setq name (color-saturate-name (cdr cons) percent))\n"
" (setq name (format \"%s\" name))\n"
" (setq cons `(,(car cons) . ,name))\n"
" (push cons colors))\n"
" (set overrides (append extra-overrides colors)))\n"
" (pcase theme\n"
" ('modus-operandi (modus-themes-load-operandi))\n"
" ('modus-vivendi (modus-themes-load-vivendi)))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2445
msgid ""
"To disable the effect, one must reset the aforementioned variables of the "
"themes to ~nil~. Or specify a command for it, such as by taking inspiration "
"from the ~modus-themes-toggle~ we already provide:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2456
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-revert-overrides ()\n"
" \"Reset palette overrides and reload active Modus theme.\"\n"
" (interactive)\n"
" (setq modus-themes-operandi-color-overrides nil\n"
" modus-themes-vivendi-color-overrides nil)\n"
" (pcase (modus-themes--current-theme)\n"
" ('modus-operandi (modus-themes-load-operandi))\n"
" ('modus-vivendi (modus-themes-load-vivendi))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2462
#, no-wrap
msgid ""
"** Font configurations for Org and others (DIY)\n"
":properties:\n"
":custom_id: h:defcf4fc-8fa8-4c29-b12e-7119582cc929\n"
":end:\n"
"#+cindex: Font configurations\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2464
msgid "The themes are designed to cope well with mixed font configurations."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2466
msgid "[[#h:115e6c23-ee35-4a16-8cef-e2fcbb08e28b][Option for no font mixing]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2469
msgid ""
"This mostly concerns ~org-mode~ and ~markdown-mode~, though expect to find "
"it elsewhere like in ~Info-mode~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2474
msgid ""
"In practice it means that the user can safely opt for a more prose-friendly "
"proportionately spaced typeface as their default, while letting "
"spacing-sensitive elements like tables and inline code always use a "
"monospaced font, by inheriting from the ~fixed-pitch~ face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2477
msgid ""
"Users can try the built-in {{{kbd(M-x variable-pitch-mode)}}} to see the "
"effect in action."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2482
msgid ""
"To make everything use your desired font families, you need to configure the "
"~variable-pitch~ (proportional spacing) and ~fixed-pitch~ (monospaced) "
"faces respectively. It may also be convenient to set your main typeface by "
"configuring the ~default~ face the same way."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2485
msgid ""
"Put something like this in your initialization file (also consider reading "
"the doc string of ~set-face-attribute~):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2489
msgid ""
"#+begin_src emacs-lisp ;; Main typeface (set-face-attribute 'default nil "
":family \"DejaVu Sans Mono\" :height 110)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2492
msgid ""
";; Proportionately spaced typeface (set-face-attribute 'variable-pitch nil "
":family \"DejaVu Serif\" :height 1.0)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2496
msgid ""
";; Monospaced typeface (set-face-attribute 'fixed-pitch nil :family \"DejaVu "
"Sans Mono\" :height 1.0) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2499
msgid ""
"The next section shows how to make those work in a more elaborate setup that "
"is robust to changes between the Modus themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2513
msgid ""
"Note the differences in the ~:height~ property. The ~default~ face must "
"specify an absolute value, which is the point size × 10. So if you want to "
"use a font at point size =11=, you set the height to =110=.[fn:: ~:height~ "
"values do not need to be rounded to multiples of ten: the likes of =115= are "
"perfectly valid—some typefaces will change to account for those finer "
"increments.] Whereas every other face must have a value that is relative to "
"the default, represented as a floating point (if you use an integer, then "
"that means an absolute height). This is of paramount importance: it ensures "
"that all fonts can scale gracefully when using something like the "
"~text-scale-adjust~ command which only operates on the base font size "
"(i.e. the ~default~ face's absolute height)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2515
msgid ""
"[[#h:e6c5451f-6763-4be7-8fdb-b4706a422a4c][Note for EWW and Elfeed fonts "
"(SHR fonts)]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2521
#, no-wrap
msgid ""
"** Configure bold and italic faces (DIY)\n"
":properties:\n"
":custom_id: h:2793a224-2109-4f61-a106-721c57c01375\n"
":end:\n"
"#+cindex: Bold and italic fonts\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2526
msgid ""
"The Modus themes do not hardcode a ~:weight~ or ~:slant~ attribute in the "
"thousands of faces they cover. Instead, they configure the generic faces "
"called ~bold~ and ~italic~ to use the appropriate styles and then instruct "
"all relevant faces that require emphasis to inherit from them."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2530
msgid ""
"This practically means that users can change the particularities of what it "
"means for a construct to be bold/italic, by tweaking the ~bold~ and ~italic~ "
"faces. Cases where that can be useful include:"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2534
#, markdown-text
msgid ""
"The default typeface does not have a variant with slanted glyphs (e.g. Fira "
"Mono/Code as of this writing on 2021-07-07), so the user wants to add "
"another family for the italics, such as Hack."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2539
#, markdown-text
msgid ""
"The typeface of choice provides a multitude of weights and the user prefers "
"the light one by default. To prevent the bold weight from being too heavy "
"compared to the light one, they opt to make ~bold~ use a semibold weight."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2545
#, markdown-text
msgid ""
"The typeface distinguishes between oblique and italic forms by providing "
"different font variants (the former are just slanted versions of the upright "
"forms, while the latter have distinguishing features as well). In this "
"case, the user wants to specify the font that applies to the ~italic~ face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2549
msgid ""
"To achieve those effects, one must first be sure that the fonts they use "
"have support for those features. It then is a matter of following the "
"instructions for all face tweaks."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2555
msgid ""
"In this example, we set the default font family to Fira Code, while we "
"choose to render italics in the Hack typeface (obviously you need to pick "
"fonts that work well together):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2560
msgid ""
"#+begin_src emacs-lisp (set-face-attribute 'default nil :family \"Fira "
"Code\" :height 110) (set-face-attribute 'italic nil :family \"Hack\") "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2562
msgid "And here we play with different weights, using Source Code Pro:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2567
msgid ""
"#+begin_src emacs-lisp (set-face-attribute 'default nil :family \"Source "
"Code Pro\" :height 110 :weight 'light) (set-face-attribute 'bold nil "
":weight 'semibold) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2569
msgid "To reset the font family, one can use this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2573
msgid ""
"#+begin_src emacs-lisp (set-face-attribute 'italic nil :family 'unspecified) "
"#+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2580
msgid ""
"To ensure that the effects persist after switching between the Modus themes "
"(such as with {{{kbd(M-x modus-themes-toggle)}}}), the user needs to write "
"their configurations to a function and hook it up to the "
"~modus-themes-after-load-theme-hook~. This is necessary because the themes "
"set the default styles of faces (otherwise changing themes would not be "
"possible)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2589
msgid ""
"This is a minimal setup to preserve font configurations across theme load "
"phases. For a more permanent setup, it is better to employ the "
"~custom-set-faces~ function: ~set-face-attribute~ works just fine, though it "
"is more convenient for quick previews or for smaller scale operations "
"(~custom-set-faces~ follows the format used in the source code of the "
"themes)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2595
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
";; our generic function\n"
"(defun my-modes-themes-bold-italic-faces ()\n"
" (set-face-attribute 'default nil :family \"Source Code Pro\" :height "
"110)\n"
" (set-face-attribute 'bold nil :weight 'semibold))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2603
#, no-wrap
msgid ""
";; or use this if you configure a lot of face and attributes and\n"
";; especially if you plan to use `modus-themes-with-colors', as shown\n"
";; elsewhere in the manual\n"
"(defun my-modes-themes-bold-italic-faces ()\n"
" (custom-set-faces\n"
" '(default ((t :family \"Source Code Pro\" :height 110)))\n"
" '(bold ((t :weight semibold)))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2607
msgid ""
";; and here is the hook (add-hook 'modus-themes-after-load-theme-hook "
"#'my-modes-themes-bold-italic-faces) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2613
#, no-wrap
msgid ""
"** Custom Org user faces (DIY)\n"
":properties:\n"
":custom_id: h:89f0678d-c5c3-4a57-a526-668b2bb2d7ad\n"
":end:\n"
"#+cindex: Org extra faces\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2617
msgid ""
"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~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2622
msgid ""
"As those are meant to be custom faces, it is futile to have the themes guess "
"what each user wants to use, which keywords to target, and so on. Instead, "
"we can provide guidelines on how to customize things to one's liking with "
"the intent of retaining the overall aesthetic of the themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2627
msgid ""
"Please bear in mind that the end result of those is not controlled by the "
"active Modus theme but by how Org maps faces to its constructs. Editing "
"those while ~org-mode~ is active requires re-initialization of the mode with "
"{{{kbd(M-x org-mode-restart)}}} for changes to take effect."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2630
msgid ""
"Let us assume you wish to visually differentiate your keywords. You have "
"something like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2638
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq org-todo-keywords\n"
" '((sequence \"TODO(t)\" \"|\" \"DONE(D)\" \"CANCEL(C)\")\n"
" (sequence \"MEET(m)\" \"|\" \"MET(M)\")\n"
" (sequence \"STUDY(s)\" \"|\" \"STUDIED(S)\")\n"
" (sequence \"WRITE(w)\" \"|\" \"WROTE(W)\")))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2643
msgid ""
"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 (in case there is a difference between the two):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2650
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq org-todo-keyword-faces\n"
" '((\"MEET\" . '(bold org-todo))\n"
" (\"STUDY\" . '(warning org-todo))\n"
" (\"WRITE\" . '(shadow org-todo))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2654
msgid ""
"This will refashion the keywords you specify, while letting the other items "
"in ~org-todo-keywords~ use their original styles (which are defined in the "
"~org-todo~ and ~org-done~ faces)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2656
msgid "If you want back the defaults, try specifying just the ~org-todo~ face:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2663
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq org-todo-keyword-faces\n"
" '((\"MEET\" . org-todo)\n"
" (\"STUDY\" . org-todo)\n"
" (\"WRITE\" . org-todo)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2673
msgid ""
"When you inherit from multiple faces, you need to quote the list as shown "
"further above. The order is significant: the first entry is applied on top "
"of the second, overriding any properties that are explicitly set for both of "
"them: any property that is not specified is not overridden, so, for example, "
"if ~org-todo~ has a background and a foreground, while ~font-lock-type-face~ "
"only has a foreground, the merged face will include the background of the "
"former and the foreground of the latter. If you do not want to blend "
"multiple faces, you do not need a quoted list. A pattern of =keyword "
". face= will suffice."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2676
msgid ""
"Both approaches can be used simultaneously, as illustrated in this "
"configuration of the priority cookies:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2683
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq org-priority-faces\n"
" '((?A . '(bold org-priority))\n"
" (?B . org-priority)\n"
" (?C . '(shadow org-priority))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2688
msgid ""
"To find all the faces that are loaded in your current Emacs session, use "
"{{{kbd(M-x list-faces-display)}}}. Try {{{kbd(M-x describe-variable)}}} as "
"well and then specify the name of each of those Org variables demonstrated "
"above. Their documentation strings will offer you further guidance."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2691
msgid ""
"Recall that the themes let you retrieve a color from their palette. Do it "
"if you plan to control face attributes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2693
msgid ""
"[[#h:1487c631-f4fe-490d-8d58-d72ffa3bd474][Custom face specs using the "
"themes' palette]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2695
msgid "[[#h:02e25930-e71a-493d-828a-8907fc80f874][Check color combinations]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2700
#, no-wrap
msgid ""
"** Update Org block delimiter fontification (DIY)\n"
":properties:\n"
":custom_id: h:f44cc6e3-b0f1-4a5e-8a90-9e48fa557b50\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2705
msgid ""
"As noted in the section about ~modus-themes-org-blocks~, Org contains a "
"variable that determines whether the block's begin and end lines are "
"extended to the edge of the window "
"([[#h:b7e328c0-3034-4db7-9cdf-d5ba12081ca2][Option for org-mode block "
"styles]]). The variable is ~org-fontify-whole-block-delimiter-line~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2709
msgid ""
"Users who change the style of Org blocks from time to time may prefer to "
"automatically update delimiter line fontification, such as with the "
"following setup:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2718
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-org-fontify-block-delimiter-lines ()\n"
" \"Match `org-fontify-whole-block-delimiter-line' to theme style.\n"
"Run this function at the post theme load phase, such as with the\n"
"`modus-themes-after-load-theme-hook'.\"\n"
" (if (eq modus-themes-org-blocks 'gray-background)\n"
" (setq org-fontify-whole-block-delimiter-line t)\n"
" (setq org-fontify-whole-block-delimiter-line nil)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2722
#, no-wrap
msgid ""
"(add-hook 'modus-themes-after-load-theme-hook\n"
" #'my-modus-themes-org-fontify-block-delimiter-lines)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2725
msgid ""
"Then {{{kbd(M-x org-mode-restart)}}} for changes to take effect, though "
"manual intervention can be circumvented by tweaking the function thus:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2737
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-modus-themes-org-fontify-block-delimiter-lines ()\n"
" \"Match `org-fontify-whole-block-delimiter-line' to theme style.\n"
"Run this function at the post theme load phase, such as with the\n"
"`modus-themes-after-load-theme-hook'.\"\n"
" (if (eq modus-themes-org-blocks 'gray-background)\n"
" (setq org-fontify-whole-block-delimiter-line t)\n"
" (setq org-fontify-whole-block-delimiter-line nil))\n"
" (when (derived-mode-p 'org-mode)\n"
" (font-lock-flush)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2745
#, no-wrap
msgid ""
"** Measure color contrast (DIY)\n"
":properties:\n"
":custom_id: h:02e25930-e71a-493d-828a-8907fc80f874\n"
":end:\n"
"#+findex: modus-themes-contrast\n"
"#+findex: modus-themes-wcag-formula\n"
"#+cindex: Color contrast\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2753
msgid ""
"The themes provide the functions ~modus-themes-wcag-formula~ and "
"~modus-themes-contrast~. The former is a direct implementation of the WCAG "
"formula: <https://www.w3.org/TR/WCAG20-TECHS/G18.html>. It calculates the "
"relative luminance of a color value that is expressed in hexadecimal RGB "
"notation. While the latter function is just a convenient wrapper for "
"comparing the relative luminance between two colors."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2760
msgid ""
"In practice, one needs to work only with ~modus-themes-contrast~. It "
"accepts two color values and returns their contrast ratio. Values range "
"from 1 to 21 (lowest to highest). The themes are designed to always be "
"equal or higher than 7 for each combination of background and foreground "
"that they use (this is the WCAG AAA standard---the most demanding of its "
"kind)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2762
msgid "A couple of examples (rounded numbers):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2768
msgid ""
"#+begin_src emacs-lisp ;; Pure white with pure green (modus-themes-contrast "
"\"#ffffff\" \"#00ff00\") ;; => 1.37 ;; That is an outright inaccessible "
"combo"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2774
msgid ""
";; Pure black with pure green (modus-themes-contrast \"#000000\" "
"\"#00ff00\") ;; => 15.3 ;; That is a highly accessible combo #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2777
msgid ""
"It does not matter which color value comes first. The ratio is always the "
"same."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2780
msgid ""
"If one does not wish to read all the decimal points, it is possible to try "
"something like this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2784
msgid ""
"#+begin_src emacs-lisp (format \"%0.2f\" (modus-themes-contrast \"#000000\" "
"\"#00ff00\")) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2792
msgid ""
"While it is fine to perform such calculations on a case-by-case basis, it is "
"preferable to implement formulas and tables for more demanding tasks. Such "
"instruments are provided by ~org-mode~ or ~orgtbl-mode~, both of which are "
"built into Emacs. Below is such a table that derives the contrast ratio of "
"all colors in the first column (pure red, green, blue) relative to the "
"color specified in the first row of the second column (pure white) and "
"rounds the results:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2801
#, no-wrap
msgid ""
"#+begin_example\n"
"| | #ffffff |\n"
"|---------+---------|\n"
"| #ff0000 | 4.00 |\n"
"| #00ff00 | 1.37 |\n"
"| #0000ff | 8.59 |\n"
"#+tblfm: $2='(modus-themes-contrast $1 @1$2);%0.2f\n"
"#+end_example\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2807
msgid ""
"To measure color contrast one needs to start from a known value. This "
"typically is the background. The Modus themes define an expanded palette in "
"large part because certain colors are only meant to be used in combination "
"with some others. Consult the source code for the minutia and relevant "
"commentary."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2810
msgid ""
"Such knowledge may prove valuable while attempting to override some of the "
"themes' colors: [[#h:307d95dd-8dbd-4ece-a543-10ae86f155a6][Override "
"colors]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2815
#, no-wrap
msgid ""
"** Load theme depending on time of day (DIY)\n"
":properties:\n"
":custom_id: h:1d1ef4b4-8600-4a09-993c-6de3af0ddd26\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2819
msgid ""
"While we do provide ~modus-themes-toggle~ to manually switch between the "
"themes, users may also set up their system to perform such a task "
"automatically at sunrise and sunset."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2823
msgid ""
"This can be accomplished by specifying the coordinates of one's location "
"using the built-in {{{file(solar.el)}}} and then configuring the =circadian= "
"package:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2829
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(use-package solar ; built-in\n"
" :config\n"
" (setq calendar-latitude 35.17\n"
" calendar-longitude 33.36))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2837
#, no-wrap
msgid ""
"(use-package circadian ; you need to install this\n"
" :ensure\n"
" :after solar\n"
" (setq circadian-themes '((:sunrise . modus-operandi)\n"
" (:sunset . modus-vivendi)))\n"
" (circadian-setup))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2843
#, no-wrap
msgid ""
"** Backdrop for pdf-tools (DIY)\n"
":properties:\n"
":custom_id: h:ff69dfe1-29c0-447a-915c-b5ff7c5509cd\n"
":end:\n"
"#+cindex: Remapping pdf-tools backdrop\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2853
msgid ""
"Most PDF files use a white background for their page, making it impossible "
"to discern the file's boundaries in the buffer while using the Modus "
"Operandi theme. To introduce a distinction between the buffer's backdrop "
"and the PDF page's background, the former must be rendered as some shade of "
"gray. Ideally, ~pdf-tools~ would provide a face that the themes could "
"support directly, though this does not seem to be the case for the time "
"being. We must thus employ the face remapping technique that is documented "
"elsewhere in this document to change the buffer-local value of the ~default~ "
"face."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2855
msgid "[[#h:7a93cb6f-4eca-4d56-a85c-9dcd813d6b0f][Remap face with local value]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2857
msgid "To remap the buffer's backdrop, we start with a function like this one:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2863
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2884
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-pdf-tools-backdrop ()\n"
" (face-remap-add-relative\n"
" 'default\n"
" `(:background ,(modus-themes-color 'bg-alt))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2866
msgid "(add-hook 'pdf-tools-enabled-hook #'my-pdf-tools-backdrop) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2873
msgid ""
"The idea is to assign that function to a hook that gets called when "
"~pdf-tools~ renders the document: ~pdf-tools-enabled-hook~. This is enough "
"when you only use one theme. However it has the downside of setting the "
"background color value only at render time. In other words, the face "
"remapping function does not get evaluated anew whenever the theme changes, "
"such as upon invoking {{{kbd(M-x modus-themes-toggle)}}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2878
msgid ""
"To have our face remapping adapt gracefully while switching between the "
"Modus themes, we need to also account for the current theme and control the "
"activation of ~pdf-view-midnight-minor-mode~. To which end we arrive at "
"something like the following, which builds on the above example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2891
#, no-wrap
msgid ""
"(defun my-pdf-tools-midnight-mode-toggle ()\n"
" (when (derived-mode-p 'pdf-view-mode)\n"
" (if (eq (car custom-enabled-themes) 'modus-vivendi)\n"
" (pdf-view-midnight-minor-mode 1)\n"
" (pdf-view-midnight-minor-mode -1))\n"
" (my-pdf-tools-backdrop)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2895
msgid ""
"(add-hook 'pdf-tools-enabled-hook #'my-pdf-tools-midnight-mode-toggle) "
"(add-hook 'modus-themes-after-load-theme-hook "
"#'my-pdf-tools-midnight-mode-toggle) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2899
msgid ""
"With those in place, PDFs have a distinct backdrop for their page, while "
"they automatically switch to their dark mode when ~modus-themes-toggle~ is "
"called from inside a buffer whose major-mode is ~pdf-view-mode~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2904
#, no-wrap
msgid ""
"** A theme-agnostic hook for theme loading (DIY)\n"
":properties:\n"
":custom_id: h:86f6906b-f090-46cc-9816-1fe8aeb38776\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2909
msgid ""
"The themes are designed with the intent to be useful to Emacs users of "
"varying skill levels, from beginners to experts. This means that we try to "
"make things easier by not expecting anyone reading this document to be "
"proficient in Emacs Lisp or programming in general."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2917
msgid ""
"Such a case is with the use of the ~modus-themes-after-load-theme-hook~, "
"which runs after ~modus-themes-toggle~, ~modus-themes-load-operandi~, or "
"~modus-themes-load-vivendi~ is evaluated. We recommend using that hook for "
"advanced customizations, because (1) we know for sure that it is available "
"once the themes are loaded, and (2) anyone consulting this manual, "
"especially the sections on enabling and loading the themes, will be in a "
"good position to benefit from that hook."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2922
msgid ""
"Advanced users who have a need to switch between the Modus themes and other "
"items will find that such a hook does not meet their requirements: it only "
"works with the Modus themes and only with the aforementioned functions."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2924
msgid "A theme-agnostic setup can be configured thus:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2928
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar after-enable-theme-hook nil\n"
" \"Normal hook run after enabling a theme.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2932
#, no-wrap
msgid ""
"(defun run-after-enable-theme-hook (&rest _args)\n"
" \"Run `after-enable-theme-hook'.\"\n"
" (run-hooks 'after-enable-theme-hook))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2935
msgid "(advice-add 'enable-theme :after #'run-after-enable-theme-hook) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2941
msgid ""
"This creates the ~after-enable-theme-hook~ and makes it run after each call "
"to ~enable-theme~, which means that it will work for all themes and also has "
"the benefit that it does not depend on functions such as "
"~modus-themes-toggle~ and the others mentioned above. ~enable-theme~ is "
"called internally by ~load-theme~, so the hook works everywhere."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2948
msgid ""
"Now this specific piece of Elisp may be simple for experienced users, but it "
"is not easy to read for newcomers, including the author of the Modus themes "
"for the first several months of their time as an Emacs user. Hence our "
"hesitation to recommend it as part of the standard setup of the Modus themes "
"(it is generally a good idea to understand what the implications are of "
"advising a function)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2953
#, no-wrap
msgid ""
"* Face coverage\n"
":properties:\n"
":custom_id: h:a9c8f29d-7f72-4b54-b74b-ddefe15d6a19\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2957
msgid ""
"The Modus themes try to provide as close to full face coverage as possible. "
"This is necessary to ensure a consistently accessible reading experience "
"across all available interfaces."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2965
#, no-wrap
msgid ""
"** Full support for packages or face groups\n"
":properties:\n"
":alt_title: Supported packages\n"
":description: Full list of covered face groups\n"
":custom_id: h:60ed4275-60d6-49f8-9287-9a64e54bea0e\n"
":end:\n"
"#+cindex: Explicitly supported packages\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:2970
msgid ""
"This list will always be updated to reflect the current state of the "
"project. The idea is to offer an overview of the known status of all "
"affected face groups. The items with an appended asterisk =*= tend to have "
"lots of extensions, so the \"full support\" may not be 100% true…"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3287
msgid ""
"+ ace-window + ag + alert + all-the-icons + annotate + ansi-color + anzu + "
"apropos + apt-sources-list + artbollocks-mode + auctex and TeX + "
"auto-dim-other-buffers + avy + awesome-tray + bbdb + binder + bm + bongo + "
"boon + bookmark + breakpoint (provided by the built-in {{{file(gdb-mi.el)}}} "
"library) + buffer-expose + calendar and diary + calfw + centaur-tabs + cfrs "
"+ change-log and log-view (such as ~vc-print-log~, ~vc-print-root-log~) + "
"cider + circe + color-rg + column-enforce-mode + company-mode* + "
"company-posframe + compilation-mode + completions + consult + corfu + "
"counsel* + counsel-css + counsel-org-capture-string + cov + cperl-mode + "
"css-mode + csv-mode + ctrlf + cursor-flash + custom (what you get with "
"{{{kbd(M-x customize)}}}) + dap-mode + dashboard (emacs-dashboard) + "
"deadgrep + debbugs + define-word + deft + dictionary + diff-hl + diff-mode + "
"dim-autoload + dir-treeview + dired + dired-async + dired-git + "
"dired-git-info + dired-narrow + dired-subtree + diredc + diredfl + diredp "
"(dired+) + disk-usage + display-fill-column-indicator-mode + doom-modeline "
"+ dynamic-ruler + easy-jekyll + easy-kill + ebdb + ediff + eglot + el-search "
"+ eldoc-box + elfeed + elfeed-score + elpher + embark + emms + enh-ruby-mode "
"(enhanced-ruby-mode) + epa + equake + erc + eros + ert + eshell + "
"eshell-fringe-status + eshell-git-prompt + eshell-prompt-extras (epe) + "
"eshell-syntax-highlighting + evil* (evil-mode) + evil-goggles + evil-snipe "
"+ evil-visual-mark-mode + eww + exwm + eyebrowse + fancy-dabbrev + flycheck "
"+ flycheck-color-mode-line + flycheck-indicator + flycheck-posframe + "
"flymake + flyspell + flyspell-correct + flx + freeze-it + frog-menu + focus "
"+ fold-this + font-lock (generic syntax highlighting) + forge + fountain "
"(fountain-mode) + geiser + git-commit + git-gutter (and variants) + "
"git-lens + git-rebase + git-timemachine + git-walktree + gnus + gotest + "
"golden-ratio-scroll-screen + helm* + helm-ls-git + helm-switch-shell + "
"helm-xref + helpful + highlight-blocks + highlight-defined + "
"highlight-escape-sequences (~hes-mode~) + highlight-indentation + "
"highlight-numbers + highlight-parentheses "
"([[#h:24bab397-dcb2-421d-aa6e-ec5bd622b913][Note on "
"highlight-parentheses.el]]) + highlight-symbol + highlight-tail + "
"highlight-thing + hl-defined + hl-fill-column + hl-line-mode + hl-todo + "
"hydra + hyperlist + ibuffer + icomplete + icomplete-vertical + ido-mode + "
"iedit + iflipb + imenu-list + indium + info + info-colors + interaction-log "
"+ ioccur + isearch, occur, etc. + isl (isearch-light) + ivy* + "
"ivy-posframe + jira (org-jira) + journalctl-mode + js2-mode + julia + "
"jupyter + kaocha-runner + keycast + ledger-mode + line numbers "
"(~display-line-numbers-mode~ and global variant) + lsp-mode + lsp-ui + "
"macrostep + magit + magit-imerge + make-mode + man + marginalia + "
"markdown-mode + markup-faces (~adoc-mode~) + mentor + messages + "
"minibuffer-line + minimap + mmm-mode + mode-line + mood-line + moody + mpdel "
"+ mu4e + mu4e-conversation + multiple-cursors + neotree + no-emoji + notmuch "
"+ num3-mode + nxml-mode + objed + orderless + org* + org-journal + org-noter "
"+ org-pomodoro + org-recur + org-roam + org-superstar + "
"org-table-sticky-header + org-tree-slide + org-treescope + origami + "
"outline-mode + outline-minor-faces + package (what you get with {{{kbd(M-x "
"list-packages)}}}) + page-break-lines + pandoc-mode + paradox + paren-face "
"+ parrot + pass + pdf-tools + persp-mode + perspective + phi-grep + "
"phi-search + pkgbuild-mode + pomidor + popup + powerline + powerline-evil + "
"prism ([[#h:a94272e0-99da-4149-9e80-11a7e67a2cf2][Note for prism.el]]) + "
"proced + prodigy + pulse + quick-peek + racket-mode + rainbow-blocks + "
"rainbow-identifiers + rainbow-delimiters + rcirc + recursion-indicator + "
"regexp-builder (also known as ~re-builder~) + rg (rg.el) + ripgrep + rmail "
"+ ruler-mode + sallet + selectrum + selectrum-prescient + semantic + sesman "
"+ shell-script-mode + shortdoc + show-paren-mode + shr + side-notes + "
"sieve-mode + skewer-mode + smart-mode-line + smartparens + smerge + solaire "
"+ spaceline + speedbar + spell-fu + spray + stripes + suggest + "
"switch-window + swiper + swoop + sx + symbol-overlay + syslog-mode + "
"tab-bar-groups + tab-bar-mode + tab-line-mode + table (built-in table.el) + "
"telega + telephone-line + terraform-mode + term + tomatinho + transient "
"(pop-up windows such as Magit's) + trashed + treemacs + tty-menu + tuareg + "
"typescript + undo-tree + vc (vc-dir.el, vc-hooks.el) + vc-annotate (the "
"output of {{{kbd(C-x v g)}}}) + vdiff + vertico + vimish-fold + "
"visible-mark + visual-regexp + volatile-highlights + vterm + wcheck-mode + "
"web-mode + wgrep + which-function-mode + which-key + whitespace-mode + "
"window-divider-mode + winum + writegood-mode + woman + xah-elisp-mode + xref "
"+ xterm-color (and ansi-colors) + yaml-mode + yasnippet + ztree"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3290
msgid ""
"Plus many other miscellaneous faces that are provided by the upstream GNU "
"Emacs distribution."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3296
#, no-wrap
msgid ""
"** Indirectly covered packages\n"
":properties:\n"
":custom_id: h:2cb359c7-3a84-4262-bab3-dcdc1d0034d7\n"
":end:\n"
"#+cindex: Implicitly supported packages\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3300
msgid ""
"These do not require any extra styles because they are configured to inherit "
"from some basic faces or their dependencies which are directly supported by "
"the themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3318
msgid ""
"+ bufler + counsel-notmuch + edit-indirect + evil-owl + fortran-mode + "
"goggles + i3wm-config-mode + perl-mode + php-mode + rjsx-mode + side-hustle "
"+ swift-mode + tab-bar-echo-area + tide + vertico-indexed + vertico-mouse + "
"vertico-quick"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3323
#, no-wrap
msgid ""
"* Notes on individual packages\n"
":properties:\n"
":custom_id: h:4c4d901a-84d7-4f20-bd99-0808c2b06eba\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3326
msgid ""
"This section covers information that may be of interest to users of "
"individual packages."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3331
#, no-wrap
msgid ""
"** Note on avy hints\n"
":properties:\n"
":custom_id: h:2fdce705-6de7-44e6-ab7f-18f59af99e01\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3335
msgid ""
"Hints can appear everywhere, in wildly varying contexts, hence, their "
"appearance, by necessity, is a compromise. However, there are various "
"options for making them stand out. First is dimming the surroundings:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3339
msgid "#+begin_src emacs-lisp (setq avy-background t) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3342
msgid ""
"Dimming works well when you find it difficult to spot hints, any hint. "
"Second is limiting the number of faces used by hints:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3351
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(setq avy-lead-faces\n"
" '(avy-lead-face\n"
" avy-lead-face-1\n"
" avy-lead-face-1\n"
" avy-lead-face-1\n"
" avy-lead-face-1))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3356
msgid ""
"Limiting the number of faces works well with longer hints when you find it "
"difficult to identify individual hints, especially with hints touching each "
"other. The first character of the hint will have an intense color, the "
"remaining ones the same neutral color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3360
msgid ""
"Third is preferring commands that produce fewer candidates. Fewer hints is "
"less noise: ~avy-goto-char-timer~ is an excellent alternative to "
"~avy-goto-char~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3365
#, no-wrap
msgid ""
"** Note on calendar.el weekday and weekend colors\n"
":properties:\n"
":custom_id: h:b2db46fb-32f4-44fd-8e11-d2b261cf51ae\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3371
msgid ""
"By default, the {{{kbd(M-x calendar)}}} interface differentiates weekdays "
"from weekends by applying a gray color to the former and a faint red to the "
"latter. The idea for this approach is that the weekend should serve as a "
"subtle warning that no work is supposed to be done on that day, per the "
"design of traditional calendars."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3375
msgid ""
"Users who prefer all days to look the same can configure the variable "
"~calendar-weekend-days~ to either use gray of weekdays or the faint red of "
"weekends uniformly."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3379
msgid ""
"#+begin_src emacs-lisp ;; All are treated like weekdays (gray color) (setq "
"calendar-weekend-days nil)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3382
msgid ""
";; All are treated like weekends (red-faint color) (setq "
"calendar-weekend-days (number-sequence 0 6))"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3386
msgid ""
";; The default marks the Saturday and Sunday as the weekend (setq "
"calendar-weekend-days '(0 6)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3389
msgid "For changes to take effect, the Calendar buffer needs to be generated anew."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3394
#, no-wrap
msgid ""
"** Note on underlines in compilation buffers\n"
":properties:\n"
":custom_id: h:420f5a33-c7a9-4112-9b04-eaf2cbad96bd\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3398
msgid ""
"Various buffers that produce compilation results or run tests on code apply "
"an underline to the file names they reference or to relevant messages. "
"Users may consider this unnecessary or excessive."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3400
msgid "To outright disable the effect, use this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3404
msgid "#+begin_src emacs-lisp (setq compilation-message-face nil) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3407
msgid ""
"If some element of differentiation is still desired, a good option is to "
"render the affected text using the ~italic~ face:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3411
msgid "#+begin_src emacs-lisp (setq compilation-message-face 'italic) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3418
#, no-wrap
msgid ""
"** Note on inline Latex in Org buffers\n"
":properties:\n"
":custom_id: h:dd8478da-f56a-45cd-b199-b836c85c3c5a\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3422
msgid ""
"Org can work with inline latex and related syntax. To actually fontify "
"those constructs, set the variable ~org-highlight-latex-and-related~ to the "
"desired list of values (per its doc string). For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3426
msgid ""
"#+begin_src emacs-lisp (setq org-highlight-latex-and-related '(latex "
"script)) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3428
msgid "Remember to use {{{kbd(M-x org-mode-restart)}}} for changes to take effect."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3433
#, no-wrap
msgid ""
"** Note on dimmer.el\n"
":properties:\n"
":custom_id: h:8eb4b758-d318-4480-9ead-357a571beb93\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3438
msgid ""
"The {{{file(dimmer.el)}}} library by Neil Okamoto can be configured to "
"automatically dim the colors of inactive Emacs windows. To guarantee "
"consistent results with the Modus themes, we suggest some tweaks to the "
"default styles, such as in this minimal setup:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3445
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(use-package dimmer\n"
" :config\n"
" (setq dimmer-fraction 0.3)\n"
" (setq dimmer-adjustment-mode :foreground)\n"
" (setq dimmer-use-colorspace :rgb)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3448
#, no-wrap
msgid ""
" (dimmer-mode 1))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3454
msgid ""
"Of the above, we strongly recommend the RGB color space because it is the "
"one that remains faithful to the hueness of the colors used by the themes. "
"Whereas the default CIELAB space has a tendency to distort colors in "
"addition to applying the dim effect, which can be somewhat disorienting."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3458
msgid ""
"The value of the ~dimmer-fraction~ has been selected empirically. Users "
"might prefer to tweak it further (increasing it makes the dim effect more "
"pronounced)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3464
msgid ""
"Changing the ~dimmer-adjustment-mode~ is a matter of preference. Though "
"because the Modus themes use black and white as their base colors, any other "
"value for that variable will turn the main background gray. This "
"inadvertently leads to the opposite of the intended utility of this package: "
"it draws too much attention to unfocused windows."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3469
#, no-wrap
msgid ""
"** Note on display-fill-column-indicator-mode\n"
":properties:\n"
":custom_id: h:2a602816-bc1b-45bf-9675-4cbbd7bf6cab\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3475
msgid ""
"While designing the style for ~display-fill-column-indicator-mode~, we "
"stayed close to the mode's defaults: to apply a subtle foreground color to "
"the ~fill-column-indicator~ face, which blends well with the rest of theme "
"and is consistent with the role of that mode. This is to not upset the "
"expectations of users."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3482
msgid ""
"Nevertheless, ~display-fill-column-indicator-mode~ has some known "
"limitations pertaining to its choice of using typographic characters to draw "
"its indicator. What should be a continuous vertical line might appear as a "
"series of dashes in certain contexts or under specific conditions: a "
"non-default value for ~line-spacing~, scaled and/or variable-pitch headings "
"have been observed to cause this effect."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3487
msgid ""
"Given that we cannot control such factors, it may be better for affected "
"users to deviate from the default style of the ~fill-column-indicator~ "
"face. Instead of setting a foreground color, one could use a background and "
"have the foreground be indistinguishable from it. For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3494
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-with-colors\n"
" (custom-set-faces\n"
" `(fill-column-indicator ((,class :background ,bg-inactive\n"
" :foreground ,bg-inactive)))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3501
#, no-wrap
msgid ""
"** Note on highlight-parentheses.el\n"
":PROPERTIES:\n"
":CUSTOM_ID: h:24bab397-dcb2-421d-aa6e-ec5bd622b913\n"
":END:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3506
msgid ""
"The =highlight-parentheses= package provides contextual coloration of "
"surrounding parentheses, highlighting only those which are around the "
"point. The package expects users to customize the applicable colors on "
"their own by configuring certain variables."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3511
msgid ""
"To make the Modus themes work as expected with this, we need to use some of "
"the techniques that are discussed at length in the various "
"\"Do-It-Yourself\" (DIY) sections, which provide insight into the more "
"advanced customization options of the themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3513
msgid ""
"[[#h:f4651d55-8c07-46aa-b52b-bed1e53463bb][Advanced customization "
"(do-it-yourself)]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3519
msgid ""
"In the following example, we are assuming that the user wants to (i) re-use "
"color variables provided by the themes, (ii) be able to retain their tweaks "
"while switching between ~modus-operandi~ and ~modus-vivendi~, and (iii) have "
"the option to highlight either the foreground of the parentheses or the "
"background as well."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3522
msgid ""
"We start by defining our own variable, which will serve as a toggle between "
"foreground and background coloration styles:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3527
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defvar my-highlight-parentheses-use-background t\n"
" \"Prefer `highlight-parentheses-background-colors'.\")\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3529
msgid "Then we can update our preference with this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3534
msgid ""
"#+begin_src emacs-lisp ;; Set to nil to disable backgrounds. (setq "
"my-highlight-parentheses-use-background nil) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3539
msgid ""
"To re-use colors from the themes, we must wrap our code in the "
"~modus-themes-with-colors~ macro. Our implementation must interface with "
"the variables ~highlight-parentheses-background-colors~ and/or "
"~highlight-parentheses-colors~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3543
msgid ""
"So we can have something like this (the doc string of "
"~modus-themes-with-colors~ explains where the names of the colors can be "
"found):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3549
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-with-colors\n"
" ;; Our preference for setting either background or foreground\n"
" ;; styles, depending on `my-highlight-parentheses-use-background'.\n"
" (if my-highlight-parentheses-use-background\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3560
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3607
#, no-wrap
msgid ""
" ;; Here we set color combinations that involve both a background\n"
" ;; and a foreground value.\n"
" (setq highlight-parentheses-background-colors (list cyan-refine-bg\n"
" "
"magenta-refine-bg\n"
" "
"green-refine-bg\n"
" "
"yellow-refine-bg)\n"
" highlight-parentheses-colors (list cyan-refine-fg\n"
" magenta-refine-fg\n"
" green-refine-fg\n"
" yellow-refine-fg))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3568
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3615
#, no-wrap
msgid ""
" ;; And here we pass only foreground colors while disabling any\n"
" ;; backgrounds.\n"
" (setq highlight-parentheses-colors (list green-intense\n"
" magenta-intense\n"
" blue-intense\n"
" red-intense)\n"
" highlight-parentheses-background-colors nil)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3571
msgid ""
";; Include this if you also want to make the parentheses bold: "
"(set-face-attribute 'highlight-parentheses-highlight nil :inherit 'bold)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3576
msgid ""
";; Our changes must be evaluated before enabling the relevant mode, so ;; "
"this comes last. (global-highlight-parentheses-mode 1) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3581
msgid ""
"For our changes to persist while switching between the Modus themes, we need "
"to include them in a function which can then get passed to "
"~modus-themes-after-load-theme-hook~. This is the complete implementation:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3585
msgid ""
"#+begin_src emacs-lisp ;; Configurations for `highlight-parentheses': "
"(require 'highlight-parentheses)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3588
#, no-wrap
msgid ""
"(defvar my-highlight-parentheses-use-background t\n"
" \"Prefer `highlight-parentheses-background-colors'.\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3590
msgid ""
"(setq my-highlight-parentheses-use-background nil) ; Set to nil to disable "
"backgrounds"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3596
#, no-wrap
msgid ""
"(defun my-modus-themes-highlight-parentheses ()\n"
" (modus-themes-with-colors\n"
" ;; Our preference for setting either background or foreground\n"
" ;; styles, depending on `my-highlight-parentheses-use-background'.\n"
" (if my-highlight-parentheses-use-background\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3618
#, no-wrap
msgid ""
" ;; Include this if you also want to make the parentheses bold:\n"
" (set-face-attribute 'highlight-parentheses-highlight nil :inherit 'bold)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3622
#, no-wrap
msgid ""
" ;; Our changes must be evaluated before enabling the relevant mode, so\n"
" ;; this comes last.\n"
" (global-highlight-parentheses-mode 1))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3625
msgid ""
"(add-hook 'modus-themes-after-load-theme-hook "
"#'my-modus-themes-highlight-parentheses) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3630
#, no-wrap
msgid ""
"** Note on mmm-mode.el background colors\n"
":properties:\n"
":custom_id: h:99cf0d6c-e478-4e26-9932-3bf3427d13f6\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3636
msgid ""
"The faces used by {{{file(mmm-mode.el)}}} are expected to have a colorful "
"background, while they should not touch any foreground value. The idea is "
"that they must not interfere with existing fontification. Those background "
"colors need to be distinct from each other, such as an unambiguous red "
"juxtaposed with a clear blue."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3639
msgid ""
"While this design may be internally consistent with the raison d'être of "
"that library, it inevitably produces inaccessible color combinations."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3641
msgid "There are two competing goals at play:"
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3644
#, markdown-text
msgid ""
"Legibility of the text, understood as the contrast ratio between the "
"background and the foreground."
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3647
#, markdown-text
msgid ""
"Semantic precision of each face which entails faithfulness to color-coding "
"of the underlying background."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3653
msgid ""
"As the Modus themes are designed with the express purpose of conforming with "
"the first point, we have to forgo the apparent color-coding of the "
"background elements. Instead we use subtle colors that do not undermine the "
"legibility of the affected text while they still offer a sense of added "
"context."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3657
msgid ""
"Users who might prefer to fall below the minimum 7:1 contrast ratio in "
"relative luminance (the accessibility target we conform with), can opt to "
"configure the relevant faces on their own."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3662
msgid ""
"This example uses more vivid background colors, though it comes at the very "
"high cost of degraded legibility."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3675
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(modus-themes-with-colors\n"
" (custom-set-faces\n"
" `(mmm-cleanup-submode-face ((,class :background ,yellow-refine-bg)))\n"
" `(mmm-code-submode-face ((,class :background ,bg-active)))\n"
" `(mmm-comment-submode-face ((,class :background ,blue-refine-bg)))\n"
" `(mmm-declaration-submode-face ((,class :background ,cyan-refine-bg)))\n"
" `(mmm-default-submode-face ((,class :background ,bg-alt)))\n"
" `(mmm-init-submode-face ((,class :background ,magenta-refine-bg)))\n"
" `(mmm-output-submode-face ((,class :background ,red-refine-bg)))\n"
" `(mmm-special-submode-face ((,class :background ,green-refine-bg)))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3681
#, no-wrap
msgid ""
"** Note on prism.el\n"
":properties:\n"
":alt_title: Note for prism\n"
":custom_id: h:a94272e0-99da-4149-9e80-11a7e67a2cf2\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3686
msgid ""
"This package by Adam Porter, aka \"alphapapa\" or \"github-alphapapa\", "
"implements an alternative to the typical coloration of code. Instead of "
"highlighting the syntactic constructs, it applies color to different levels "
"of depth in the code structure."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3691
msgid ""
"As {{{file(prism.el)}}} offers a broad range of customisations, we cannot "
"style it directly at the theme level: that would run contrary to the spirit "
"of the package. Instead, we may offer preset color schemes. Those should "
"offer a starting point for users to adapt to their needs."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3694
msgid ""
"In the following code snippets, we employ the ~modus-themes-with-colors~ "
"macro: [[#h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae][Face specs at scale using "
"the themes' palette]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3696
msgid "These are the minimum recommended settings with 16 colors:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3699
msgid "#+begin_src emacs-lisp (setq prism-num-faces 16)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3721
#, no-wrap
msgid ""
"(prism-set-colors\n"
" :desaturations '(0) ; do not change---may lower the contrast ratio\n"
" :lightens '(0) ; same\n"
" :colors (modus-themes-with-colors\n"
" (list fg-main\n"
" magenta\n"
" cyan-alt-other\n"
" magenta-alt-other\n"
" blue\n"
" magenta-alt\n"
" cyan-alt\n"
" red-alt-other\n"
" green\n"
" fg-main\n"
" cyan\n"
" yellow\n"
" blue-alt\n"
" red-alt\n"
" green-alt-other\n"
" fg-special-warm)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3723
msgid "With 8 colors:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3726
msgid "#+begin_src emacs-lisp (setq prism-num-faces 8)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3740
#, no-wrap
msgid ""
"(prism-set-colors\n"
" :desaturations '(0) ; do not change---may lower the contrast ratio\n"
" :lightens '(0) ; same\n"
" :colors (modus-themes-with-colors\n"
" (list blue\n"
" magenta\n"
" magenta-alt-other\n"
" cyan-alt-other\n"
" fg-main\n"
" blue-alt\n"
" red-alt-other\n"
" cyan)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3743
msgid ""
"And this is with 4 colors, which produces results that are the closest to "
"the themes' default aesthetic:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3746
msgid "#+begin_src emacs-lisp (setq prism-num-faces 4)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3756
#, no-wrap
msgid ""
"(prism-set-colors\n"
" :desaturations '(0) ; do not change---may lower the contrast ratio\n"
" :lightens '(0) ; same\n"
" :colors (modus-themes-with-colors\n"
" (list blue\n"
" magenta\n"
" magenta-alt-other\n"
" green-alt)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3760
msgid ""
"If you need to apply desaturation and lightening, you can use what the "
"{{{file(prism.el)}}} documentation recommends, like this (adapting to the "
"examples with the 4, 8, 16 colors):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3771
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(prism-set-colors\n"
" :desaturations (cl-loop for i from 0 below 16 collect (* i 2.5))\n"
" :lightens (cl-loop for i from 0 below 16 collect (* i 2.5))\n"
" :colors (modus-themes-with-colors\n"
" (list fg-main\n"
" cyan-alt-other\n"
" magenta-alt-other\n"
" magenta)))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3777
#, no-wrap
msgid ""
"** Note on god-mode.el\n"
":properties:\n"
":alt_title: Note for god-mode\n"
":custom_id: h:4da1d515-3e05-47ef-9e45-8251fc7e986a\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3784
msgid ""
"The ~god-mode~ library does not provide faces that could be configured by "
"the Modus themes. Users who would like to get some visual feedback on the "
"status of {{{kbd(M-x god-mode)}}} are instead encouraged by upstream to set "
"up their own configurations, such as by changing the ~mode-line~ face "
"([[#h:f4651d55-8c07-46aa-b52b-bed1e53463bb][Advanced customization "
"(do-it-yourself)]]). This is an adaptation of the approach followed in the "
"upstream README:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3798
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(defun my-god-mode-update-mode-line ()\n"
" \"Make `mode-line' blue if God local mode is active.\"\n"
" (modus-themes-with-colors\n"
" (if god-local-mode\n"
" (set-face-attribute 'mode-line nil\n"
" :foreground blue-active\n"
" :background bg-active-accent\n"
" :box blue)\n"
" (set-face-attribute 'mode-line nil\n"
" :foreground fg-active\n"
" :background bg-active\n"
" :box fg-alt))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3801
msgid "(add-hook 'post-command-hook 'my-god-mode-update-mode-line) #+end_src"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3807
msgid ""
"We employ the ~modus-themes-with-colors~ which provides access to color "
"variables defined by the active theme. Its use is covered elsewhere in this "
"manual ([[#h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae][Face specs at scale using "
"the themes' palette]]). As for the attributes that can be passed to each "
"face, start by consulting the documentation string of ~set-face-attribute~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3812
#, no-wrap
msgid ""
"** Note on company-mode overlay pop-up\n"
":properties:\n"
":custom_id: h:20cef8c4-d11f-4053-8b2c-2872925780b1\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3817
msgid ""
"By default, the ~company-mode~ pop-up that lists completion candidates is "
"drawn using an overlay. This creates alignment issues every time it is "
"placed above a piece of text that has a different height than the default."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3823
msgid ""
"The solution recommended by the project's maintainer is to use an "
"alternative front-end for drawing the pop-up which draws child frames "
"instead of overlays.[fn:: "
"https://github.com/company-mode/company-mode/issues/1010][fn:: "
"https://github.com/tumashu/company-posframe/]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3828
#, no-wrap
msgid ""
"** Note on ERC escaped color sequences\n"
":properties:\n"
":custom_id: h:98bdf319-1e32-4469-8a01-771200fba65c\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3836
msgid ""
"The built-in IRC client ~erc~ has the ability to colorise any text using "
"escape sequences that start with =^C= (inserted with {{{kbd(C-q C-c)}}}) and "
"are followed by a number for the foreground and background.[fn:: This page "
"explains the basics, though it is not specific to Emacs: "
"https://www.mirc.com/colors.html] Possible numbers are 0-15, with the first "
"entry being the foreground and the second the background, separated by a "
"comma. Like this =^C1,6=. The minimum setup is this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3842
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(add-to-list 'erc-modules 'irccontrols)\n"
"(setq erc-interpret-controls-p t\n"
" erc-interpret-mirc-color t)\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3847
msgid ""
"As this allows users the chance to make arbitrary combinations, it is "
"impossible to guarantee a consistently high contrast ratio. All we can we "
"do is provide guidance on the combinations that satisfy the accessibility "
"standard of the themes:"
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3850
#, markdown-text
msgid ""
"Modus Operandi :: Use foreground color 1 for all backgrounds from 2-15. "
"Like so: {{{kbd(C-q C-c1,N)}}} where =N= is the background."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3853
#, markdown-text
msgid ""
"Modus Vivendi :: Use foreground color 0 for all backgrounds from 2-13. Use "
"foreground =1= for backgrounds 14, 15."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3856
msgid ""
"Colors 0 and 1 are white and black respectively. So combine them together, "
"if you must."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3861
#, no-wrap
msgid ""
"** Note on powerline or spaceline\n"
":properties:\n"
":custom_id: h:9130a8ba-d8e3-41be-a58b-3cb1eb7b6d17\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3865
msgid ""
"Both Powerline and Spaceline package users will likely need to use the "
"command ~powerline-reset~ whenever they make changes to their themes and/or "
"mode line setup."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3870
#, no-wrap
msgid ""
"** Note on SHR colors\n"
":properties:\n"
":custom_id: h:4cc767dc-ffef-4c5c-9f10-82eb7b8921bf\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3874
msgid ""
"Emacs' HTML rendering library ({{{file(shr.el)}}}) may need explicit "
"configuration to respect the theme's colors instead of whatever "
"specifications the webpage provides."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3876
msgid "Consult {{{kbd(C-h v shr-use-colors)}}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3881
#, no-wrap
msgid ""
"** Note on EWW and Elfeed fonts (SHR fonts)\n"
":properties:\n"
":custom_id: h:e6c5451f-6763-4be7-8fdb-b4706a422a4c\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3888
msgid ""
"EWW and Elfeed rely on the Simple HTML Renderer to display their content. "
"The {{{file(shr.el)}}} library contains the variable ~shr-use-fonts~ that "
"controls whether the text in the buffer is set to a ~variable-pitch~ "
"typeface (proportionately spaced) or if just retains whatever the default "
"font family is. Its default value is non-nil, which means that "
"~variable-pitch~ is applied."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3895
#, no-wrap
msgid ""
"** Note on Helm grep\n"
":properties:\n"
":custom_id: h:d28879a2-8e4b-4525-986e-14c0f873d229\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3900
msgid ""
"There is one face from the Helm package that is meant to highlight the "
"matches of a grep or grep-like command (=ag= or =ripgrep=). It is "
"~helm-grep-match~. However, this face can only apply when the user does not "
"pass =--color=always= as a command-line option for their command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3904
msgid ""
"Here is the docstring for that face, which is defined in the "
"{{{file(helm-grep.el)}}} library (you can always visit the source code with "
"{{{kbd(M-x find-library)}}})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3909
msgid ""
"#+begin_quote Face used to highlight grep matches. Have no effect when grep "
"backend use \"--color=\" #+end_quote"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3915
msgid ""
"The user must either remove =--color= from the flags passed to the grep "
"function, or explicitly use =--color=never= (or equivalent). Helm provides "
"user-facing customization options for controlling the grep function's "
"parameters, such as ~helm-grep-default-command~ and "
"~helm-grep-git-grep-command~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3922
msgid ""
"When =--color=always= is in effect, the grep output will use red text in "
"bold letter forms to present the matching part in the list of candidates. "
"That style still meets the contrast ratio target of >= 7:1 (accessibility "
"standard WCAG AAA), because it draws the reference to ANSI color number 1 "
"(red) from the already-supported array of ~ansi-color-names-vector~."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3927
#, no-wrap
msgid ""
"** Note on vc-annotate-background-mode\n"
":properties:\n"
":custom_id: h:5095cbd1-e17a-419c-93e8-951c186362a3\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3931
msgid ""
"Due to the unique way ~vc-annotate~ ({{{kbd(C-x v g)}}}) applies colors, "
"support for its background mode (~vc-annotate-background-mode~) is disabled "
"at the theme level."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3936
msgid ""
"Normally, such a drastic measure should not belong in a theme: assuming the "
"user's preferences is bad practice. However, it has been deemed necessary "
"in the interest of preserving color contrast accessibility while still "
"supporting a useful built-in tool."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3940
msgid ""
"If there actually is a way to avoid such a course of action, without "
"prejudice to the accessibility standard of this project, then please report "
"as much or send patches "
"([[#h:9c3cd842-14b7-44d7-84b2-a5c8bc3fc3b1][Contributing]])."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3945
#, no-wrap
msgid ""
"** Note on pdf-tools link hints\n"
":properties:\n"
":custom_id: h:2659d13e-b1a5-416c-9a89-7c3ce3a76574\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3953
msgid ""
"Hints are drawn by [[https://imagemagick.org/][ImageMagick]], not Emacs, "
"i.e., ImageMagick doesn't know about the hint face unless you tell "
"ImageMagick about it. By default, only the foreground and background color "
"attributes are passed. The below snippet adds to those the various font "
"attributes. As it queries various faces, specifically ~pdf-links-read-link~ "
"and the faces it inherits, it needs to be added to your initialization file "
"after you've customized any faces."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3990
#, no-wrap
msgid ""
"#+begin_src emacs-lisp\n"
"(use-package pdf-links\n"
" :config\n"
" (let ((spec\n"
" (apply #'append\n"
" (mapcar\n"
" (lambda (name)\n"
" (list name\n"
" (face-attribute 'pdf-links-read-link\n"
" name nil 'default)))\n"
" '(:family :width :weight :slant)))))\n"
" (setq pdf-links-read-link-convert-commands\n"
" `(\"-density\" \"96\"\n"
" \"-family\" ,(plist-get spec :family)\n"
" \"-stretch\" ,(let* ((width (plist-get spec :width))\n"
" (name (symbol-name width)))\n"
" (replace-regexp-in-string \"-\" \"\"\n"
" (capitalize name)))\n"
" \"-weight\" ,(pcase (plist-get spec :weight)\n"
" ('ultra-light \"Thin\")\n"
" ('extra-light \"ExtraLight\")\n"
" ('light \"Light\")\n"
" ('semi-bold \"SemiBold\")\n"
" ('bold \"Bold\")\n"
" ('extra-bold \"ExtraBold\")\n"
" ('ultra-bold \"Black\")\n"
" (_weight \"Normal\"))\n"
" \"-style\" ,(pcase (plist-get spec :slant)\n"
" ('italic \"Italic\")\n"
" ('oblique \"Oblique\")\n"
" (_slant \"Normal\"))\n"
" \"-pointsize\" \"%P\"\n"
" \"-undercolor\" \"%f\"\n"
" \"-fill\" \"%b\"\n"
" \"-draw\" \"text %X,%Y '%c'\"))))\n"
"#+end_src\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3996
#, no-wrap
msgid ""
"* Frequently Asked Questions (FAQ)\n"
":properties:\n"
":custom_id: h:b3384767-30d3-4484-ba7f-081729f03a47\n"
":end:\n"
"#+cindex: Frequently Asked Questions (FAQ)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:3999
msgid ""
"In this section we provide answers related to some aspects of the Modus "
"themes' design and application."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4005
#, no-wrap
msgid ""
"** Is the contrast ratio about adjacent colors?\n"
":properties:\n"
":custom_id: h:5ce7ae2e-9348-4e55-b4cf-9302345b1826\n"
":end:\n"
"#+cindex: Contrast between adjacent colors\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4012
msgid ""
"The minimum contrast ratio in relative luminance that the themes conform "
"with always refers to any given combination of background and foreground "
"colors. If we have some blue colored text next to a magenta one, both "
"against a white background, we do not mean to imply that blue:magenta is 7:1 "
"in terms of relative luminance. Rather, we state that blue:white and "
"magenta:white each are 7:1 or higher."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4018
msgid ""
"The point of reference is always the background. Because colors have about "
"the same minimum distance in luminance from their backdrop, they necessarily "
"are fairly close to each other in this measure. A possible blue:magenta "
"combination would naturally be around 1:1 in contrast of the sort here "
"considered."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4027
msgid ""
"To differentiate between sequential colors, we rely on hueness by mapping "
"contrasting hues to adjacent constructs, while avoiding exaggerations. A "
"blue next to a magenta can be told apart regardless of their respective "
"contrast ratio against their common background. Exceptions would be tiny "
"characters in arguably not so realistic cases, such as two dots drawn "
"side-by-side which for some reason would need to be colored differently. "
"They would still be legible though, which is the primary objective of the "
"Modus themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4033
#, no-wrap
msgid ""
"** What does it mean to avoid exaggerations?\n"
":properties:\n"
":custom_id: h:44284e1f-fab8-4c4f-92f0-544728a7c91e\n"
":end:\n"
"#+cindex: Avoiding exaggerations in design\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4036
msgid ""
"The Modus themes are designed with restraint, so that their default looks do "
"not overdo it with the application of color."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4038
msgid "[[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization Options]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4048
msgid ""
"This is the non-quantifiable aspect of the themes' design: the artistic "
"part, if you will. There are a lot of cases where color can be used "
"inconsiderately, without accounting for layout, typographic, or other "
"properties of the presentation. For example, two headings with distinct "
"markers, such as leading asterisks in Org buffers, do not have to have "
"highly contrasting hues between them in order to be told apart: the added "
"element of contrast in hueness does not contribute significantly more to the "
"distinction between the headings than colors whose hues are relatively "
"closer to each other in the color space."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4060
msgid ""
"Exaggerations can be hard to anticipate or identify. Multiple shades of "
"blue and magenta in the same context may not seem optimal: one might think "
"that it would be better to use highly contrasting hues to ensure that all "
"colors stand out, such as by placing blue next to yellow, next to magenta, "
"and green. That would, however, be a case of design for its own sake; a "
"case where color is being applied without consideration of its end results "
"in the given context. Too many contrasting hues in close proximity force an "
"erratic rate to how the eye jumps from one piece of text to the next. "
"Whereas multiple shades of, say, blue and magenta can suffice to tell things "
"apart and avoid excess coloration: a harmonious rhythm."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4066
#, no-wrap
msgid ""
"** Why are colors mostly variants of blue, magenta, cyan?\n"
":properties:\n"
":custom_id: h:0b26cb47-9733-4cb1-87d9-50850cb0386e\n"
":end:\n"
"#+cindex: Innate color qualities of the palette\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4071
msgid ""
"Due to the innate properties of color, some options are better than others "
"for the accessibility purposes of the themes, the stylistic consistency "
"between ~modus-operandi~ and ~modus-vivendi~, and the avoidance of "
"exaggerations in design."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4073
msgid ""
"[[#h:44284e1f-fab8-4c4f-92f0-544728a7c91e][What does it mean to avoid "
"exaggerations?]]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4078
msgid ""
"What we describe as color is a function of three distinct channels of light: "
"red, green, blue. In hexadecimal RGB notation, a color value is read as "
"three pairs of red, green, and blue light: =#RRGGBB=. Of those three, the "
"most luminant is green, while the least luminant is blue."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4082
msgid ""
"The three basic colors represent each of the channels of light. They can be "
"intermixed to give us six colors: red and green derive yellow, green and "
"blue make cyan, red and blue turn into magenta."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4088
msgid ""
"We can test the luminance of each of those against white and black to get a "
"sense of how not all colors are equally good for accessibility (white is "
"=#ffffff=, which means that all three light channels are fully luminated, "
"while black is =#000000= meaning that no light is present (notwithstanding "
"display technology))."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4099
#, no-wrap
msgid ""
"#+begin_example\n"
"| Name | | #ffffff | #000000 |\n"
"|---------+---------+---------+---------|\n"
"| red | #ff0000 | 4.00 | 5.25 |\n"
"| yellow | #ffff00 | 1.07 | 19.56 |\n"
"| green | #00ff00 | 1.37 | 15.30 |\n"
"| cyan | #00ffff | 1.25 | 16.75 |\n"
"| blue | #0000ff | 8.59 | 2.44 |\n"
"| magenta | #ff00ff | 3.14 | 6.70 |\n"
"#+end_example\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4101
msgid "[[#h:02e25930-e71a-493d-828a-8907fc80f874][Measure color contrast]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4105
msgid ""
"By reading this table we learn that every color that has a high level of "
"green light (green, yellow, cyan) is virtually unreadable against a white "
"background and, conversely, can be easily read against black."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4111
msgid ""
"We can then infer that red and blue, in different combinations, with green "
"acting as calibrator for luminance, will give us fairly moderate colors that "
"pass the 7:1 target. Blue with a bit of green produce appropriate variants "
"of cyan. Similarly, blue combined with some red and hints of green give us "
"suitable shades of purple."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4116
msgid ""
"Due to the need of maintaining some difference in hueness between adjacent "
"colors, it is not possible to make red, green, and yellow the primary "
"colors, because blue could not be used to control their luminance and, thus "
"the relevant space would shrink considerably."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4118
msgid ""
"[[#h:5ce7ae2e-9348-4e55-b4cf-9302345b1826][Is the contrast ratio about "
"adjacent colors?]]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4121
msgid ""
"This phenomenon is best illustrated by the following table that measures the "
"relative luminance of shades of red, yellow, magenta against white:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4129
#, no-wrap
msgid ""
"#+begin_example\n"
"| | #ffffff |\n"
"|---------+---------|\n"
"| #990000 | 8.92 |\n"
"| #995500 | 5.75 |\n"
"| #990099 | 7.46 |\n"
"#+end_example\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4137
msgid ""
"We notice that equal values of red and blue light in =#990099= (magenta "
"shade) do not lead to a considerable change in luminance compared with "
"=#990000= (red variant). Whereas less amount of green light in =#995500= "
"leads to a major drop in luminance relative to white. It follows that using "
"the green channel of light to calibrate the luminance of colors is more "
"effective than trying to do the same with either red or blue (the latter is "
"the least effective in that regard)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4142
msgid ""
"When we need to work with several colors, it is always better to have "
"sufficient manoeuvring space, especially since we cannot pick arbitrary "
"colors but only those that satisfy the accessibility objectives of the "
"themes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4151
msgid ""
"As for why we do not mostly use green, yellow, cyan for the dark theme, it "
"is because those colors are far more luminant than their counterparts on the "
"other side of the spectrum, so to ensure that they all have about the same "
"contrast ratios we would have to alter their hueness considerably. In "
"short, the effect would not be optimal as it would lead to exaggerations. "
"Plus, it would make ~modus-vivendi~ look completely different than "
"~modus-operandi~, to the effect that the two could not be properly "
"considered part of the same project."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4157
#, no-wrap
msgid ""
"** What is the best setup for legibility?\n"
":properties:\n"
":custom_id: h:f60cc2ae-129d-47c0-9849-4f6bbd87d8be\n"
":end:\n"
"#+cindex: General setup for readability\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4165
msgid ""
"The Modus themes can be conceptually simplified as combinations of color "
"values that account for relative luminance and inner harmony. Those "
"qualities do not guarantee that every end-user will have the same "
"experience, due to differences between people, but also because of variances "
"in hardware capabilities and configurations. For the purposes of this "
"document, we may only provide suggestions pertaining to the latter case."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4175
msgid ""
"~modus-operandi~ is best used outdoors or in a room that either gets direct "
"sunlight or has plenty of light. Whereas ~modus-vivendi~ works better when "
"there is not a lot of sunshine or the room has a source of light that is "
"preferably a faint and/or warm one. It is possible to use ~modus-operandi~ "
"at night and ~modus-vivendi~ during the day, though that will depend on "
"several variables, such as one's overall perception of color, the paint on "
"the walls and how that contributes to the impression of lightness in the "
"room, the sense of space within the eye's peripheral vision, hardware "
"specifications, and environmental factors."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4179
msgid ""
"In general, an additional source of light other than that of the monitor can "
"help reduce eye strain: the eyes are more relaxed when they do not have to "
"focus on one point to gather light."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4185
msgid ""
"The monitor's display settings must be accounted for. Gamma values, in "
"particular, need to be calibrated to neither amplify nor distort the "
"perception of black. Same principle for sharpness, brightness, and contrast "
"as determined by the hardware, which all have an effect on how text is read "
"on the screen."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4189
msgid ""
"There are software level methods on offer, such as the XrandR utility for "
"the X Window System (X.org), which can make gamma corrections for each of "
"the three channels of light (red, green, blue). For example:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4191
msgid ": xrandr --output LVDS1 --brightness 1.0 --gamma 0.76:0.75:0.68"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4196
msgid ""
"Typography is another variable. Some font families are blurry at small "
"point sizes. Others may have a regular weight that is lighter (thiner) "
"than that of their peers which may, under certain circumstances, cause a "
"halo effect around each glyph."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4201
msgid ""
"The gist is that legibility cannot be fully solved at the theme level. The "
"color combinations may have been optimized for accessibility, though the "
"remaining contributing factors in each case need to be considered in full."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4206
#, no-wrap
msgid ""
"* Contributing\n"
":properties:\n"
":custom_id: h:9c3cd842-14b7-44d7-84b2-a5c8bc3fc3b1\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4209
msgid ""
"This section documents the canonical sources of the themes and the ways in "
"which you can contribute to their ongoing development."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4215
#, no-wrap
msgid ""
"** Sources of the themes\n"
":properties:\n"
":custom_id: h:89504f1c-c9a1-4bd9-ab39-78fd0eddb47c\n"
":end:\n"
"#+cindex: Sources of the themes\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4217
msgid "The ~modus-operandi~ and ~modus-vivendi~ themes are built into Emacs 28."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4220
msgid ""
"The source code of the themes is "
"[[https://gitlab.com/protesilaos/modus-themes/][available on Gitlab]], for "
"the time being. A [[https://github.com/protesilaos/modus-themes/][mirror on "
"Github]] is also on offer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4223
msgid ""
"An HTML version of this manual is provided as an extension of the "
"[[https://protesilaos.com/modus-themes/][author's personal website]] (does "
"not rely on any non-free code)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4229
#, no-wrap
msgid ""
"** Issues you can help with\n"
":properties:\n"
":custom_id: h:6536c8d5-3f98-43ab-a787-b94120e735e8\n"
":end:\n"
"#+cindex: Contributing\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4231
msgid "A few tasks you can help with:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4239
msgid ""
"+ Suggest refinements to packages that are covered. + Report packages not "
"covered thus far. + Report bugs, inconsistencies, shortcomings. + Help "
"expand the documentation of covered-but-not-styled packages. + Suggest "
"refinements to the color palette. + Help expand this document or any other "
"piece of documentation. + Merge requests for code refinements."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4241
msgid ""
"[[#h:111773e2-f26f-4b68-8c4f-9794ca6b9633][Patches require copyright "
"assignment to the FSF]]."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4245
msgid ""
"It is preferable that your feedback includes some screenshots, GIFs, or "
"short videos, as well as further instructions to reproduce a given setup. "
"Though this is not a requirement."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4251
msgid ""
"Whatever you do, bear in mind the overarching objective of the Modus themes: "
"to keep a contrast ratio that is greater or equal to 7:1 between background "
"and foreground colors. If a compromise is ever necessary between aesthetics "
"and accessibility, it shall always be made in the interest of the latter."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4256
#, no-wrap
msgid ""
"** Patches require copyright assignment to the FSF\n"
":properties:\n"
":custom_id: h:111773e2-f26f-4b68-8c4f-9794ca6b9633\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4262
msgid ""
"Code contributions are most welcome. For any major edit (more than 15 "
"lines, or so, in aggregate per person), you need to make a copyright "
"assignment to the Free Software Foundation. This is necessary because the "
"themes are part of the upstream Emacs distribution: the FSF must at all "
"times be in a position to enforce the GNU General Public License."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4270
msgid ""
"Copyright assignment is a simple process. Check the request form below "
"(please adapt it accordingly). You must write an email to the address "
"mentioned in the form and then wait for the FSF to send you a legal "
"agreement. Sign the document and file it back to them. This could all "
"happen via email and take about a week. You are encouraged to go through "
"this process. You only need to do it once. It will allow you to make "
"contributions to Emacs in general."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4274
msgid ""
"#+begin_example text Please email the following information to "
"assign@gnu.org, and we will send you the assignment form for your past and "
"future changes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4277
#, no-wrap
msgid ""
"Please use your full legal name (in ASCII characters) as the subject\n"
"line of the message.\n"
"----------------------------------------------------------------------\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4279
msgid "REQUEST: SEND FORM FOR PAST AND FUTURE CHANGES"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4281
msgid "[What is the name of the program or package you're contributing to?]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4283
msgid "GNU Emacs"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4286
msgid ""
"[Did you copy any files or text written by someone else in these changes? "
"Even if that material is free software, we need to know about it.]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4290
msgid ""
"Copied a few snippets from the same files I edited. Their author, "
"Protesilaos Stavrou, has already assigned copyright to the Free Software "
"Foundation."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4293
msgid ""
"[Do you have an employer who might have a basis to claim to own your "
"changes? Do you attend a school which might make such a claim?]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4296
msgid "[For the copyright registration, what country are you a citizen of?]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4299
msgid "[What year were you born?]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4302
msgid "[Please write your email address here.]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4305
msgid "[Please write your postal address here.]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4312
msgid ""
"[Which files have you changed so far, and which new files have you written "
"so far?]"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4314
msgid "#+end_example"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4320
#, no-wrap
msgid ""
"* Acknowledgements\n"
":properties:\n"
":custom_id: h:95c3da23-217f-404e-b5f3-56c75760ebcf\n"
":end:\n"
"#+cindex: Contributors\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4322
msgid "The Modus themes are a collective effort. Every bit of work matters."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4324
msgid "+ Author/maintainer :: Protesilaos Stavrou."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4331
#, markdown-text
msgid ""
"Contributions to code or documentation :: Anders Johansson, Basil "
"L.{{{space()}}} Contovounesios, Carlo Zancanaro, Eli Zaretskii, Fritz Grabo, "
"Kévin Le Gouguec, Kostadin Ninev, Madhavan Krishnan, Markus Beppler, Matthew "
"Stevenson, Mauro Aranda, Nicolas De Jaeghere, Philip Kaludercic, Rudolf "
"Adamkovič, Stephen Gildea, Shreyas Ragavan, Stefan Kangas, Vincent Murphy, "
"Xinglu Chen."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4352
#, markdown-text
msgid ""
"Ideas and user feedback :: Aaron Jensen, Adam Porter, Adam Spiers, Adrian "
"Manea, Alex Griffin, Alex Peitsinis, Alexey Shmalko, Alok Singh, Anders "
"Johansson, André Alexandre Gomes, Arif Rezai, Basil L.{{{space()}}} "
"Contovounesios, Burgess Chang, Christian Tietze, Christopher Dimech, Damien "
"Cassou, Daniel Mendler, Dario Gjorgjevski, David Edmondson, Davor Rotim, "
"Divan Santana, Eliraz Kedmi, Emanuele Michele Alberto Monterosso, Farasha "
"Euker, Feng Shu, Gautier Ponsinet, Gerry Agbobada, Gianluca Recchia, Gustavo "
"Barros, Hörmetjan Yiltiz, Ilja Kocken, Iris Garcia, Jeremy Friesen, Jerry "
"Zhang, John Haman, Joshua O'Connor, Kevin Fleming, Kévin Le Gouguec, "
"Kostadin Ninev, Len Trigg, Manuel Uberti, Mark Burton, Markus Beppler, Mauro "
"Aranda, Michael Goldenberg, Morgan Smith, Murilo Pereira, Nicky van Foreest, "
"Nicolas De Jaeghere, Paul Poloskov, Pengji Zhang, Pete Kazmier, Peter Wu, "
"Philip Kaludercic, Pierre Téchoueyres, Roman Rudakov, Ryan Phillips, Rudolf "
"Adamkovič, Sam Kleinman, Shreyas Ragavan, Simon Pugnet, Tassilo Horn, "
"Thibaut Verron, Thomas Heartman, Trey Merkley, Togan Muftuoglu, Toon Claes, "
"Uri Sharf, Utkarsh Singh, Vincent Foley. As well as users: Ben, "
"CsBigDataHub1, Emacs Contrib, Eugene, Fourchaux, Fredrik, Moesasji, Nick, "
"TheBlob42, Trey, bepolymathe, doolio, fleimgruber, iSeeU, jixiuf, okamsn, "
"pRot0ta1p."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4357
#, markdown-text
msgid ""
"Packaging :: Basil L.{{{space()}}} Contovounesios, Eli Zaretskii, Glenn "
"Morris, Mauro Aranda, Richard Stallman, Stefan Kangas (core Emacs), Stefan "
"Monnier (GNU Elpa), André Alexandre Gomes, Dimakakos Dimos, Morgan Smith, "
"Nicolas Goaziou (Guix), Dhavan Vaidya (Debian)."
msgstr ""
#. type: Bullet: '+ '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4360
#, markdown-text
msgid ""
"Inspiration for certain features :: Bozhidar Batsov (zenburn-theme), Fabrice "
"Niessen (leuven-theme)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4364
msgid ""
"Special thanks, in no particular order, to Manuel Uberti, Gustavo Barros, "
"and Omar Antolín Camarena for their long time contributions and insightful "
"commentary."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4370
#, no-wrap
msgid ""
"* Meta\n"
":properties:\n"
":custom_id: h:13752581-4378-478c-af17-165b6e76bc1b\n"
":end:\n"
"#+cindex: Development notes\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4374
msgid ""
"If you are curious about the principles that govern the development of this "
"project read the essay "
"[[https://protesilaos.com/codelog/2020-03-17-design-modus-themes-emacs/][On "
"the design of the Modus themes]] (2020-03-17)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4378
msgid ""
"Here are some more publications for those interested in the kind of work "
"that goes into this project (sometimes the commits also include details of "
"this sort):"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4388
msgid ""
"+ "
"[[https://protesilaos.com/codelog/2020-05-10-modus-operandi-palette-review/][Modus "
"Operandi theme subtle palette review]] (2020-05-10) + "
"[[https://protesilaos.com/codelog/2020-06-13-modus-vivendi-palette-review/][Modus "
"Vivendi theme subtle palette review]] (2020-06-13) + "
"[[https://protesilaos.com/codelog/2020-07-04-modus-themes-faint-colours/][Modus "
"themes: new \"faint syntax\" option]] (2020-07-04) + "
"[[https://protesilaos.com/codelog/2020-07-08-modus-themes-nuanced-colours/][Modus "
"themes: major review of \"nuanced\" colours]] (2020-07-08) + "
"[[https://protesilaos.com/codelog/2020-09-14-modus-themes-review-blues/][Modus "
"themes: review of blue colours]] (2020-09-14) + "
"[[https://protesilaos.com/codelog/2020-12-27-modus-themes-review-rainbow-delimiters/][Modus "
"themes: review rainbow-delimiters faces]] (2020-12-27) + "
"[[https://protesilaos.com/codelog/2021-01-11-modus-themes-review-select-faint-colours/][Modus "
"themes: review of select \"faint\" colours]] (2021-01-11) + "
"[[https://protesilaos.com/codelog/2021-02-25-modus-themes-diffs-deuteranopia/][The "
"Modus themes now cover deuteranopia in diffs]] (2021-02-25) + "
"[[https://protesilaos.com/codelog/2021-06-02-modus-themes-org-agenda/][Introducing "
"the variable modus-themes-org-agenda]] (2021-06-02)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4390
msgid "And here are the canonical sources of this project's documentation:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4394
msgid ""
"+ Manual :: <https://protesilaos.com/modus-themes> + Change Log :: "
"<https://protesilaos.com/modus-themes-changelog> + Screenshots :: "
"<https://protesilaos.com/modus-themes-pictures>"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4400
#, no-wrap
msgid ""
"* GNU Free Documentation License\n"
":properties:\n"
":appendix: t\n"
":custom_id: h:3077c3d2-7f90-4228-8f0a-73124f4026f6\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4402
msgid "#+texinfo: @include doclicense.texi"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4405
msgid "#+begin_export html <pre>"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4408
#, no-wrap
msgid ""
" GNU Free Documentation License\n"
" Version 1.3, 3 November 2008\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4414
#, no-wrap
msgid ""
" Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.\n"
" <https://fsf.org/>\n"
" Everyone is permitted to copy and distribute verbatim copies\n"
" of this license document, but changing it is not allowed.\n"
msgstr ""
#. type: Bullet: '0. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4416
#, markdown-text
msgid "PREAMBLE"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4424
msgid ""
"The purpose of this License is to make a manual, textbook, or other "
"functional and useful document \"free\" in the sense of freedom: to assure "
"everyone the effective freedom to copy and redistribute it, with or without "
"modifying it, either commercially or noncommercially. Secondarily, this "
"License preserves for the author and publisher a way to get credit for their "
"work, while not being considered responsible for modifications made by "
"others."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4429
msgid ""
"This License is a kind of \"copyleft\", which means that derivative works of "
"the document must themselves be free in the same sense. It complements the "
"GNU General Public License, which is a copyleft license designed for free "
"software."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4437
msgid ""
"We have designed this License in order to use it for manuals for free "
"software, because free software needs free documentation: a free program "
"should come with manuals providing the same freedoms that the software "
"does. But this License is not limited to software manuals; it can be used "
"for any textual work, regardless of subject matter or whether it is "
"published as a printed book. We recommend this License principally for "
"works whose purpose is instruction or reference."
msgstr ""
#. type: Bullet: '1. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4440
#, markdown-text
msgid "APPLICABILITY AND DEFINITIONS"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4450
msgid ""
"This License applies to any manual or other work, in any medium, that "
"contains a notice placed by the copyright holder saying it can be "
"distributed under the terms of this License. Such a notice grants a "
"world-wide, royalty-free license, unlimited in duration, to use that work "
"under the conditions stated herein. The \"Document\", below, refers to any "
"such manual or work. Any member of the public is a licensee, and is "
"addressed as \"you\". You accept the license if you copy, modify or "
"distribute the work in a way requiring permission under copyright law."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4454
msgid ""
"A \"Modified Version\" of the Document means any work containing the "
"Document or a portion of it, either copied verbatim, or with modifications "
"and/or translated into another language."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4465
msgid ""
"A \"Secondary Section\" is a named appendix or a front-matter section of the "
"Document that deals exclusively with the relationship of the publishers or "
"authors of the Document to the Document's overall subject (or to related "
"matters) and contains nothing that could fall directly within that overall "
"subject. (Thus, if the Document is in part a textbook of mathematics, a "
"Secondary Section may not explain any mathematics.) The relationship could "
"be a matter of historical connection with the subject or with related "
"matters, or of legal, commercial, philosophical, ethical or political "
"position regarding them."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4473
msgid ""
"The \"Invariant Sections\" are certain Secondary Sections whose titles are "
"designated, as being those of Invariant Sections, in the notice that says "
"that the Document is released under this License. If a section does not fit "
"the above definition of Secondary then it is not allowed to be designated as "
"Invariant. The Document may contain zero Invariant Sections. If the "
"Document does not identify any Invariant Sections then there are none."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4478
msgid ""
"The \"Cover Texts\" are certain short passages of text that are listed, as "
"Front-Cover Texts or Back-Cover Texts, in the notice that says that the "
"Document is released under this License. A Front-Cover Text may be at most "
"5 words, and a Back-Cover Text may be at most 25 words."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4491
msgid ""
"A \"Transparent\" copy of the Document means a machine-readable copy, "
"represented in a format whose specification is available to the general "
"public, that is suitable for revising the document straightforwardly with "
"generic text editors or (for images composed of pixels) generic paint "
"programs or (for drawings) some widely available drawing editor, and that is "
"suitable for input to text formatters or for automatic translation to a "
"variety of formats suitable for input to text formatters. A copy made in an "
"otherwise Transparent file format whose markup, or absence of markup, has "
"been arranged to thwart or discourage subsequent modification by readers is "
"not Transparent. An image format is not Transparent if used for any "
"substantial amount of text. A copy that is not \"Transparent\" is called "
"\"Opaque\"."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4502
msgid ""
"Examples of suitable formats for Transparent copies include plain ASCII "
"without markup, Texinfo input format, LaTeX input format, SGML or XML using "
"a publicly available DTD, and standard-conforming simple HTML, PostScript or "
"PDF designed for human modification. Examples of transparent image formats "
"include PNG, XCF and JPG. Opaque formats include proprietary formats that "
"can be read and edited only by proprietary word processors, SGML or XML for "
"which the DTD and/or processing tools are not generally available, and the "
"machine-generated HTML, PostScript or PDF produced by some word processors "
"for output purposes only."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4509
msgid ""
"The \"Title Page\" means, for a printed book, the title page itself, plus "
"such following pages as are needed to hold, legibly, the material this "
"License requires to appear in the title page. For works in formats which do "
"not have any title page as such, \"Title Page\" means the text near the most "
"prominent appearance of the work's title, preceding the beginning of the "
"body of the text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4512
msgid ""
"The \"publisher\" means any person or entity that distributes copies of the "
"Document to the public."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4520
msgid ""
"A section \"Entitled XYZ\" means a named subunit of the Document whose title "
"either is precisely XYZ or contains XYZ in parentheses following text that "
"translates XYZ in another language. (Here XYZ stands for a specific section "
"name mentioned below, such as \"Acknowledgements\", \"Dedications\", "
"\"Endorsements\", or \"History\".) To \"Preserve the Title\" of such a "
"section when you modify the Document means that it remains a section "
"\"Entitled XYZ\" according to this definition."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4527
msgid ""
"The Document may include Warranty Disclaimers next to the notice which "
"states that this License applies to the Document. These Warranty "
"Disclaimers are considered to be included by reference in this License, but "
"only as regards disclaiming warranties: any other implication that these "
"Warranty Disclaimers may have is void and has no effect on the meaning of "
"this License."
msgstr ""
#. type: Bullet: '2. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4529
#, markdown-text
msgid "VERBATIM COPYING"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4539
msgid ""
"You may copy and distribute the Document in any medium, either commercially "
"or noncommercially, provided that this License, the copyright notices, and "
"the license notice saying this License applies to the Document are "
"reproduced in all copies, and that you add no other conditions whatsoever to "
"those of this License. You may not use technical measures to obstruct or "
"control the reading or further copying of the copies you make or "
"distribute. However, you may accept compensation in exchange for copies. "
"If you distribute a large enough number of copies you must also follow the "
"conditions in section 3."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4542
msgid ""
"You may also lend copies, under the same conditions stated above, and you "
"may publicly display copies."
msgstr ""
#. type: Bullet: '3. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4545
#, markdown-text
msgid "COPYING IN QUANTITY"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4558
msgid ""
"If you publish printed copies (or copies in media that commonly have printed "
"covers) of the Document, numbering more than 100, and the Document's license "
"notice requires Cover Texts, you must enclose the copies in covers that "
"carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the "
"front cover, and Back-Cover Texts on the back cover. Both covers must also "
"clearly and legibly identify you as the publisher of these copies. The "
"front cover must present the full title with all words of the title equally "
"prominent and visible. You may add other material on the covers in "
"addition. Copying with changes limited to the covers, as long as they "
"preserve the title of the Document and satisfy these conditions, can be "
"treated as verbatim copying in other respects."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4563
msgid ""
"If the required texts for either cover are too voluminous to fit legibly, "
"you should put the first ones listed (as many as fit reasonably) on the "
"actual cover, and continue the rest onto adjacent pages."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4576
msgid ""
"If you publish or distribute Opaque copies of the Document numbering more "
"than 100, you must either include a machine-readable Transparent copy along "
"with each Opaque copy, or state in or with each Opaque copy a "
"computer-network location from which the general network-using public has "
"access to download using public-standard network protocols a complete "
"Transparent copy of the Document, free of added material. If you use the "
"latter option, you must take reasonably prudent steps, when you begin "
"distribution of Opaque copies in quantity, to ensure that this Transparent "
"copy will remain thus accessible at the stated location until at least one "
"year after the last time you distribute an Opaque copy (directly or through "
"your agents or retailers) of that edition to the public."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4581
msgid ""
"It is requested, but not required, that you contact the authors of the "
"Document well before redistributing any large number of copies, to give them "
"a chance to provide you with an updated version of the Document."
msgstr ""
#. type: Bullet: '4. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4584
#, markdown-text
msgid "MODIFICATIONS"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4591
msgid ""
"You may copy and distribute a Modified Version of the Document under the "
"conditions of sections 2 and 3 above, provided that you release the Modified "
"Version under precisely this License, with the Modified Version filling the "
"role of the Document, thus licensing distribution and modification of the "
"Modified Version to whoever possesses a copy of it. In addition, you must "
"do these things in the Modified Version:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4639
#, no-wrap
msgid ""
"A. Use in the Title Page (and on the covers, if any) a title distinct\n"
" from that of the Document, and from those of previous versions\n"
" (which should, if there were any, be listed in the History section\n"
" of the Document). You may use the same title as a previous version\n"
" if the original publisher of that version gives permission.\n"
"B. List on the Title Page, as authors, one or more persons or entities\n"
" responsible for authorship of the modifications in the Modified\n"
" Version, together with at least five of the principal authors of the\n"
" Document (all of its principal authors, if it has fewer than five),\n"
" unless they release you from this requirement.\n"
"C. State on the Title page the name of the publisher of the\n"
" Modified Version, as the publisher.\n"
"D. Preserve all the copyright notices of the Document.\n"
"E. Add an appropriate copyright notice for your modifications\n"
" adjacent to the other copyright notices.\n"
"F. Include, immediately after the copyright notices, a license notice\n"
" giving the public permission to use the Modified Version under the\n"
" terms of this License, in the form shown in the Addendum below.\n"
"G. Preserve in that license notice the full lists of Invariant Sections\n"
" and required Cover Texts given in the Document's license notice.\n"
"H. Include an unaltered copy of this License.\n"
"I. Preserve the section Entitled \"History\", Preserve its Title, and add\n"
" to it an item stating at least the title, year, new authors, and\n"
" publisher of the Modified Version as given on the Title Page. If\n"
" there is no section Entitled \"History\" in the Document, create one\n"
" stating the title, year, authors, and publisher of the Document as\n"
" given on its Title Page, then add an item describing the Modified\n"
" Version as stated in the previous sentence.\n"
"J. Preserve the network location, if any, given in the Document for\n"
" public access to a Transparent copy of the Document, and likewise\n"
" the network locations given in the Document for previous versions\n"
" it was based on. These may be placed in the \"History\" section.\n"
" You may omit a network location for a work that was published at\n"
" least four years before the Document itself, or if the original\n"
" publisher of the version it refers to gives permission.\n"
"K. For any section Entitled \"Acknowledgements\" or \"Dedications\",\n"
" Preserve the Title of the section, and preserve in the section all\n"
" the substance and tone of each of the contributor acknowledgements\n"
" and/or dedications given therein.\n"
"L. Preserve all the Invariant Sections of the Document,\n"
" unaltered in their text and in their titles. Section numbers\n"
" or the equivalent are not considered part of the section titles.\n"
"M. Delete any section Entitled \"Endorsements\". Such a section\n"
" may not be included in the Modified Version.\n"
"N. Do not retitle any existing section to be Entitled \"Endorsements\"\n"
" or to conflict in title with any Invariant Section.\n"
"O. Preserve any Warranty Disclaimers.\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4646
msgid ""
"If the Modified Version includes new front-matter sections or appendices "
"that qualify as Secondary Sections and contain no material copied from the "
"Document, you may at your option designate some or all of these sections as "
"invariant. To do this, add their titles to the list of Invariant Sections "
"in the Modified Version's license notice. These titles must be distinct "
"from any other section titles."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4652
msgid ""
"You may add a section Entitled \"Endorsements\", provided it contains "
"nothing but endorsements of your Modified Version by various parties--for "
"example, statements of peer review or that the text has been approved by an "
"organization as the authoritative definition of a standard."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4662
msgid ""
"You may add a passage of up to five words as a Front-Cover Text, and a "
"passage of up to 25 words as a Back-Cover Text, to the end of the list of "
"Cover Texts in the Modified Version. Only one passage of Front-Cover Text "
"and one of Back-Cover Text may be added by (or through arrangements made by) "
"any one entity. If the Document already includes a cover text for the same "
"cover, previously added by you or by arrangement made by the same entity you "
"are acting on behalf of, you may not add another; but you may replace the "
"old one, on explicit permission from the previous publisher that added the "
"old one."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4666
msgid ""
"The author(s) and publisher(s) of the Document do not by this License give "
"permission to use their names for publicity for or to assert or imply "
"endorsement of any Modified Version."
msgstr ""
#. type: Bullet: '5. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4669
#, markdown-text
msgid "COMBINING DOCUMENTS"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4676
msgid ""
"You may combine the Document with other documents released under this "
"License, under the terms defined in section 4 above for modified versions, "
"provided that you include in the combination all of the Invariant Sections "
"of all of the original documents, unmodified, and list them all as Invariant "
"Sections of your combined work in its license notice, and that you preserve "
"all their Warranty Disclaimers."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4685
msgid ""
"The combined work need only contain one copy of this License, and multiple "
"identical Invariant Sections may be replaced with a single copy. If there "
"are multiple Invariant Sections with the same name but different contents, "
"make the title of each such section unique by adding at the end of it, in "
"parentheses, the name of the original author or publisher of that section if "
"known, or else a unique number. Make the same adjustment to the section "
"titles in the list of Invariant Sections in the license notice of the "
"combined work."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4691
msgid ""
"In the combination, you must combine any sections Entitled \"History\" in "
"the various original documents, forming one section Entitled \"History\"; "
"likewise combine any sections Entitled \"Acknowledgements\", and any "
"sections Entitled \"Dedications\". You must delete all sections Entitled "
"\"Endorsements\"."
msgstr ""
#. type: Bullet: '6. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4694
#, markdown-text
msgid "COLLECTIONS OF DOCUMENTS"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4701
msgid ""
"You may make a collection consisting of the Document and other documents "
"released under this License, and replace the individual copies of this "
"License in the various documents with a single copy that is included in the "
"collection, provided that you follow the rules of this License for verbatim "
"copying of each of the documents in all other respects."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4707
msgid ""
"You may extract a single document from such a collection, and distribute it "
"individually under this License, provided you insert a copy of this License "
"into the extracted document, and follow this License in all other respects "
"regarding verbatim copying of that document."
msgstr ""
#. type: Bullet: '7. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4710
#, markdown-text
msgid "AGGREGATION WITH INDEPENDENT WORKS"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4719
msgid ""
"A compilation of the Document or its derivatives with other separate and "
"independent documents or works, in or on a volume of a storage or "
"distribution medium, is called an \"aggregate\" if the copyright resulting "
"from the compilation is not used to limit the legal rights of the "
"compilation's users beyond what the individual works permit. When the "
"Document is included in an aggregate, this License does not apply to the "
"other works in the aggregate which are not themselves derivative works of "
"the Document."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4727
msgid ""
"If the Cover Text requirement of section 3 is applicable to these copies of "
"the Document, then if the Document is less than one half of the entire "
"aggregate, the Document's Cover Texts may be placed on covers that bracket "
"the Document within the aggregate, or the electronic equivalent of covers if "
"the Document is in electronic form. Otherwise they must appear on printed "
"covers that bracket the whole aggregate."
msgstr ""
#. type: Bullet: '8. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4730
#, markdown-text
msgid "TRANSLATION"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4743
msgid ""
"Translation is considered a kind of modification, so you may distribute "
"translations of the Document under the terms of section 4. Replacing "
"Invariant Sections with translations requires special permission from their "
"copyright holders, but you may include translations of some or all Invariant "
"Sections in addition to the original versions of these Invariant Sections. "
"You may include a translation of this License, and all the license notices "
"in the Document, and any Warranty Disclaimers, provided that you also "
"include the original English version of this License and the original "
"versions of those notices and disclaimers. In case of a disagreement "
"between the translation and the original version of this License or a notice "
"or disclaimer, the original version will prevail."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4748
msgid ""
"If a section in the Document is Entitled \"Acknowledgements\", "
"\"Dedications\", or \"History\", the requirement (section 4) to Preserve its "
"Title (section 1) will typically require changing the actual title."
msgstr ""
#. type: Bullet: '9. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4751
#, markdown-text
msgid "TERMINATION"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4756
msgid ""
"You may not copy, modify, sublicense, or distribute the Document except as "
"expressly provided under this License. Any attempt otherwise to copy, "
"modify, sublicense, or distribute it is void, and will automatically "
"terminate your rights under this License."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4763
msgid ""
"However, if you cease all violation of this License, then your license from "
"a particular copyright holder is reinstated (a) provisionally, unless and "
"until the copyright holder explicitly and finally terminates your license, "
"and (b) permanently, if the copyright holder fails to notify you of the "
"violation by some reasonable means prior to 60 days after the cessation."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4770
msgid ""
"Moreover, your license from a particular copyright holder is reinstated "
"permanently if the copyright holder notifies you of the violation by some "
"reasonable means, this is the first time you have received notice of "
"violation of this License (for any work) from that copyright holder, and you "
"cure the violation prior to 30 days after your receipt of the notice."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4776
msgid ""
"Termination of your rights under this section does not terminate the "
"licenses of parties who have received copies or rights from you under this "
"License. If your rights have been terminated and not permanently "
"reinstated, receipt of a copy of some or all of the same material does not "
"give you any rights to use it."
msgstr ""
#. type: Bullet: '10. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4779
#, markdown-text
msgid "FUTURE REVISIONS OF THIS LICENSE"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4785
msgid ""
"The Free Software Foundation may publish new, revised versions of the GNU "
"Free Documentation License from time to time. Such new versions will be "
"similar in spirit to the present version, but may differ in detail to "
"address new problems or concerns. See https://www.gnu.org/licenses/."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4798
msgid ""
"Each version of the License is given a distinguishing version number. If "
"the Document specifies that a particular numbered version of this License "
"\"or any later version\" applies to it, you have the option of following the "
"terms and conditions either of that specified version or of any later "
"version that has been published (not as a draft) by the Free Software "
"Foundation. If the Document does not specify a version number of this "
"License, you may choose any version ever published (not as a draft) by the "
"Free Software Foundation. If the Document specifies that a proxy can decide "
"which future versions of this License can be used, that proxy's public "
"statement of acceptance of a version permanently authorizes you to choose "
"that version for the Document."
msgstr ""
#. type: Bullet: '11. '
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4800
#, markdown-text
msgid "RELICENSING"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4807
msgid ""
"\"Massive Multiauthor Collaboration Site\" (or \"MMC Site\") means any World "
"Wide Web server that publishes copyrightable works and also provides "
"prominent facilities for anybody to edit those works. A public wiki that "
"anybody can edit is an example of such a server. A \"Massive Multiauthor "
"Collaboration\" (or \"MMC\") contained in the site means any set of "
"copyrightable works thus published on the MMC site."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4813
msgid ""
"\"CC-BY-SA\" means the Creative Commons Attribution-Share Alike 3.0 license "
"published by Creative Commons Corporation, a not-for-profit corporation with "
"a principal place of business in San Francisco, California, as well as "
"future copyleft versions of that license published by that same "
"organization."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4816
msgid ""
"\"Incorporate\" means to publish or republish a Document, in whole or in "
"part, as part of another Document."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4822
msgid ""
"An MMC is \"eligible for relicensing\" if it is licensed under this License, "
"and if all works that were first published under this License somewhere "
"other than this MMC, and subsequently incorporated in whole or in part into "
"the MMC, (1) had no cover texts or invariant sections, and (2) were thus "
"incorporated prior to November 1, 2008."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4826
msgid ""
"The operator of an MMC Site may republish an MMC contained in the site under "
"CC-BY-SA on the same site at any time before August 1, 2009, provided the "
"MMC is eligible for relicensing."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4829
msgid "ADDENDUM: How to use this License for your documents"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4833
msgid ""
"To use this License in a document you have written, include a copy of the "
"License in the document and put the following copyright and license notices "
"just after the title page:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4841
#, no-wrap
msgid ""
" Copyright (c) YEAR YOUR NAME.\n"
" Permission is granted to copy, distribute and/or modify this document\n"
" under the terms of the GNU Free Documentation License, Version 1.3\n"
" or any later version published by the Free Software Foundation;\n"
" with no Invariant Sections, no Front-Cover Texts, and no Back-Cover "
"Texts.\n"
" A copy of the license is included in the section entitled \"GNU\n"
" Free Documentation License\".\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4844
msgid ""
"If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, "
"replace the \"with...Texts.\" line with this:"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4847
#, no-wrap
msgid ""
" with the Invariant Sections being LIST THEIR TITLES, with the\n"
" Front-Cover Texts being LIST, and with the Back-Cover Texts being "
"LIST.\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4851
msgid ""
"If you have Invariant Sections without Cover Texts, or some other "
"combination of the three, merge those two alternatives to suit the "
"situation."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4858
msgid ""
"If your document contains nontrivial examples of program code, we recommend "
"releasing these examples in parallel under your choice of free software "
"license, such as the GNU General Public License, to permit their use in free "
"software. </pre> #+end_export"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4860
msgid "#+html: <!--"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4865
#, no-wrap
msgid ""
"* Indices\n"
":properties:\n"
":custom_id: h:55104b26-8e94-46cf-9975-43ea00316489\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4871
#, no-wrap
msgid ""
"** Function index\n"
":properties:\n"
":index: fn\n"
":custom_id: h:6bec5005-529c-4521-ae05-3d990baffb5b\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4877
#, no-wrap
msgid ""
"** Variable index\n"
":properties:\n"
":index: vr\n"
":custom_id: h:16ad8df6-b015-40a9-9259-03d4f7a23ee4\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4883
#, no-wrap
msgid ""
"** Concept index\n"
":properties:\n"
":index: cp\n"
":custom_id: h:6aa7a656-884b-4c39-b759-087e412eec13\n"
":end:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/modus-themes.org:4884
msgid "#+html: -->"
msgstr ""