This repository has been archived on 2022-11-18. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2019-05-07 19:19:08 +02:00
doom-modeline@0feb1c1499 Use a local doom-modeline checkout 2019-04-13 19:16:49 +02:00
emacswiki Remove FIXMEs from emacswiki code 2019-04-13 19:16:49 +02:00
emodule Absorb emodule and update README 2019-04-13 19:16:03 +02:00
ide-mode@1142d937b6 Add ide-mode as submodule 2019-04-14 12:38:41 +02:00
initial-buffer Create new splash screen 2019-04-13 19:16:03 +02:00
modules Add feature-mode and cask 2019-05-07 19:19:08 +02:00
snippets/org-mode Use snippets 2018-05-11 21:58:49 +01:00
themes Small fixes 2019-04-13 21:06:52 +02:00
.gitignore Add LSP mode and replace racer for rust 2019-04-13 19:16:34 +02:00
.gitmodules Add ide-mode as submodule 2019-04-14 12:38:41 +02:00
CHANGES.rst Update changelog 2019-04-13 19:16:03 +02:00
init.el Add ide-mode as submodule 2019-04-14 12:38:41 +02:00
LICENSE.txt Add a README, license, and a changelog 2017-09-03 15:36:29 +01:00
plantuml.jar Add plantuml and ansi-color in compilation-mode support 2018-01-29 13:23:58 +00:00
README.rst Small fixes 2019-04-13 21:06:52 +02:00
roadmap.org Use a local doom-modeline checkout 2019-04-13 19:16:49 +02:00

.emacs.d
========

My personal Emacs configuration.

Installation
------------

Just clone this repository into your home directory:

::

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

This configuration uses the `Source Code Pro`_ font.  If you do not have it
installed and it isn't available through your distribution you can install
the font by running

::

   git clone https://github.com/adobe-fonts/source-code-pro.git --branch release ~/.local/source-code-pro
   sudo cp ~/.local/source-code-pro/OTF/*.otf /usr/local/share/fonts

After cloning the repository and waiting for all packages to install on the
first startup you will also have to run the following command from within Emacs
in order to get all the icons used by the modeline

::

   M-x all-the-icons-install-fonts

External Support for Programming Languages
------------------------------------------

- Rust:

  Install RLS using ``rustup``

::
   rustup component add rls rust-analysis rust-src

- Python:

  The python configurations assumes ``python3`` and ``ipython3`` is installed

  Furthermore, install ``jedi``, ``autopep8``, ``flake8`` using ``pip3``

  Install the language server:

::
   pip3 install 'python-language-server[all]'

- C/C++:

  Uses ``ccls`` as the language server

::
   apt install clang libclang-dev
   git clone --depth=1 --recursive https://github.com/MaskRay/ccls
   cd ccls
   cmake -H. -BRelease
   cmake --build Release

  And make sure ``Release/ccls`` is in the ``$PATH``

Package Management
------------------

This ``.emacs.d`` uses its own small framework for package management located
in the ``emodule`` directory.  Its operation is heavily inspired by Spacemacs_,
but is much smaller with fewer features and thus simpler.

The purpose of using such a package manager is to ensure that all packages are
always installed before any configuration happens.  Furthermore, it will also
remove all unused packages and manage upgrades and backups.

Package configuration happens in the ``modules`` directory.  A file called
``MODULE.el`` corresponds to an individual ``MODULE``.  Inside each module
file, all the pre-requisite packages must be defined in a variable called
``emodule/MODULE-packages`` and all package configuration must be done in a
single function called ``emodule/MODULE-init``.  Each module must also be added
to the ``emodule/init`` call in the ``init.el`` file.

The ``emodule`` package manager runs during every startup. It will first ensure
all packages are installed before it runs any ``init`` functions so it is safe
to write configuration for packages that depends on other packages without any
concerns about ordering. This applies even if the configuration is spread
across multiple modules.

When Emacs is first launched with this configuration it will download all
the ``Elpa`` and ``Melpa`` packages that it needs so the first startup takes
much longer to complete.

Upgrades are supported and can be initiated either from the home screen or by
calling ``emodule/upgrade``.  I don't like tracking ``elpa`` with git as it
introduces a lot of code churn and makes analysing diffs, especially between
distant commits, very difficult. Instead, on each upgrade the ``elpa``
directory will be backed up to ``elpa.tar.xz``.  You can restore the last
backup by calling ``emodule/restore``. This repository should always contain a
functional backup of ``elpa``.

Theme
-----

The theme in use started with the ``underwater`` theme and has been heavily
modified, with inspiration from the Spacemacs_ theme, to add support for all
new faces introduced by the installed packages.  The code setting up the theme
is quite messy.  It is my plan to simplify it one day.

The theme files are located in ``themes``.

Stability
---------

I have been using this configuration at work and at home for many months now
which helped flush many bugs.  It has been pretty reliable, but suffers from
the occasional glitches which I think are more due to the limitations of
Emacs and the packages used than errors in my configuration.

.. _Spacemacs: http://spacemacs.org/
.. _`Source Code Pro`: https://github.com/adobe-fonts/source-code-pro