/.emacs.d-2

Centaur Emacs - A Clean and Fast Emacs Configuration

Primary LanguageEmacs LispGNU General Public License v3.0GPL-3.0

Centaur Emacs

Build Status License

Centaur Emacs

This is an Emacs distribution that aims to enhance the default Emacs experience. It alters a lot of the default settings, bundles a plethora of additional packages and adds its own core library to the mix. The final product offers an easy to use Emacs configuration for Emacs newcomers and lots of additional power for Emacs power users.

It's able to run on Windows, GNU Linux and macOS. It is compatible ONLY with GNU Emacs 24.4 and above. In general you're advised to always run with the latest stable release - currently 25.3.

Features

  • Out of box.
  • Clean and Fast.
  • Quick fuzzy search (via ivy, rg, ag and pt etc.).
  • Better Org support.
  • Support multiple programming languages
    • C/C++/C#/Java
    • Ruby/Python/Perl/PHP/Shell/Powershell
    • Javascript/Typescript/JSON/YAML
    • HTML/CSS/XML
    • Golang/Swift
    • Markdown
    • ...
  • Auto completion.
  • Fly syntax check.
  • Fly spell check.
  • Git/SVN integration.
  • Projectile integration.
  • Workspace integration.
  • Pomodor integration.
  • Youdao dictionary integration.
  • Support Chinese fonts and calendar.
  • Support Pinyin search.

Prerequiste

OS

  • GNU Linux
  • macOS
  • Windows (Cygwin)

GNU Emacs

Please refer to Installing Emacs.

Dotfiles

Recommend to use Centaur Dotfiles.

Quick Start

Installation

Backup your .emacs.d if it exists,

mv ~/.emacs.d ~/.emacs.d.bak

then

git clone https://github.com/seagle0128/.emacs.d.git ~/.emacs.d

or download the zip package directly and extract to ~./emacs.d.

Then start emacs. Wait for a while to install packages at the first startup. Enjoy!

Update

Run M-x update-config in Emacs, or

cd ~/.emacs.d && git pull

Upgrade packages

M-x upgrade-packages

Customization

Copy custom-example.el to custom.el and change the configurations, then restart Emacs.

(setq my-logo nil)                        ; Logo file or nil (official logo)
(setq my-full-name "user name")           ; User full name
(setq my-mail-address "user@email.com")   ; Email address
(setq my-proxy "127.0.0.1:1080")          ; Network proxy
(setq my-package-archives 'emacs-china)   ; Package repo: melpa, emacs-china or tuna
(setq my-theme 'dark)                     ; Color theme: default, dark, light or daylight
(setq my-emoji-enabled t)                 ; Enable emoji: t or nil
(setq my-benchmark-enabled t)             ; Enable initialization benchmark: t or nil

;; You may add addtional configurations here
;; (custom-set-variables )

Screenshots

Main (default theme)

Main

Programming (dark theme)

Programming

Org mode (dark theme)

Org

Search (light theme)

Search

Magit (daylight theme)

Magit

FAQ

  1. Why is the modline messy?

    Powerline fonts are missing on your system. Please install powerline-fonts.

  2. How to search Chinese via pinyin?

    In Emacs, C-s !