moe-theme
- Description
- A colorful eye-candy theme. Moe, moe, kyun!
- Latest
- moe-theme-1.0.2.0.20240716.85432.tar (.sig), 2024-Jul-16, 210 KiB
- Maintainer
- kuanyui <azazabc123@gmail.com>
- Website
- https://github.com/kuanyui/moe-theme.el
- Browse ELPA's repository
- CGit or Gitweb
- Badge
To install this package from Emacs, use package-install
or list-packages
.
Full description
1. moe-theme
<a href=""><img src="" width="720" height="401"/></a>
1.1. Screenshot
<a href=""><img src="pics/dark01.png" width="355" height="192"/></a> <a href=""><img src="pics/light01.png" width="355" height="192"/></a> <a href=""><img src="pics/dark02.png" width="355" height="192"/></a> <a href=""><img src="pics/light02.png" width="355" height="192"/></a> <a href=""><img src="pics/dark03.png" width="355" height="192"/></a> <a href=""><img src="pics/light03.png" width="355" height="192"/></a> <a href=""><img src="pics/dark04.png" width="355" height="192"/></a> <a href=""><img src="pics/light04.png" width="355" height="192"/></a> <a href=""><img src="pics/dark05.png" width="355" height="192"/></a> <a href=""><img src="pics/light05.png" width="355" height="192"/></a> <a href=""><img src="pics/mode-line-preview.png" width="710" height="182"/></a>
1.2. What Special?
Most basic:
- Optimized for terminal's 256 color palettes.
- Dark & Light
And more:
- Carefully-considered & reasonable colors
- Delightful & good-looking color palettes™
- Customizable
- Optional
Monokai
/Tomorrow
for syntax-highlighting (or totally customize by yourself) - Mode-line / Powerline color
- Titles font sizes for .
- Optional
- Fully-supported for each modes:
- Diff / EDiff
- Dired / Dired+
- ERC / rcirc
- Eshell / Ansi-term
- Gnus / Message
- Helm / ido
- Org-mode / Agenda / calfw
- Magit / Git-commit / Git-gutter
- Markdown-mode / ReStructText-mode
- Auto-complete-mode / Company
- Rainbow-delimiters
- Swoop
- Twittering-mode
- undo-tree / Neotree
- Ruby / Haskell / CPerl / Tuareg / Web-mode
- ……etc
1.3. Requirements
- Emacs 25.3 or above.
- 256-colors (or higher) terminal.
1.4. Download
1.4.1. Via package.el
Moe-theme
is available in MELPA repository now, so you can install moe-theme
easily with M-x
list-packages
.
1.4.2. Manually
Download the archive of moe-theme
(or git clone
it) to ~/.emacs.d/moe-theme.el
and extract it. Then, add these to your init file:
;;customize theme (add-to-list 'custom-theme-load-path "~/.emacs.d/moe-theme.el/") (add-to-list 'load-path "~/.emacs.d/moe-theme.el/") (require 'moe-theme)
1.5. Customizations
It's impossible to satisfy everyone with one fixed theme, but
moe-theme
provide some easy ways to customize itself.
There's a full customization example:
;; If you want to use powerline, (require 'powerline) must be ;; before (require 'moe-theme). (add-to-list 'load-path "~/.emacs.d/PATH/TO/powerline/") (require 'powerline) ;; Moe-theme (add-to-list 'custom-theme-load-path "~/.emacs.d/PATH/TO/moe-theme/") (add-to-list 'load-path "~/.emacs.d/PATH/TO/moe-theme/") (require 'moe-theme) ;; Show highlighted buffer-id as decoration. (Default: nil) (setq moe-theme-highlight-buffer-id t) ;; Resize titles (optional). (setq moe-theme-resize-title-markdown '(1.5 1.4 1.3 1.2 1.0 1.0)) (setq moe-theme-resize-title-org '(1.5 1.4 1.3 1.2 1.1 1.0 1.0 1.0 1.0)) (setq moe-theme-resize-title-rst '(1.5 1.4 1.3 1.2 1.1 1.0)) ;; Choose a color for modeline.(Default: blue) (setq moe-theme-modeline-color 'cyan) ;; Finally, apply moe-theme now. ;; Choose what you like, (moe-light) or (moe-dark) (moe-light)
If you have any question about settings, go on and read following README to get more detailed information first.
** Note
*Notice that the file
moe-theme.el
is NOT a theme file, but it provide the ability for customizationmoe-dark-theme
&moe-light-theme
.*So, if you just want to use
load-theme
to apply ONLYmoe-theme
itself and without customizations, you can skip "Customizations" chapter and just use this:(add-to-list 'custom-theme-load-path "~/.emacs.d/PATH/TO/moe-theme/") (load-theme 'moe-dark t) ;;or (load-theme 'moe-light t)
1.5.1. Resize Titles
You may want to resize titles in markdown-mode
, org-mode
, or
ReStructuredText-mode
:
;; Resize titles (setq moe-theme-resize-title-markdown '(2.0 1.7 1.5 1.3 1.0 1.0)) (setq moe-theme-resize-title-org '(2.2 1.8 1.6 1.4 1.2 1.0 1.0 1.0 1.0)) (setq moe-theme-resize-title-rst '(2.0 1.7 1.5 1.3 1.1 1.0))
Markdown should have 6 items; org has 9 items; rst has 6 items.
Make sure that these resizing settings should be placed before
(moe-dark)
or(moe-light)
.
The values should be lists. Larger the values, larger the fonts. If you don't like this, just leave them nil, and all the titles will be the same size.
1.5.2. Change Color of Mode-line (or Powerline)
(setq moe-theme-modeline-color 'orange) ;; (Available colors: blue, orange, green ,magenta, yellow, purple, red, cyan, w/b.)
You can also use M-x
moe-theme-modeline-select-color
to change color interactively.
Or M-x
moe-theme-modeline-random-color
to have a good luck.
- Powerline support
Now
moe-theme
supports Powerline. Runpowerline-moe-theme
ifpowerline
installed.(powerline-moe-theme)
1.6. Frenquently Asked Problems
1.6.1. No 256-Color Output?
If your terminal emulator doesn't render 256-color output correctly, set its environment variable TERM
to xterm-256color
. For example:
If you are using
bash
orzsh
, add following line into your~/.bashrc
or~/.zshrc
:export TERM=xterm-256color
Or if you are using
Konsole
, navigate toEdit Current Profile General > Environment > Edit
and add the following line:TERM=xterm-256color
If you're using
tmux
and it cannot display in 256-color correctly, add this to~/.tmux.conf
, too:set -g default-terminal "screen-256color"
1.6.2. Parenthesis Is Hard To Read?
I recommend set the value of show-paren-style
to expression
for better visual experience:
(show-paren-mode t) (setq show-paren-style 'expression)
1.7. Known Issues
- If you add
(moe-dark)
or(moe-light)
to your init file, the color ofbuffer-id
would be incorrect after startuping CLI Emacs(but if youM-x moe-dark/light
again, it would be corrected immediately). I don't know why, but this issue doesn't occur in GUI version Emacs. (Tested on GNU Emacs 24.3.90.1 2014-04-11) - When using
moe-light
and typing characters under terminal emulator (e.g. Konsole) with IM (e.g. fcitx), the string embedded in Emacs may be very insignificant (But as you output the word from IM, it turns normal).
1.8. License
moe-theme.el
(include images) is released under GPL v3.
Old versions
moe-theme-1.0.2.0.20240430.160157.tar.lz | 2024-Apr-30 | 21.9 KiB |
moe-theme-1.0.2.0.20240417.111131.tar.lz | 2024-Apr-18 | 21.9 KiB |
moe-theme-1.0.2.0.20240308.92126.tar.lz | 2024-Mar-31 | 21.7 KiB |
moe-theme-1.0.2.0.20231006.63925.tar.lz | 2023-Oct-06 | 21.7 KiB |
moe-theme-1.0.2.0.20230818.55411.tar.lz | 2023-Aug-18 | 21.6 KiB |
moe-theme-1.0.2.0.20230518.110840.tar.lz | 2023-May-18 | 21.6 KiB |
moe-theme-1.0.2.0.20230110.42214.tar.lz | 2023-Jan-10 | 22.2 KiB |
moe-theme-1.0.2.0.20221230.103943.tar.lz | 2022-Dec-30 | 22.1 KiB |
moe-theme-1.0.2.0.20221107.25531.tar.lz | 2022-Nov-07 | 22.2 KiB |
moe-theme-1.0.2.0.20220707.111013.tar.lz | 2022-Jul-07 | 22.2 KiB |