aboutsummaryrefslogtreecommitdiff
path: root/README.org
blob: 23e34615d18ec52c3cbca6077fcf99bb711024ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
* Soria

Soria is a color theme which mixes:

- [[http://www.vim.org/scripts/script.php?script_id=2140][xoria256]]: a color theme by Dmitry Zotikov, originally for Vim. I did not do
  the initial porting from Vim to Emacs, I took it from [[https://github.com/suxue/xoria256-emacs][suxue]].
- openSUSE: I took some colors from [[http://opensuse.github.io/branding-guidelines/][openSUSE's Brand Guidelines]].

In the =soria-theme.el= file I list further acknowledgements. To install it,
just drop the =soria-theme.el= file into your =~/.emacs.d= and load it with
=load-theme=.

** Screenshots

I've saved some screenshots in the =screenshots= directory. They do not show a
full sample of all the defined colors, but it will give you a good idea of the
look and feel of this theme.

** Configuration

This color theme defines the =soria= group, which in turn has only one
configuration option:

- =soria-hide-helm-header=: the Helm package in combination with Projectile
  shows a header that in my humble opinion is quite useless and it's
  distracting. For this reason, this header is hidden by default. If you set
  it to false, then you'll see the header with the same colors as the status
  line.

Moreover, this theme also provides one function that can be used as a hook:
=soria-purple-identifiers=. As a reminder, this color theme is a port from Vim,
and Vim and Emacs have some different takes on function identifiers. As such,
the original Vim theme defines identifiers as purple, but only method
definitions in Ruby, Perl and PHP (languages that I've used with these theme,
there might be more) were highlighted this way, but that wasn't the case for C,
C++ or Go. This is certainly a bug in Vim, but I got used to it, and when doing
this port I could notice this a lot. For this reason, by default this color
theme for Emacs defines function identifiers as white, but it provides this
function so in other languages can be drawn in purple.

** License

#+BEGIN_SRC text
Copyright (C) 2016-2017 Miquel Sabaté Solà <mikisabate@gmail.com>

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/>.
#+END_SRC