Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fniessen/emacs-leuven-theme

This Emacs theme reduces eye strain with a light, high-contrast color scheme, syntax highlighting, and support for multiple modes. Enhance your coding experience! #emacs #theme #coding #orgmode
https://github.com/fniessen/emacs-leuven-theme

Last synced: 3 days ago
JSON representation

This Emacs theme reduces eye strain with a light, high-contrast color scheme, syntax highlighting, and support for multiple modes. Enhance your coding experience! #emacs #theme #coding #orgmode

Host: GitHub
URL: https://github.com/fniessen/emacs-leuven-theme
Owner: fniessen
License: gpl-3.0
Created: 2012-12-03T20:15:22.000Z (almost 12 years ago)
Default Branch: master
Last Pushed: 2024-07-13T09:30:31.000Z (4 months ago)
Last Synced: 2024-08-02T13:21:17.057Z (3 months ago)
Language: Emacs Lisp
Homepage:
Size: 3.68 MB
Stars: 679
Watchers: 20
Forks: 58
Open Issues: 4
Metadata Files:
- Readme: README.org
- License: LICENSE.org

Awesome Lists containing this project

README

#+TITLE: Leuven-theme
#+AUTHOR: Fabrice Niessen
#+EMAIL: (concat "fniessen" at-sign "pirilampo.org")
#+DESCRIPTION: A modern light theme for Emacs, optimized for extended coding sessions
#+KEYWORDS: Emacs, color theme, syntax highlighting, coding
#+LANGUAGE: en

#+SETUPFILE: ~/org/theme-readtheorg.setup

#+PROPERTY: header-args :eval no

[[http://opensource.org/licenses/GPL-3.0][http://img.shields.io/:license-gpl-blue.svg]]
[[http://melpa.org/#/leuven-theme][http://melpa.org/packages/leuven-theme-badge.svg]]
[[https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VCVAS6KPDQ4JC&lc=BE&item_number=emacs%2dleuven%2dtheme&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted][https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif]]

Searching for an outstanding Emacs color theme? Want one of the best light
themes for Org mode and other modes? You’ve come to the right place!

Welcome to the custom Leuven theme -- an elegant and widely loved color theme
designed for light backgrounds. It features built-in styles for various
components, including Org mode, Gnus, Dired+, and EDiff. Make it yours!

#+begin_html

Tweet
#+end_html

#+begin_quote
[!TIP]

*** Elevate your Emacs skills in Paris, Utrecht, Leuven or Valencia!
*Unlock the power of Emacs! Join my next exclusive "Emacs Boost" course!*

Ready to /supercharge your productivity/ and become an Emacs ninja? Look no
further!

*What you'll learn:*
- Master Emacs from the basics to advanced tricks.
- /Boost your editing efficiency/ and streamline your workflow.
- Customize Emacs to fit your unique needs.
- And much more!

*Audience:*

Open to anyone interested in Emacs, from beginners to advanced
users.

*Why choose my course?*
- Expert instructor with 25 years of Emacs experience.
- /Hands-on exercises/ to reinforce your learning.
- /Networking opportunities/ with like-minded Emacs enthusiasts.
- Personalized attention.

Don't miss this opportunity to take your Emacs skills to the next level! \\

Visit https://emacsboost.com/en/ for more information, dates and locations, and
to /reserve your seat/.
#+end_quote

* Screenshots

** Org buffer (with code)

Fontified source code blocks:

#+ATTR_HTML: :width 640
[[./images/fontified-src-code-blocks.png]]

Note that, to get the whole heading lines fontified, you need to add the
following line into your =.emacs= file:

#+begin_src emacs-lisp
;; Fontify the whole line for headings (with a background color).
(setq org-fontify-whole-heading-line t)
#+end_src

** Agenda

Agenda with task list:

#+ATTR_HTML: :width 640
[[./images/agenda-and-task-list.png]]

** Quotations

"Your Org-enhancing color-theme "leuven" ROCKS! ... and not just for Org." \\
-- /Johan S./

"Amazing theme. I've been switching themes like socks the past 3 years and
finally found a theme that fits me exactly." \\
-- /zeltak/

"The Leuven theme has quickly become my favorite -- the colors are great and the
visual details for Org mode are just wonderful." \\
-- /Steve B./

"I'm using leuven theme, which is a great theme for Org-mode. [...] I cannot
use another emacs-theme." \\
-- /Joseph Vidal-Rosset/

"Leuven theme is awesome!" \\
-- /Joost Diepenmaat/

"I still am really enjoying using the theme -- wish I'd had it years back..." \\
-- /V./

"I've been using leuven-theme, which is a fantastic theme for Org-mode files." \\
-- /thnetos/

"I love leuven for it's magit faces. E.g. the different sections of the magit
status screen stand out much better with leuven than with any other theme I've
tried. It's a good looking theme but what makes it stand out is the attention
the author has put into all of the different faces you find everywhere." \\
-- /UnwashedMeme/

** NEW! Dark version

There is now a dark version of Leuven-theme, automagically built by Thibault
Polge.

#+ATTR_HTML: :width 640
[[./images/leuven-theme-dark.png]]

It surely will be improved over time, but this is a major first step into the
right direction. A big thanks to him!

* Install it

Though Leuven-theme has been added in *Emacs 24.4* (October 2014), you can get
a fresh version of it, at any time, from [[http://melpa.milkbox.net/][MELPA]] or from [[https://github.com/fniessen/emacs-leuven-theme/][GitHub]].

** Install the ELPA package

In Emacs 24+, ~M-x list-packages~ is the /recommended way/ to list and install
packages.

MELPA keeps stable releases of Leuven theme.

See http://melpa.milkbox.net/#installing for more information on how to install
~leuven-theme~:

1. Just add MELPA to ~package-archives~,

#+begin_src emacs-lisp
;; Archives from which to fetch.
(setq package-archives
(append '(("melpa" . "http://melpa.milkbox.net/packages/"))
package-archives))
#+end_src

2. Call ~list-packages~,

3. Search for ~leuven-theme~,

4. Mark it for installation with ~i~, and

5. Execute the install action with ~x~.

** Install the Git version

Get the full Git repository at https://github.com/fniessen/emacs-leuven-theme
using the following command:

#+begin_src shell
git clone https://github.com/fniessen/emacs-leuven-theme
#+end_src

Add the following in your =.emacs= file:

#+begin_src emacs-lisp
(add-to-list 'custom-theme-load-path "/PATH/TO/EMACS-LEUVEN-THEME/lisp")
(load-theme 'leuven t) ; For Emacs 24+.
#+end_src

Restart Emacs.

** Dark-theme

To load the dark theme, add the following to your =.emacs= file:

#+begin_src emacs-lisp
(load-theme 'leuven-dark t)
#+end_src

To use the dark theme with [[https://github.com/jwiegley/use-package][use-package]], use the following:

#+begin_src emacs-lisp
(use-package leuven-theme
:config
(load-theme 'leuven-dark t))
#+end_src

Restart Emacs.

** Customize it

You don't like my large Org level-1 headings or my large Org agenda-date heading
(though I made them larger on purpose!)?

Then, set the variable ~leuven-scale-outline-headlines~ to ~nil~ before the theme is
loaded.

#+begin_src emacs-lisp
(setq leuven-scale-outline-headlines nil)
;; For dark theme:
(setq leuven-dark-scale-outline-headlines nil)
#+end_src

Other settings you might want to consider:

#+begin_src emacs-lisp
(setq leuven-scale-org-agenda-structure nil)
(setq leuven-scale-org-document-title nil)
(setq leuven-scale-volatile-highlight nil)
;; For dark theme:
(setq leuven-dark-scale-org-agenda-structure nil)
(setq leuven-dark-scale-org-document-title nil)
(setq leuven-dark-scale-volatile-highlight nil)
#+end_src

The value can be:
- ~nil~ for unscaled,
- ~t~ for using the theme default, or
- a scaling number (that you choose to your liking!).

One way to do that is to it through ~M-x customize-variable~ and then restart
Emacs.

* Contributing

** Issues

Report issues and suggest features and improvements on the [[https://github.com/fniessen/emacs-leuven-theme/issues/new][GitHub issue tracker]].

** Patches

I love contributions! Patches under any form are always welcome!

** Donations

If you use the emacs-leuven-theme project and feel it is making your life better
and easier, you can show your appreciation and help support future development
by making a [[https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VCVAS6KPDQ4JC&lc=BE&item_number=emacs%2dleuven%2dtheme&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted][donation]] through PayPal. Thank you!

Regardless of the donations, emacs-leuven-theme will always be free both as in
beer and as in speech.

* License

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see http://www.gnu.org/licenses/.