Emofacs is my own Emacs configuration.
"Emofacs" == "E" + "mofa" + "cs", which is a combination of "Emacs", the name of the famous editor, and "mofa", pinyin for the Chinese word for "magic". As a big fan of Emacs, I store my configuration in this repository both as a backup in case my local one is lost and for sharing. Anybody interested in my configuration may feel free to try it.
This is my Emacs version, but Emofacs should also work in some older versions.
Please make sure the unzip command has been installed before installing Emofacs.
A language server is only necessary when you want to code in a specific programming language. You may choose from the available servers listed in the web page above.
For the convenience to configure an empty Emacs as simple as possible, the straight package manager (straight.el) and use-package are used, and the only file you really need is init.el.
Simply put init.el into .emacs.d, the standard location for additional per-user Emacs-specific files, Emacs is going to configure itself automatically during the next startup. Or if you want, you may git clone this whole repository as your .emacs.d. In this way, you may update this configuration using git in the future. For more information about .emacs.d, please visit https://www.emacswiki.org/emacs/DotEmacsDotD.
The installation time depends on your Internet connection and CPU, because the packages need to be cloned and built. It takes about several minutes on my personal computer at home. During installation, Emacs may seem to be stuck, but it is not, so just wait patiently, but if the installation is not complete after 20 minutes, then there might be something wrong. In order to use some packages, Emacs may prompt you to install certain assets if none detected, type yes when prompted, or you may choose to disable some of the features.
Even if everything goes well, Emacs may still display some warnings and errors after initialization, and some of the features may not be loaded the first time Emacs starts up. Just ignore them and restart Emacs. Generally speaking, a maximum of two restarts is enough, meaning that when you open Emacs for the third time, it should work fine.
The learning curve of Emacs is steep, but once you get it, you may feel the power that Emacs brings you. With emacs, you may discover that a mouse is not that important. Most actions can be done using your keyboard without your hands moving away.
However, I am not going to teach you how to use Emacs or any of the specific packages mentioned above. Instead, I have listed their official websites or GitHub links so that you may easily find documents on each of them and begin exploring.
MIT License © Jiacheng Huang