solarized-emacs

a fork of Bozhidar Batsov's solarized-emacs
git clone https://git.trogloxene.org/solarized-emacs.git
Log | Files | Refs | README

UPGRADE-GUIDE.md (2653B)

      1 # solarized theme upgrade guide
      2 
      3 This upgrade guide is meant as a way for people who don't read emacs lisp to
      4 adapt to structural changes with minimal effort.
      5 
      6 ## 2019-11-17 - child theme usage
      7 
      8 This is an example of how to adapt derived child themes to the changes:
      9 
     10 ### before
     11 
     12 **my-solarized.el**
     13 
     14 ```el
     15 (require 'solarized)
     16 
     17 (defun my-solarized-theme ()
     18   "My personal solarized theme customization."
     19 
     20   (custom-theme-set-faces
     21    theme-name
     22    `(rainbow-delimiters-depth-1-face ((,class (:foreground ,base02)))))
     23 
     24   (custom-theme-set-variables
     25    theme-name
     26    `(org-todo-keyword-faces
     27      (quote (("TODO" :foreground ,cyan :weight bold :slant italic :underline nil))))))
     28 
     29 (provide 'my-solarized)
     30 ```
     31 
     32 **themes/my-solarized-light-theme.el**
     33 ```el
     34 (require 'solarized)
     35 (require 'my-solarized)
     36 
     37 (deftheme my-solarized-light "The light variant of the Solarized colour theme")
     38 (create-solarized-theme 'light 'my-solarized-light 'my-solarized-theme)
     39 
     40 (provide-theme 'my-solarized-light)
     41 ```
     42 
     43 **themes/my-solarized-dark-theme.el**
     44 ```el
     45 (require 'solarized)
     46 (require 'my-solarized)
     47 
     48 (deftheme my-solarized-dark "The dark variant of the Solarized colour theme")
     49 (create-solarized-theme 'dark 'my-solarized-dark 'my-solarized-theme)
     50 
     51 (provide-theme 'my-solarized-dark)
     52 ```
     53 
     54 
     55 ### after
     56 
     57 **my-solarized.el**
     58 ```el
     59 (require 'solarized)
     60 
     61 (setq my-solarized-faces
     62       '("My personal solarized theme customization."
     63         (custom-theme-set-faces
     64          theme-name
     65          `(rainbow-delimiters-depth-1-face ((,class (:foreground ,base02)))))
     66         (custom-theme-set-variables
     67          theme-name
     68          `(org-todo-keyword-faces
     69            (quote (("TODO" :foreground ,cyan :weight bold :slant italic :underline nil)))))))
     70 
     71 (provide 'my-solarized)
     72 
     73 ```
     74 
     75 
     76 **themes/my-solarized-light-theme.el**
     77 
     78 ```el
     79 (require 'solarized)
     80 (require 'my-solarized)
     81 (eval-when-compile
     82   (require 'solarized-palettes))
     83 
     84 ;; This file needs to be placed inside the custom-theme-load-path list
     85 
     86 (deftheme my-solarized-light "The light variant of the Solarized colour theme")
     87 (solarized-with-color-variables
     88   'light 'my-solarized-light solarized-light-color-palette-alist my-solarized-faces)
     89 
     90 (provide-theme 'my-solarized-light)
     91 
     92 ```
     93 
     94 **my-solarized-dark-theme.el**
     95 
     96 ```el
     97 (require 'solarized)
     98 (require 'my-solarized)
     99 (eval-when-compile
    100   (require 'solarized-palettes))
    101 
    102 ;; This file needs to be placed inside the custom-theme-load-path list
    103 
    104 (deftheme my-solarized-dark "The dark variant of the Solarized colour theme")
    105 (solarized-with-color-variables
    106   'dark 'my-solarized-dark solarized-dark-color-palette-alist my-solarized-faces)
    107 
    108 (provide-theme 'my-solarized-dark)
    109 
    110 ```