Home /Modules/linux-editors/README.md

README.md

linux-editors/README.md · 124 line(s) · markdown

SLeeLa Linux Editor Themes

A coordinated collection of professional syntax palettes for Vim and Emacs on Linux. The original American Professional theme remains the default; four companion schemes are available as independent selections.

Themes

These are design interpretations inspired by broad cultural color references, not official national or cultural palettes.

Vim install

From the repository root:

mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/

Add one scheme to ~/.vimrc:

syntax enable
set background=dark
colorscheme sleela-american

Choose one of sleela-eurasia, sleela-russian-slavic, sleela-silk-road, or sleela-east-asian instead.

Emacs install

Copy lib/linux-editors/emacs/sleela-mode.el and the desired sleela-*-theme.el file into a directory on your Emacs load-path. Then load the mode and one theme:

(require 'sleela-mode)
(load-theme 'sleela-russian-slavic t)

Theme IDs: sleela-american, sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian. Theme files are independent; load only the theme you want.

More editors (Neovim, Helix, nano, VS Code)

The same palettes are available for four more editors, generated from one palette table so the colours stay identical across all of them. Each has its own install guide:

All seven palettes (american, eurasia, russian-slavic, silk-road, east-asian, greek, turkish) are provided for each editor. Regenerate every editor's files after a palette change with python3 lib/linux-editors/generate-editor-themes.py.

Ed / Sed are non-interactive line editors with no colour-scheme or syntax-highlighting concept, so there is nothing to theme for them; use them for scripted .sleela edits.

What is highlighted

Both the Vim syntax (vim/syntax/sleela.vim) and the Emacs mode (emacs/sleela-mode.el) recognise:

Markers, pragmas, and the brander inherit the active palette automatically (they map to groups/faces each bundled theme already defines), so no per-theme change is needed to colour them.

Native C/C++ palette utility

make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test

For backward compatibility, --palette and --hex COLOR without --theme continue to use American Professional.

Palette reference

SchemeBackgroundKeywordTypeStringComment
American Professional#101820#7FB3FF#73DACA#F2C078#8A96A3
Pan-Eurasian#111827#7AA7E8#69C9B3#D7B56D#8995A5
Russian and Slavic (medium)#202733#A9C0DD#8FC4B2#D6BD8B#9AA3AF
Central Asian / Silk Road#1C2529#7FADE0#45C6C2#D9B56D#92A3A0
East Asian#171A1C#D97878#72C7A5#D8B76A#969F9B

SLeeLa

<p align="center"><img src="images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>