mirror of
https://github.com/ryuslash/mode-icons.git
synced 2024-11-23 10:10:28 +01:00
110 lines
4.6 KiB
Org Mode
110 lines
4.6 KiB
Org Mode
#+TITLE: mode-icons
|
|
#+DATE: Monday, Dec 21 2015
|
|
#+STARTUP: content
|
|
|
|
Show icons instead of mode names in emacs.
|
|
|
|
[[https://raw.githubusercontent.com/rhoit/mode-icons/dump/screenshots/screenshot01.png]]
|
|
|
|
Some of the modes that have icons instead of names now:
|
|
|
|
| Modes | icon |
|
|
|------------+--------------------------------------------------------------------------|
|
|
| Coffee | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/coffee.png]] |
|
|
| CSS | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/css.png]] |
|
|
| Emacs-Lisp | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/emacs.png]] |
|
|
| Haml | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/haml.png]] |
|
|
| HTML | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/html.png]] |
|
|
| JS | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/js.png]] |
|
|
| Lisp | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/cl.png]] |
|
|
| Org-mode | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/org.png]] |
|
|
| PHP | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/php.png]] |
|
|
| Python | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/python.png]] |
|
|
| Ruby | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/ruby.png]] |
|
|
| SVG | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/svg.png]] |
|
|
| Sass | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/sass.png]] |
|
|
| Scheme | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/scheme.png]] |
|
|
| Shell | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/bash.png]] |
|
|
| Slim | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/slim.png]] |
|
|
| YAML | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/yaml.png]] |
|
|
|
|
* Requirements
|
|
|
|
As of version 0.3.0 you can also use icons from some icon fonts,
|
|
specifically:
|
|
|
|
- [[http://fontawesome.io/][Font Awesome]]
|
|
- [[https://octicons.github.com/][GitHub Octicons]]
|
|
- [[http://fizzed.com/oss/font-mfizz][Font Mfizz]]
|
|
- [[https://icomoon.io/#icons-icomoon][IcoMoon]]
|
|
|
|
The icons look the best if you have the fonts installed on your
|
|
system and mode-icons will not do this for you.
|
|
|
|
* Installation
|
|
** Manually
|
|
|
|
Place ~mode-icons.el~ somewhere in your =load-path= and copy the
|
|
~icons/~ directory there as well. Then =require= ~mode-icons~ in your
|
|
[[http://gnu.org/software/emacs][Emacs]] init file.
|
|
|
|
* Usage
|
|
Once installed you can add =(mode-icons-mode)= to your init file.
|
|
** Ignoring mode-icons in other buffers
|
|
When looking at buffers with commands like ~ibuffer~, they display the
|
|
icons for the mode names as well. If you don't like this behavior you
|
|
can change ~mode-icons-change-mode-name~ to be nil:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq mode-icons-change-mode-name nil)
|
|
#+END_SRC
|
|
|
|
** Changing how mode-icons recolors images
|
|
Additionally, if the image icon was an ~xpm~ icon, then you can have
|
|
it changed to match your mode-line face. In the example below, the
|
|
inactive mode-line shows the emacs and yasnippet icon changed to match
|
|
the inactive mode-line:
|
|
|
|
[[http://i.imgur.com/QOM9wYM.png]]
|
|
|
|
This also will match whatever color-theme you have installed. For
|
|
example, if you use the popular cyberpunk theme, you would see the
|
|
icons colored to match the color-theme
|
|
|
|
[[http://i.imgur.com/qV6ncIb.png]]
|
|
|
|
This is enabled by default, and can be disabled by:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq mode-icons-desaturate-inactive nil)
|
|
#+END_SRC
|
|
|
|
You can also change the icon to match the active mode line (disabled by default):
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq mode-icons-desaturate-active t)
|
|
#+END_SRC
|
|
|
|
Some of the black and white images are tagged as black and white and
|
|
are automatically recolored to match the mode-line face. You can turn this off
|
|
and use the black and white image by setting:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq mode-icons-grayscale-transform nil)
|
|
#+END_SRC
|
|
** Creating xpm images from fonts
|
|
To create/recreate all the xpm images for the font images, you can
|
|
run =M-x mode-icons--convert-all-font-icons-to-xpm=.
|
|
|
|
This requires a working =gimp= installation, and all the fonts for the
|
|
icons installed. This will start an inferior scheme process for
|
|
=gimp= in =*mode-icons-gimp*= and convert all the images to xpm files.
|
|
|
|
After the images are created, you can stop the =gimp= process by
|
|
typing:
|
|
|
|
=M-x mode-icons--stop-gimp-inferior=
|
|
|
|
This should be stopped evetually if there is no input received to gimp.
|
|
|
|
|